AI向けAmazon Devices Builder Toolsで開発を始める
AI活用開発に向けたAmazon Devices Builder Toolsには、Model Context Protocol（MCP）（英語のみ）サーバーとエージェントスキルが含まれています。これらのコンポーネントは、Amazonデバイス固有のメタデータ、ツール、ワークフローをAIコーディングエージェントに提供します。これによりエージェントは、プロジェクトのセットアップ、機能の統合、パフォーマンス分析、クラッシュのデバッグ、テストを行うときに、推奨パターンとベストプラクティスに従うようになります。
Amazon Devices Builder ToolsはVega OSを完全にサポートしますが、Fire OSのサポートは限定的です。OSごとの最新の機能については、Amazon Devices Builder Tools ReadMe（英語のみ）を参照してください。
Amazon Devices Builder Toolsの概要については、次のビデオを参照してください。
Amazon Devices Builder Toolsには以下が含まれています。
- MCPサーバー - 互換性のあるAIコーディングエージェントにAmazonデバイスのメタデータ、ツール、機能を提供する、スタンドアロンのnpmパッケージです。
- エージェントスキル - Fire TVの開発ワークフローにおいてエージェントをガイドする、軽量でモジュール型のマークダウンベースの命令セットです。
- ステアリングドキュメント - 基礎となるAmazonデバイスのベストプラクティスをAIアシスタントに教えるコンテキストファイルです。
Amazon Devices Builder Toolsでは、開発者の秘密情報が収集、送信、保存されることはありません。詳細については、プライバシーに関するよくある質問（FAQ）を参照してください。
Amazon Devices Builder Toolsはスタンドアロンのnpmパッケージであり、Vega SDKにはバンドルされていません。このページの手順に従って個別にインストールしてください。
エージェントスキル、MCPツール、MCPプロンプト、サポートされているワークフロー、サポートされているエージェント、および手動設定オプションの一覧については、Amazon Devices Builder Tools ReadMe（英語のみ）を参照してください。
@amazon-devices/amazon-devices-buildertools-mcp）は、以前はVega DevTools（@amazon-devices/vega-devtools-mcp）と呼ばれていました。以前のバージョンがインストールされている場合は、設定ファイルから@amazon-devices/vega-devtools-mcpを削除して、@amazon-devices/amazon-devices-buildertools-mcpを追加すると、最新のアップデートと機能を取得できるようになります。前提条件
- Node.js 18以降。MCPサーバーがSQLite3バインディングエラーによりNode v26で起動できない場合は、Node v24を使用します。AI向けAmazon Devices Builder Toolsのトラブルシューティングを参照してください。
- Vega SDK v0.22以降 - Vegaアプリ開発のワークフローにのみ必要。Fire OSのワークフローにVega SDKは必要ありません。
インストールとセットアップ
使用するAIエージェントに応じてAmazon Devices Builder Toolsを構成し、プロジェクトにAmazonデバイス固有のコンテキストを追加するには、ターミナル（BashまたはZSHシェル）で次のコマンドを実行します。
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context
このコマンドは、MCP、ステアリング、スキルをインストールし、使用するAIエージェント用に構成します。エージェントの選択、インストールディレクトリの選択、既存のコンテキストファイルの処理を求めるプロンプトが表示されます。それ以降に再びinit-contextを実行すると、アップデートがチェックされ、新機能が自動的にダウンロードされます。
コマンドが正常に完了すると、次のような出力が表示されます。
✅ MCP configuration updated
✅ Context document installed
✅ Setup complete for Kiro
対話モード（デフォルト）
対話モードで実行した場合は、次の手順が案内されます。
-
AIエージェントを選択します（Cursor、Kiro、その他/カスタムなど）。
ツールは選択内容を確認し、MCP設定プロンプトに移動します。
-
エージェントのMCP設定ファイルを自動更新するかどうかを、
y/nを入力して指定します。ツールは
✅ MCP configuration updatedを出力し、コンテキストドキュメントパスのプロンプトに移動します。 -
コンテキストドキュメントのインストールパスとして、デフォルトのパスを選択するか、カスタムパスを入力します。
ツールはパスを確認し、アクションプロンプトに移動します。
-
アクションとして、
merge（既存のファイルに新しいコンテンツを追加）、update（既存のファイルを上書き）、save（新しいファイルに書き込み）のいずれかを選択します。ツールはコンテキストドキュメントを作成し、上記の成功出力を表示します。
非対話モード
コマンドラインオプションを使用すると、プロンプトをスキップしてセットアッププロセスを自動化できます。
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context --agent <エージェント名> --force
指定できるオプションは次のとおりです。
| オプション | 説明 |
|---|---|
-a、--agent <タイプ> |
ターゲットのAIエージェントを指定します（cursor、cline、kiro、claude-code-cli、claude-code-desktop、github-copilot、amazon-q、other）。 |
-p、--context-document-path |
コンテキストドキュメントの保存先のパスを指定します。 |
-d、--skip-context-document |
コンテキストドキュメントのインストールをスキップします（MCPの構成のみ）。 |
-m、--skip-mcp-config |
MCPの構成をスキップします（コンテキストドキュメントのみ）。 |
-f、--force |
すべての確認プロンプトをスキップして強制的に上書きします。 |
-h、--help |
init-contextコマンドのヘルプを表示します。 |
エージェントのセットアップステータスの確認
MCPサーバーとコンテキストドキュメントをインストールしたら、check-statusコマンドを使用してセットアップを検証します。
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest check-status
特定のエージェントをチェックするには、次のコマンドを使用します。
npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest check-status --agent <エージェント名>
このコマンドにより、以下のチェックが行われます。
- コンテキストドキュメントのインストールステータスとバージョン
- MCPの構成ステータス
- レガシー構成の検出
出力の例：
Agent │ Context Document │ MCP Configuration
───────────────────────┼──────────────────────────┼──────────────────────────
Kiro │ ✅ v5.1 │ ✅ Configured
📊 Summary:
Total agents checked: 1
✅ Fully configured: 1
セットアップを確認
インストールが完了したら、まずcheck-statusを実行して、構成が正しいことを確認します（エージェントのセットアップステータスの確認を参照）。次に、エージェントからAmazon Devices Builder Toolsにアクセスできることを確認します。AIエージェントのチャットで、以下のように入力します。
List the tools provided by Amazon Devices Builder Tools and Agent Skills（Amazon Devices Builder Toolsとエージェントスキルに用意されているツールの一覧を表示してください）
エージェントは、使用可能なツールの一覧を応答として返します。これには、analyze_perfetto_traces、get_app_hot_functions、list_documents、read_asset、read_document、search_documentation、symbolicate_acrが含まれます。
次に、Amazonデバイス固有のプロンプトを試します。
Help me setup Vega SDK（Vega SDKのセットアップを手伝ってください）
エージェントが（汎用的なReact Nativeの手順ではなく）Amazonデバイス固有のセットアップ手順で応答すれば、構成は正しく機能しています。問題が発生した場合は、AI向けAmazon Devices Builder Toolsのトラブルシューティングを参照してください。
セットアップの検証後、「Build and run my app on Virtual Device」（アプリをビルドして仮想デバイスで実行してください）や「Help me debug Time to First Frame（TTFF）in my app」（アプリの最初のフレームまでの時間（TTFF）のデバッグを手伝ってください）などのプロンプトを試します。
プライバシーに関するよくある質問（FAQ）
Q1： Amazon Devices Builder Toolsが開発者のコードやクエリなどの機密データを収集したり、Amazonに送信したりすることはありますか？
A： いいえ。Amazon Devices Builder Toolsでは、以下を含む開発者の秘密情報が収集、送信、保存されることはありません。
- コードサンプルやアプリのソースコード。
- AIアシスタントへのクエリやプロンプト。
- プロジェクトのファイルや構成。
- その他の開発者データや知的財産。
ただし、AIエージェントが発行するドキュメント検索クエリはAmazonのサービスに送信され、リクエストに関連するドキュメントの検索に使用されます。
Amazon Devices Builder ToolsとAIアシスタント間のすべてのやり取りは、開発者のコンピューター上でローカルに行われます。コードとクエリは非公開に保たれ、選択したAIアシスタントの独自のプライバシーポリシーに従って、そのAIアシスタントによってのみ処理されます。唯一の例外はドキュメント検索クエリです。
Q2： AIアシスタントはどのようなデータにアクセスできますか？
A： AIアシスタントは、独自のプライバシーポリシーとサービス利用規約に従って、クエリとコードを処理します。アシスタントには、Amazon Devices Builder ToolsからツールとAmazonデバイス固有のコンテキストが提供されます。アシスタントでのデータの処理方法を管理するのは、アシスタントのプロバイダーです。データがどのように処理されるかについては、AIアシスタントのプライバシーポリシーを確認してください。
Q3： 開発者によるAmazon Devices Builder Toolsの使用に関するデータをAmazonが収集することはありますか？
A： Amazonは、Amazon Devices Builder Toolsを改善するために匿名のテレメトリデータを収集します。このテレメトリには、機能の使用パターン、エラー率、パフォーマンス指標が含まれます。テレメトリの収集は、設定で無効にすることができます。
重要なプライバシー保護：
- 機密データは収集の対象外： クエリ、コードサンプル、プロジェクトファイルなど、開発者が作成したコンテンツは一切Amazonに送信されません。
- ローカル処理： MCPは、完全に開発者のローカルコンピューター上で動作します。唯一の例外はドキュメント検索クエリです（Q1を参照）。
- 匿名データのみ： テレメトリデータには、個人を特定できる情報は含まれません。
そのほかにAmazonでは、Amazon Devices Builder Toolsの有用性を把握するために、オプションの開発者アンケートも実施しています。このアンケートへの参加は任意です。
トラブルシューティング
問題が発生した場合は、AI向けAmazon Devices Builder Toolsのトラブルシューティングのトラブルシューティングを参照してください。
関連トピック
- Amazon Devices Builder Tools ReadMe（英語のみ）
- アプリの作成
- Vega仮想デバイスまたはFire TVでのアプリの実行
- アプリのパフォーマンスに関するベストプラクティス
- クラッシュのデバッグ
Last updated: 2026年10月13日
