AWS_MCP_PROXY_PROFILES で、AWS MCP のアカウントごとの面倒な設定を 1 つにまとめた

Claude Code + AWS MCP Server をマルチアカウントで使っていて、
気づいたら12 個 のブロックが.mcp.json に並んでいました

そんな中、2026/06/05に神アプデが来ていたので試してみました
概要としてはAWS_MCP_PROXY_PROFILES という環境変数にAWSアカウントを複数指定できるとのこと。

AWS_MCP_PROXY_PROFILES とは？

mcp-proxy-for-aws は、Claude Code などの MCP クライアントと、AWS がホストするリモートの AWS MCP Server との間のクライアント側プロキシです。

この mcp-proxy-for-aws に生えている、複数の AWS プロファイルを切り替えて使うための機能が AWS_MCP_PROXY_PROFILES です。

仕様をまとめると以下のような感じです。

項目	内容
対応バージョン	mcp-proxy-for-aws v1.6.0（2026-05-29 リリース）以降
指定方法	環境変数 AWS_MCP_PROXY_PROFILES にプロファイル名をスペース区切りで列挙
デフォルト	先頭に書いたプロファイルが aws_profile 省略時のデフォルトになる
優先順位	--profile オプションや AWS_PROFILE 環境変数より優先される
注入先ツール	call_aws / run_script / get_presigned_url / get_tasks の 4 つに aws_profile パラメータが注入される

前提

AWS_MCP_PROXY_PROFILES を使うための前提条件は、公式ドキュメントによると以下の通り

• 各プロファイルが ~/.aws/config や ~/.aws/credentials に存在していること
• mcp-proxy-for-aws が v1.6.0 以降であること
• 各プロファイルに最小権限が設定されていること
  • こちらは前提というよりも事故らないようなリスク回避的な意味合いですね
  • 筆者の場合は全て参照のみの権限しか持たないプロファイルを設定しています

実際にやってみる

before（統合前）

統合前は、.mcp.json の mcpServers の中に aws-mcp-server-service-a というような名前のブロックが 12 個 並んでいました。
それぞれのブロックの env に AWS_PROFILE を指定して、1 アカウントに固定する形です。

統合前イメージ

{
  "mcpServers": {
    "aws-mcp-server-service-a": {
      "command": "uvx",
      "args": [
        "mcp-proxy-for-aws@latest",
        "https://aws-mcp.us-east-1.api.aws/mcp",
        "--metadata",
        "AWS_REGION=ap-northeast-1"
      ],
      "env": {
        "AWS_PROFILE": "service-a-ro"
      }
    },
    "aws-mcp-server-service-b": {
      "command": "uvx",
      "args": [
        "mcp-proxy-for-aws@latest",
        "https://aws-mcp.us-east-1.api.aws/mcp",
        "--metadata",
        "AWS_REGION=ap-northeast-1"
      ],
      "env": {
        "AWS_PROFILE": "service-b-ro"
      }
    },
    "aws-mcp-server-service-c": {
      "command": "uvx",
      "args": [
        "mcp-proxy-for-aws@latest",
        "https://aws-mcp.us-east-1.api.aws/mcp",
        "--metadata",
        "AWS_REGION=ap-northeast-1"
      ],
      "env": {
        "AWS_PROFILE": "service-c-ro"
      }
    }
  }
}

after（統合後）

これを AWS_MCP_PROXY_PROFILES を使って 1 ブロックにまとめられました

統合後イメージ

{
  "mcpServers": {
    "aws-mcp-server": {
      "command": "uvx",
      "args": [
        "mcp-proxy-for-aws@latest",
        "https://aws-mcp.us-east-1.api.aws/mcp",
        "--metadata",
        "AWS_REGION=ap-northeast-1"
      ],
      "env": {
        "AWS_MCP_PROXY_PROFILES": "service-a-ro service-b-ro service-c-ro"
      }
    }
  }
}

最後に

AWSアカウントが増えても、
AWS_MCP_PROXY_PROFILES に追記するだけでMCPが使えるようになるのでとっても便利ですね！！