IDE での Q Developer の MCP 設定 - Amazon Q Developer
IDE を使用するMCP サーバーの追加MCP 設定のトラブルシューティングMCP サーバーの有効化MCP サーバーの無効化現在有効になっている MCP サーバーの削除現在無効になっている MCP サーバーの削除ツールのアクセス許可の確認と調整

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

IDE での Q Developer の MCP 設定

このページでは、MCP サーバーを設定するための IDE 固有のオプションについて説明します。MCP 設定の一般的な情報については、「MCP 設定について」を参照してください。

MCP 設定 UI へのアクセス

次の図は、IDE で Q Developer 用の MCP サーバーを設定するために使用される GUI を示しています。

MCP 設定の主な要素のフィールドを含む GUI。

IDE の Q Developer で MCP 設定 UI にアクセスするには：

  1. IDE (VS Code、JetBrains など) を開きます。

  2. Q Developer パネルを開きます。

  3. チャットパネルを開きます。

  4. ツールアイコンを選択します。 tools icon

MCP サーバーの追加

MCP サーバーを IDE に追加するには：

  1. MCP 設定 UI にアクセスします。

  2. プラス記号 (+) を選択します。

  3. グローバルまたはローカルのスコープを選択します。

    グローバルスコープを選択した場合、MCP サーバー設定は ~/.aws/amazonq/mcp.json に保存され、すべてのプロジェクトで使用できます。ローカルスコープを選択した場合、設定は現在のプロジェクト内の .amazonq/mcp.json に保存されます。

  4. Name フィールドに、MCP サーバーの名前を入力します。

    たとえば、AWS Documentation MCP サーバーをインストールする場合、名前は AWS DocMCPServer になります。

  5. トランスポートプロトコルを選択します。

    現在は、stdio のみがサポートされます。

  6. コマンドフィールドに、初期化時に MCP サーバーが実行するシェルコマンドを入力します。

    AWS ドキュメント MCP サーバーの場合、コマンドは ですuvx。これは のエイリアスでありuv tool run、エフェメラル Python 環境を作成します。

  7. Arguments フィールドに、必要に応じてシェルコマンドに渡す引数を入力します。

    AWS ドキュメント MCP サーバーの場合、引数は awslabs.aws-documentation-mcp-server@latest です。これは、PyPI (Python Package Index) でホストされているパッケージを指す Python パッケージ識別子です。

    必要に応じて引数を追加します。

  8. 必要に応じて環境変数を入力します。

    この例では、最初に名前: FASTMCP_LOG_LEVEL と値: ERROR を入力します。

    また、AWS_DOCUMENTATION_PARTITION という名前と aws 値を使用して、作業するパーティションを示します。

  9. 必要に応じてタイムアウト値を入力します。

    この例では、推奨値を 60 (秒) に維持します。

  10. [保存] を選択します。

    設定パネルはツールのアクセス許可パネルに置き換えられます。

  11. ツールのアクセス許可の確認と調整 「」の手順に従います。

MCP 設定のトラブルシューティング

IDE に MCP サーバーを追加すると、Amazon Q はそのサーバーへの接続を試みます。

接続に問題がある場合、パネルの上部にアラートが表示されます。アラートが解決されるまで、その MCP サーバーからのツールが正常に機能することは想定しないでください。

設定の修正を選択して MCP 設定画面に戻って、適切な変更を行うことができます。

MCP サーバーの有効化

次の手順では、問題の MCP サーバーがまだ有効になっていないことを前提としています。

IDE で MCP サーバーを有効にするには：

  1. MCP サーバーパネルを開きます。

  2. 有効にするサーバーの横にある、有効化 を選択します。

MCP サーバーの無効化

IDE で MCP サーバーを無効にするには：

  1. MCP サーバーパネルを開きます。

  2. 無効にするサーバーを選択します。

  3. セットアップの編集の横にある 3 つのドットを選択します。

  4. MCP サーバーを無効にするを選択します。

現在有効になっている MCP サーバーの削除

現在有効になっている MCP サーバーを IDE から削除するには：

  1. MCP サーバーパネルを開きます。

  2. 削除するサーバーを選択します。

    パネルが開き、そのサーバーの詳細が表示されます。

  3. セットアップの編集の横にある 3 つのドットを選択します。

  4. MCP サーバーの削除を選択します。

  5. プロンプトが表示されたら、削除を確認します。

現在無効になっている MCP サーバーの削除

現在無効になっている MCP サーバーを IDE から削除するには：

  1. MCP サーバーパネルを開きます。

  2. 削除するサーバーの横にある「削除」を選択します。

  3. プロンプトが表示されたら、削除を確認します。

ツールのアクセス許可の確認と調整

ツールのアクセス許可を確認して調整するには：

  1. MCP サーバーパネルを開きます。

  2. アクセス許可を確認して調整する MCP サーバーを選択します。

  3. ツールごとに、次のいずれかのアクセス許可レベルを設定できます。

    • 質問: ツールを使用するたびにアクセス許可を求めます。

    • 常に許可する: プロンプトを表示せずにツールを実行できるようにします。

    • 拒否: このツールを使用しないでください。

  4. 保存または適用を選択して、アクセス許可設定を更新します。