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

IDE での Q Developer の MCP 設定

このページでは、MCP サーバーを設定するための IDE 固有のオプションについて説明します。

MCP 設定 UI へのアクセス

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

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

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

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

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

MCP サーバーの追加

AI クライアントと MCP サーバー間の通信には、STDIO と HTTP の 2 つの主要なトランスポートメカニズムがあります。

HTTP MCP サーバーの追加

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

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

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

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

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

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

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

  6. URL フィールドに、初期化時に MCP サーバーが呼び出す URL を入力します。

  7. [ヘッダー - オプション] で、HTTP リクエストヘッダーとして送信する必要があるキーと値のペアを入力できます。

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

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

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

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

注記

MCP HTTP エンドポイントに認可が必要な場合、Amazon Q で自動的にブラウザページが開き、Amazon Q に MCP サーバーへのアクセスすることを許可することができます。

STDIO MCP サーバーの追加

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

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

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

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

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

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

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

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

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

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

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

    AWS Documentation 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. ツールごとに、次のいずれかのアクセス許可レベルのいずれかを設定できます。

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

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

    • 拒否: このツールを使用しません。