レジストリ MCP エンドポイントの使用

概要

各レジストリは、2025-11-25 仕様 に従って MCP 互換エンドポイントを公開します。エンドポイントは、レジストリレコードを検索するためのツールリストとツール呼び出しをサポートしています。

https://bedrock-agentcore.<region>.amazonaws.com/registry/<registryId>/mcp

MCP には、「search_registry_records」という名前のツールが 1 つ含まれています。

Tool name: search_registry_records

Description:
Searches for registry records using natural language queries. Returns metadata for matching records.

Parameters:
- searchQuery (required): string - Natural language search query
- maxResults: integer - Maximum number of results to return (1-20, default 10)
- filter: object - Optional metadata filter using structured JSON operators. Supports field-level operators ($eq, $ne,
  $in) and logical operators ($and, $or) on filterable fields (name, descriptorType, version). Example:
  {"descriptorType": {"$eq": "MCP"}}

Kiro、Claude などの既存の MCP クライアントからレジストリに接続できます。

既存の MCP クライアントから OAuth ベースのレジストリ MCP エンドポイントに接続する

アクセス許可

MCP エンドポイントは、同じ CustomJWTAuthorizerConfiguration を使用して受信リクエストを承認します。

.well-known/oauth-protected-resource パスは ですhttps://bedrock-agentcore.<region>.amazonaws.com/.well-known/oauth-protected-resource/registry/<registryId>/mcp。

クライアントはWWW-Authenticateヘッダーからメタデータを検出することもできます。

www-authenticate: Bearer resource_metadata="https://bedrock-agentcore.<region>.amazonaws.com/.well-known/oauth-protected-resource/registry/<registryId>/mcp"

アクセストークンを取得したら、検証できます。

curl -s -X POST "https://bedrock-agentcore.<region>.amazonaws.com/registry/<registryId>/mcp" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_registry_records","arguments":{"searchQuery":"weather"}}}'

認可サーバーと組織のセキュリティ要件に応じて、次のいずれかのアプローチを選択して MCP クライアントを設定できます。

OAuth ベースの MCP クライアント設定

ベアラートークンを使用する

ほとんどの IDEs では、mcp 設定で認可ヘッダーベアラートークンを設定できます。たとえば、Kiro は 構文を使用して環境変数をサポートしています。 ${ENV_VAR}次の例を使用できます。

{
  "mcpServers": {
    "my-registry": {
      "type": "http",
      "url": "https://bedrock-agentcore.<region>.amazonaws.com/registry/<registryId>/mcp",
      "headers": {
        "Authorization": "Bearer ${ACCESS_TOKEN}"
      }
    }
  }
}

事前登録済みクライアント

認可サーバーで認可コードの付与に基づいて新しいクライアントを作成し、そのクライアントを使用してレジストリにアクセスできます。たとえば、Cognito ユーザープールにクライアントを作成します。

クライアント ID を取得したら、レジストリで許可リストに登録してください。

aws bedrock-agentcore-control update-registry \
  --registry-id <registryId> \
  --authorizer-configuration '{
    "optionalValue": {
      "customJWTAuthorizer": {
        "discoveryUrl": "https://<example-domain>/.well-known/openid-configuration",
        "allowedClients": ["<client-id>"]
      }
    }
  }'

その後、clientId の指定をサポートしている場合は、MCP クライアントを設定できます。Claude コードの例:

{
  "mcpServers": {
    "pre-registered-registry": {
      "type": "http",
      "url": "https://bedrock-agentcore.<region>.amazonaws.com/registry/<registryId>/mcp",
      "oauth": {
        "clientId": "<client-id>",
        "callbackPort": "<port-number>"
      }
    }
  }
}

動的クライアント登録

ほとんどの MCP クライアントアプリケーションは、動的クライアント登録をサポートしています。この場合、レジストリにallowedClients値を指定しないでください。代わりに、 allowedAudience を設定することもできます。値は MCP レジストリと同じにすることができます。と同じ値を持つ audフィールドで JWT を発行するように認可サーバーを設定する必要がありますallowedAudience。

aws bedrock-agentcore-control update-registry \
  --registry-id <registryId> \
  --authorizer-configuration '{
    "optionalValue": {
      "customJWTAuthorizer": {
        "discoveryUrl": "https://<example-domain>/.well-known/openid-configuration",
        "allowedAudience": ["https://bedrock-agentcore.<region>.amazonaws.com/registry/<registryId>/mcp"]
      }
    }
  }'

その後、URL を使用して MCP クライアントを設定できます。

{
  "mcpServers": {
    "dcr-registry": {
      "type": "http",
      "url": "https://bedrock-agentcore.<region>.amazonaws.com/registry/<registryId>/mcp"
    }
  }
}

動的クライアント登録をセットアップする際の一般的なエラー:

既存の MCP クライアントから IAM ベースのレジストリ MCP エンドポイントに接続する

アクセス許可

MCP の初期化とツールのリスト:

{
    "Effect": "Allow",
    "Action": "bedrock-agentcore:InvokeRegistryMcp",
    "Resource": "arn:aws:bedrock-agentcore:*:<account>:registry/*"
}

MCP ツール呼び出しで検索するには、以下も必要です。

{
    "Effect": "Allow",
    "Action":
    [
        "bedrock-agentcore:InvokeRegistryMcp",
        "bedrock-agentcore:SearchRegistryRecords"
    ],
    "Resource": "arn:aws:bedrock-agentcore:*:<account>:registry/*"
}

コマンドを使用してアクセス許可を確認できます。

curl -s -X POST "https://bedrock-agentcore.<region>.amazonaws.com/registry/<registryId>/mcp" \
  -H "Content-Type: application/json" \
  -H "X-Amz-Security-Token: ${AWS_SESSION_TOKEN}" \
  --aws-sigv4 "aws:amz:<region>:bedrock-agentcore" \
  --user "${AWS_ACCESS_KEY_ID}:${AWS_SECRET_ACCESS_KEY}" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_registry_records","arguments":{"searchQuery":"weather"}}}'

IAM ベースの MCP クライアント設定

mcp-proxy-for-aws を使用して、IAM ベースのレジストリに接続できます。たとえば、Kiro mcp.json の場合:

{
  "mcpServers": {
    "iam-based-registry": {
      "disabled": false,
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-proxy-for-aws@latest",
        "https://bedrock-agentcore.<region>.amazonaws.com/registry/<registryId>/mcp",
        "--service",
        "bedrock-agentcore",
        "--region",
        "<region>",
        "--profile",
        "my-profile"
      ]
    }
  }
}

独自の MCP クライアントを開発する

Kiro や Claude Code などの一般的な IDEs からのレジストリ MCP エンドポイントの呼び出し方法に関するその他のコードリファレンスについては、パブリックコードリポジトリのサンプルコードリファレンスを参照してください。