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

MCP 設定ファイルについて

設定ファイルの場所

Amazon Q Developer の MCP クライアント設定は、JSON 形式で という名前のファイルに保存されますmcp.json。このセクションでは、MCP 設定の仕組みと設定ファイルの構造について説明します。

Amazon Q Developer CLI は、2 つのレベルの MCP 設定をサポートしています。

どちらのファイルもオプションです。どちらも存在できません。両方のファイルが存在する場合、Amazon Q Developer は両方のファイルから MCP 設定を読み取り、それらを組み合わせて、その内容を統合します。競合がある場合 (グローバル設定で定義されたサーバーがワークスペース設定にも存在する場合）、警告が表示され、ワークスペース設定のサーバーエントリのみが使用されます。

設定ファイルの構造

MCP 設定ファイルは、次の構造を持つ JSON 形式を使用します。

{
  "mcpServers": {
    "server-name": {
      "command": "command-to-run",
      "args": ["arg1", "arg2"],
      "env": {
        "ENV_VAR1": "value1",
        "ENV_VAR2": "value2"
      },
      "timeout": 60000
    }
  }
}

各 MCP サーバーエントリは、サーバー名をキーとする オブジェクトです。名前は、各 MCP 設定ファイル内、およびグローバル設定ファイルとプロジェクト設定ファイル間で一意である必要があります。サーバー名は空にできず、250 文字以下にする必要があります。

各 MCP サーバーエントリオブジェクトには、「command」プロパティ (stdio トランスポートの場合) または「url」プロパティ (HTTP トランスポートの場合、今後のリリースでサポートされる) が必要です。

JSON ファイルに予期しない属性がある場合、警告が表示され、それらの属性は無視されます。

Stdio サーバー設定

エントリに「コマンド」プロパティが存在する場合、この MCP サーバーは stdio トランスポートを使用します。以下の属性がサポートされています。

stdio サーバー設定の例：

{
  "mcpServers": {
    "stdio-mcp-server": {
      "command": "mycommand",
      "args": [
        "arg1"
      ],
      "env": {
        "API_KEY": "value1"
      },
      "timeout": 60000
    }
  }
}

設定例

単一の MCP サーバーを使用する基本的な例：

{
  "mcpServers": {
    "markdown-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@example/markdown-mcp"
      ]
    }
  }
}

複数の MCP サーバーと環境変数の例：

{
  "mcpServers": {
    "git-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@example/git-mcp"
      ],
      "timeout": 30000
    },
    "api-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@example/api-mcp"
      ],
      "env": {
        "API_URL": "https://api.example.com",
        "API_KEY": "your-api-key"
      },
      "timeout": 120000
    }
  }
}

設定のベストプラクティス