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

# IDE での Q Developer の MCP 設定
<a name="mcp-ide"></a>

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

## IDE での Q Developer の MCP 設定ファイルについて
<a name="mcp-ide-configuration-understanding"></a>

GUI を使用して IDE の Q Developer に MCP サーバーを追加すると、設定は次の 2 つのファイルのいずれかに保存されます。
+ グローバルスコープ: \~/.aws/amazonq/default.json
+ ローカルスコープ: .amazonq/default.json

ただし、レガシーの理由から、他の 2 つの場所に MCP 設定情報を配置することもできます。
+ グローバルスコープ: \~/.aws/amazonq/mcp.json
+ ローカルスコープ: .amazonq/mcp.json

Q Developer は、MCP サーバーのワークスペースレベルの設定、そのアクセス許可、および保存されている設定を優先します。

**注記**  
mcp.json ファイルで MCP 設定をすでに設定していて、初めて MCP 設定 GUI を使用している場合は、その設定が GUI に表示されます。

レガシー mcp.json ファイルのサポートは、グローバル default.json 設定ファイルの useLegacyMcpJson フィールドによって有効になります。デフォルトでは、このフィールドは true に設定されます。詳細については、Q Developer CLI GitHub リポジトリの「[UseLegacyMcpJson フィールド](https://github.com/aws/amazon-q-developer-cli/blob/main/docs/agent-format.md#uselegacymcpjson-field)」を参照してください。

mcp.json ファイルは Q CLI でも使用できることに注意してください。

MCP ツールで詳細なコントロールを設定する方法については、[「組み込みツールリファレンス](https://github.com/aws/amazon-q-developer-cli/blob/main/docs/agent-format.md#tools-field)」を参照してください。

## MCP 設定 UI へのアクセス
<a name="mcp-ide-configuration-access-ui"></a>

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

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

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

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

1. ツールアイコンを選択します。![tools icon](http://docs.aws.amazon.com/ja_jp/amazonq/latest/qdeveloper-ug/images/tools-icon-full.png)

## MCP サーバーの追加
<a name="mcp-ide-configuration-add-mcp-server"></a>

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

### HTTP MCP サーバーの追加
<a name="mcp-ide-configuration-add-http-server"></a>

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

1.  [MCP 設定 UI にアクセスします](#mcp-ide-configuration-access-ui)。

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

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

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

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

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

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

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

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

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

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

1. 「[ツールのアクセス許可の確認と調整](#mcp-ide-configuration-review-adjust-tool)」の手順に従います。

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

### STDIO MCP サーバーの追加
<a name="mcp-ide-configuration-add-stdio-server"></a>

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

1.  [MCP 設定 UI にアクセスします](#mcp-ide-configuration-access-ui)。

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

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

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

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

   たとえば、[AWS Documentation MCP サーバー](https://awslabs.github.io/mcp/servers/aws-documentation-mcp-server/)をインストールする場合、名前は {{AWS DocMCPServer }}になります。

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

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

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

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

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

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

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

   この例では、最初に [名前] に {{FASTMCP\_LOG\_LEVEL}}、[値] に {{ERROR}} と入力します。

   また、{{AWS\_DOCUMENTATION\_PARTITION}} という名前と {{aws}} 値を使用して、作業する[パーティション](https://docs.aws.amazon.com/whitepapers/latest/aws-fault-isolation-boundaries/partitions.html)を示します。

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

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

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

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

1. 「[ツールのアクセス許可の確認と調整](#mcp-ide-configuration-review-adjust-tool)」の手順に従います。

## MCP 設定のトラブルシューティング
<a name="mcp-ide-configuration-troubleshooting"></a>

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

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

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

## MCP サーバーの有効化
<a name="mcp-ide-configuration-disable-server"></a>

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

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

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

1. 有効にするサーバーの横にある **[有効にする]** を選択します。

## MCP サーバーの無効化
<a name="mcp-ide-configuration-disable-server"></a>

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

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

1. 無効にするユーザーを選択します。

1. **[設定の編集]** の横にある 3 つのドットを選択します。

1. **[MCP サーバーを無効にする]** を選択します。

## 現在有効になっている MCP サーバーの削除
<a name="mcp-ide-configuration-delete-enabled-server"></a>

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

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

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

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

1. **[設定の編集]** の横にある 3 つのドットを選択します。

1. [**MCP サーバーを削除する**] を選択します。

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

## 現在無効になっている MCP サーバーの削除
<a name="mcp-ide-configuration-delete-disabled-server"></a>

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

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

1. 削除するサーバーの横にある **[削除]** を選択します。

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

## ツールのアクセス許可の確認と調整
<a name="mcp-ide-configuration-review-adjust-tool"></a>

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

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

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

1. ツールごとに、次のいずれかのアクセス許可レベルのいずれかを設定できます。
   + 要求: ツールを使用するたびにアクセス許可を求めます。
   + 常に許可: プロンプトを表示せずにツールを実行できるようにします。
   + 拒否: このツールを使用しません。