エージェントから MCP サーバーへ

RuntimeAccessPolicy を使用して、MCP サーバーのツールを呼び出せる AgentCore のエージェントデプロイを制御します。

始める前に

マネージドゲートウェイと gatewayRef を含めて、AgentCore ランタイムをセットアップします。続行する前に、特に次の 2 点が満たされていることを確認します。

ゲートウェイが phase=ready になっている:
```
arctl get gateways
```
Runtime に spec.config.gatewayRef が設定されている。このフィールドがないと、レジストリはエージェントのトラフィックをゲートウェイ経由でルーティングせず、RuntimeAccessPolicy は適用されません:
```
arctl get runtime agentcore -o yaml | grep gatewayRef
```
このフィールドがない場合は、ランタイムセットアップガイドのステップ 3.4に従って追加します。

Note

エージェントから MCP へのトラフィックがマネージドゲートウェイ経由でルーティングされるのは、デプロイ時だけです。ゲートウェイが準備完了になる前、または gatewayRef が設定される前にエージェントをデプロイした場合は、適用を有効にするために再デプロイしてください:

arctl apply -f your-agent.yaml

ハーネスエージェントのツールアクセスを制限する

デフォルトでは、ハーネスエージェントはカタログの MCP サーバー上のすべてのツールを呼び出せます。エージェントがランタイムで呼び出せるツールを制限するには、RuntimeAccessPolicy リソースを作成します。このポリシーは、AgentCore ランタイムに設定したマネージドゲートウェイによって適用されます。

ハーネスエージェントをデプロイします。このハーネスエージェントには Solo.io ドキュメントの MCP サーバーがバンドルされています。以降の手順では、その MCP サーバーの search ツールだけにアクセスを制限します。

ハーネスエージェントが特定の MCP サーバーツールにアクセスできるようにする RuntimeAccessPolicy を作成します。次の例では、hello-agent デプロイが solo-docs MCP サーバーの search ツールにアクセスできるようにします。solo-docs サーバーには search、get_chunks、get_full_page の 3 つのツールがあります。get_chunks と get_full_page は記載していないため、これらのツールへのアクセスは拒否されます。

arctl apply -f- <<EOF
apiVersion: ar.dev/v1alpha1
kind: RuntimeAccessPolicy
metadata:
  name: hello-agent-solo-docs-search
spec:
  runtimeRef:
    name: agentcore
  rules:
    - from:
        - kind: Deployment
          name: hello-agent
      to:
        - kind: MCPServer
          name: solo-docs
          mcpTools:
            - search
EOF

出力例:

✓ RuntimeAccessPolicy/hello-agent-solo-docs-search created

フィールド	説明
`spec.runtimeRef.name`	必須。このポリシーの適用先 Runtime の名前です。リソースの作成後に Runtime 参照を変更することはできません。参照を更新するには、Runtime リソースを削除して再作成する必要があります。
`spec.rules[].from[].kind`	呼び出し元のエージェントデプロイを指定するには `Deployment` に設定します。
`spec.rules[].from[].name`	このルールがアウトバウンドアクセスを許可するエージェントデプロイの名前。
`spec.rules[].to[].kind`	ターゲットの種類。カタログの MCP サーバーには `MCPServer` を使用します。
`spec.rules[].to[].name`	ターゲットの MCP サーバーの名前。すべてのサーバーに一致させるには `"*"` を使用します。
`spec.rules[].to[].mcpTools`	任意。エージェントが呼び出せるツール名のリスト。省略すると、ターゲットサーバー上のすべてのツールが許可されます。

UI で Instances ビューを開き、エージェントを選択します。
Agent Details カードで Open Chat をクリックします。
エージェントとチャットし、どの MCP ツールにアクセスできるか尋ねます。Enter を押してエージェントの応答を待ちます。ポリシーで明示的に許可したツールだけがエージェントから一覧表示されることを確認します。