For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.

リモート MCP サーバーを Solo Enterprise for agentregistry カタログに登録し、デプロイ済みエージェントに接続することで、エージェントがサーバーのツールを呼び出せるようにします。

デプロイ済みのエージェントをリモート MCP サーバーに接続することで、機能を拡張できます。リモート MCP サーバーとは、公開 URL ですでに稼働している MCP ツールサーバーであり、Solo Enterprise for agentregistry でビルドまたはデプロイする必要はありません。サーバーをカタログに登録してエージェントの定義で参照すると、Solo Enterprise for agentregistry が実行時にサーバーのツールをエージェントから利用できるように自動的に設定します。

始める前に

• はじめにガイドのいずれかに従って、Solo Enterprise for agentregistry をインストールし、希望するランタイムに接続し、最初のエージェントをデプロイします。
• パスを含むリモート MCP サーバーの URL を取得します。たとえば、MCP URL は次のようになります: https://my-mcp-server.example.com/mcp。

ステップ 1: リモート MCP サーバーを登録する

1. リモート MCP サーバーのレジストリカタログエントリを作成します。このガイドの例では、Solo.io が提供する MCP テストサーバー https://test-mcp.are.soloio.dev/mcp を使用します。このサーバーは echo ツールと add ツールの 2 つのツールを公開しています。

   arctl apply -f - <<EOF
   apiVersion: ar.dev/v1alpha1
   kind: MCPServer
   metadata:
     name: remotemcp
   spec:
     description: Remote MCP server
     remote:
       type: streamable-http
       url: https://test-mcp.are.soloio.dev/mcp
   EOF

   フィールド	説明
   metadata.name	サーバーのカタログ名。
   spec.remote.type	トランスポートタイプ。HTTP ベースの MCP サーバーには streamable-http を使用します。
   spec.remote.url	パスを含むリモート MCP サーバーの完全な URL (例: /mcp)。

   出力例:

   ✓ MCPServer/myorg/remotemcp created
   

2. リモート MCP サーバーがカタログに登録されていることを確認します。

   arctl get mcp

   出力例:

   NAME                 TAG      DESCRIPTION
   myorg/remotemcp      latest   Remote MCP server
   mymcp                latest   Sample MCP server
   

ステップ 2: MCP サーバーをエージェントに追加する

1. エージェントの agent.yaml を更新して、mcpServers リストでリモート MCP サーバーを参照します。複数の MCP サーバーを参照できます。

   cat > myagent/agent.yaml <<EOF
   apiVersion: ar.dev/v1alpha1
   kind: Agent
   metadata:
     name: myagent
   spec:
     source:
       image: localhost:5001/myagent:latest
       repository:
         url: https://github.com/solo-io/doc-examples
         subfolder: agentregistry/myagent
     modelProvider: bedrock
     modelName: us.anthropic.claude-sonnet-4-6
     description: myagent agent
     mcpServers:
       - kind: MCPServer
         name: remotemcp
   EOF

2. 更新したエージェントをレジストリに再公開します。

   arctl apply -f myagent/agent.yaml

   出力例:

   ✓ Agent/myagent (latest) updated
   

ステップ 3: エージェントをデプロイする

エージェントをランタイムにデプロイまたは再デプロイする手順に従います。