Interact with エージェントs Using an MCP Server

Beginning in Strategy One (February 2026), you can access Mosaic models in the MCP server as a preview feature. This allows you to ask questions in MCP directly against the unified semantic layer. For details, see Preview Feature: Access Mosaic Models in the MCP Server.

Preview features are early versions of features and are not to be used in a production environment as the core behavior remain subject to change between preview and GA. By selecting to expose preview features, you can access and use them as you would any other functionality. The official versions of preview features are included in subsequent releases.

Strategy One (2025年12月) 以降、ChatGPT のようなインターフェースで複数のクライアントからエージェントと対話できます。Strategy Library の MCP サーバーは、MCP クライアントアプリケーションがエージェントを直接検出、対話、およびクエリできるツールを公開します。MCP クライアントは、使用可能なエージェントをリスト表示し、その詳細を表示し、リモート呼び出しを介して特定のエージェントに質問を送信できます。MCP サーバーは、複数のクライアントからエージェントとのリアルタイムのクロスシステム対話を可能にし、プラットフォーム間での使いやすさ、拡張性、統合を向上させます。これにより、外部ツールがエージェントをプログラムで活用できるようになり、運用の摩擦が減少して自動化が向上します。

You can interact with エージェントs using the following MCP clients:

• Claude PRO

• VSCode Copilot

Beginning in Strategy One (January 2026), you can also use these MCP clients:

• AWS/Amazon Quick Suite

• ChatGPT

• Copilot Studio

• Gemini

If you are working with a container-based environment, MCP サーバーを有効にする before connecting MCP clients to it for interaction with エージェントs.

Use Cases

• List all エージェントs connected to the MCP server, so that you know what you are working with. The MCP server returns エージェント names, IDs, and descriptions.

• Ask a question. The MCP client determines the target エージェント, invokes it, and retrieves the answer.

Prerequisites

You must have the privileges outlined below.

エージェントs must be certified to be used in the MCP server. This allows you to determine which エージェントs are available. For example, if you want to test only production エージェントs, you can certify only those.

Use a MCP Server Connection in Claude

Connect to the MCP Server

1. Log into Claude PRO version.

2. In the toolbar in the chat box, click the Search and Tools icon and select Manage Connectors.

   

3. Click Browse Connectors.

   

4. In the introductory paragraph, click the link for add a custom one.

   

5. In the Add Custom Connector window, type a Name for the connector.

6. Type your Remote MCP Server URL using the following syntax:

   https://env-domain/collaboration/mcp/agent

   Replace domain with your MCP server.

   • Beginning in Strategy One (February 2026), you can access Mosaic models in the MCP server as a preview feature. Use this syntax instead: https://env-domain/collaboration/mcp/mosaic.

7. Click Add.

8. If the same window opens again, click Cancel.

9. Check that your new connector displays in the list of connectors.

   

10. Click Connect next to your new connector.

11. Strategy Library opens. Log in with your credentials.

12. At the message, click Open Claude.

    

    Your new connector now displays Configure instead of Connect.

    

13. Click the New Chat icon in the sidebar.

14. In the toolbar in the chat box, click the Search and Tools icon . Your new connector is now listed and ready for use.

    

Use Claude to Interact with エージェントs

1. In the Claude chat box, you can ask to list your エージェントs.

   

2. You can ask Claude to provide details about a specific エージェント.

   

3. Ask a question to your エージェントs.

   

Use a MCP Server Connection in Copilot

Connect Using Copilot

1. Open Copilot.

2. Open a new window using Ctrl+Shift+P.

3. Look up MCP: Add Server.

4. Choose HTTP (HTTP or Server-Sent Events).

5. Paste your MCP server URL using the following syntax:

   https://env-domain/collaboration/mcp/agent

   Replace domain with your MCP server.

   • Beginning in Strategy One (February 2026), you can access Mosaic models in the MCP server as a preview feature. Use this syntax instead: https://env-domain/collaboration/mcp/mosaic.

6. Type a Name for the server.

7. Select Global.

8. Click Allow authentication.

   

9. Click Open the external website.

   

10. Strategy Library opens. Log in with your credentials.

11. In the window, click Open Visual Studio Code.

    

12. Ensure your mcp.json file looks like the image below, with your own URL. Click Start above the mcp line.

    

13. Click Allow to connect.

    

14. Ensure that the MCP connection is running, by checking the mcp.json file for the Running status.

    

Use Copilot to Interact with エージェントs

1. Open a chat window by clicking the Chat icon at the top of the screen.

2. In the chat window, ask Copilot to list your エージェントs. Click Allow to retrieve the response. This is also a good way to ensure that the MCP server is connected.

   

3. Ensure that the chat box is set to Agent as shown below.

   

4. You can ask Copilot to provide details about a specific エージェント or ask a question to your エージェントs.

Gemini Enterprise で MCP サーバー接続を使用

Strategy One (2026年2月) 以降、プレビュー機能として MCP サーバーで Mosaic モデルにアクセスできます。

Gemini Enterprise を使用した接続

1. GitHub リポジトリをチェックアウトします。

2. Python 仮想環境を作成します。

3. pyproject.toml からすべての依存関係をインストールします。

4. agent.py と deploy.py の両方で mcp_url と AUTH_ID が一致していることを確認します。

5. 次のコマンドを実行して、ADK エージェントを Vertex AI Agent Engine にデプロイします:

   python deploy.py

6. デプロイが成功したら、エージェント エンジンで実行中のエージェントを確認できます:

   

7. Gemini Enterprise Authorization サーバーに新しいリソースを追加し、ADK エージェントを Gemini Enterprise に登録します。次の手順に従ってください:

   1. Gemini Enterprise を検索します。

   2. agents に移動します。

   3. Add Agent をクリックします。

   4. Custom Agent Via Agent Engine を選択します。

   

8. 新しい認証を追加し、Authorization ID が deploy.py スクリプトでデプロイされた AUTH_ID と一致することを確認します。

   

9. Next をクリックします。

10. エージェントの構成を追加します。次の手順に従ってください:

    1. 上記と同じ Authorization ID を使用します。

    2. Agent Engine Reasoning ボックスに ADK エンジンのリソース名を入力します。リソース名は Agent Engine ポータルで確認できます。

    3. Create をクリックします。

    

Gemini Enterprise を使用してエージェントと対話

1. Gemini Enterprise インターフェースを開きます。

2. Agents を選択し、エージェントを選択します。

   

3. Gemini でエージェントと対話して、特定のエージェントの詳細を提供したり、エージェントに質問したりできます。

ChatGPT で MCP サーバー接続を使用

ChatGPT を使用した接続

1. ChatGPT を開きます。

2. 左下で、名前をクリックします。

3. Settings をクリックします。

   

4. Apps & Connectors をクリックします。

5. Create App をクリックします。

   

6. アプリを作成するための情報を入力します。

   1. Icon 画像ファイルを追加します (オプション)。

   2. Name、オプションの Description、および MCP Server URL を入力します。URL には https://env-domain/collaboration/mcp/agent の形式を使用し、domain を MCP サーバーに置き換えます。

      • Strategy One (2026年2月) 以降、プレビュー機能として MCP サーバーで Mosaic モデルにアクセスできます。代わりに次の構文を使用してください: https://env-domain/collaboration/mcp/mosaic。

   3. Authentication ドロップダウンリストから OAuth を選択します。

   4. Authorization ID を入力します。

   5. I understand and want to continue の横のチェックボックスをオンにします。

   

7. Create をクリックします。

これで ChatGPT でエージェントと対話できます。

Copilot Studio で MCP サーバー接続を使用

Copilot Studio を使用した接続

1. Copilot Studio を開きます。

2. 左側のツールバーで Agents をクリックします。

   

3. ツールバーの Create Blank Agent をクリックして新しいエージェントを作成するか、既存のエージェントをクリックします。

   

4. Tools セクションまでスクロールし、Add Tool をクリックします。

   

5. 右側の候補の下にある New Tool をクリックします。

   

6. Model Context Protocol をクリックします。

   

7. Server Name、Server Description、および完全なサーバーパスを含む Server URL を入力します。URL には次の構文を使用します:

   https://env-domain/collaboration/mcp/agent

   domain を MCP サーバーに置き換えます。

   • Strategy One (2026年2月) 以降、プレビュー機能として MCP サーバーで Mosaic モデルにアクセスできます。代わりに次の構文を使用してください: https://env-domain/collaboration/mcp/mosaic。

8. Authentication には、OAuth 2.0 を選択します。

   

9. Type には、Manual を選択します。

10. Client ID、Client Secret、Authorization URL、Token URL Template、Refresh URL、および Scopes を入力します。

    

11. Create をクリックします。

12. Preview ウィンドウに表示される Redirect URL をコピーします。MCP 所有者に提供して、MCP 構成に redirect_url を追加してもらいます。

    

    • MCP 所有者は、Workstation の環境のプロパティで追加します。Library ページの Model Context Protocol for エージェント セクションにあります:

      

13. Next をクリックします。

14. 接続を確立するには、Not Connected をクリックします。

    

15. サインインして接続したら、Create をクリックします。

    

16. 新しいブラウザウィンドウが表示されます。Strategy Library が開きます。資格情報でログインします。

これで Copilot Studio を使用してエージェントと対話できます。

AWS/Amazon Quick Suite で MCP サーバー接続を使用

MCP サーバーへの接続

1. AWS アクセスポータルにログインします。

2. AdministratorAccess をクリックします。

   

3. Amazon Quick Suite を検索して選択します。

   

4. 左側のナビゲーションバーで Integrations をクリックします。

   

5. Actions タブをクリックします。Model Context Protocol ボックスの Add (プラス記号) をクリックします。

   

6. Name と Description を入力します。

7. MCP Server Endpoint ボックスに、次の構文を使用して MCP サーバー URL をコピーして貼り付けます:

   https://env-domain/collaboration/mcp/agent

   domain を MCP サーバーに置き換えます。

   • Strategy One (2026年2月) 以降、プレビュー機能として MCP サーバーで Mosaic モデルにアクセスできます。代わりに次の構文を使用してください: https://env-domain/collaboration/mcp/mosaic。

   

8. Next をクリックします。

9. 認証方法として User Authentication をクリックします。

10. Client ID、Client Secret、Token URL、および Authorization URL を入力します。

    

11. Create and Continue をクリックします。

12. 資格情報で Strategy Library にログインします。

13. 有効なアクションのリストを確認します。Next をクリックします。

    

14. Share Integration ページが表示されたら、Done をクリックします。

    

    テストの開始

15. 左側のナビゲーションパネルで Chat Agents をクリックします。

16. Create Chat Agent をクリックします。

    

17. エージェントのペルソナを指定する場合は、説明してから Generate をクリックします。指定しない場合は、Skip をクリックします。

    

18. ウィンドウの上部にあるボックスに名前を入力します。

19. ウィンドウの下部にある Actions セクションで、Link Actions をクリックします。

    

20. MCP Agent を選択し、Link をクリックします。

    

21. ウィンドウの上部で Launch Chat Agent をクリックします。

    

22. Successfully Launched Chat Agent メッセージが表示されたら、AWS を使用してエージェントと対話できます。

    

Preview Feature: Access Mosaic Models in the MCP Server

Beginning in Strategy One (February 2026), you can access Mosaic models in the MCP server as a preview feature. This allows you to ask questions in MCP directly against the unified semantic layer, without needing to go through an エージェント. It also results in better performance because the interaction time with AI is saved.

You can use the following MCP clients to access Mosaic models:

• Claude PRO

• VSCode Copilot

• AWS/Amazon Quick Suite

• ChatGPT

• Copilot Studio

• Gemini

When you connect to the MCP Server, use the following syntax for the MCP server URL endpoint:

https://env-domain/collaboration/mcp/mosaic

Replace domain with your MCP server.

You can use the following workflows with Mosaic models:

• List the tables of the model

• List the schemas of the model

• Get semantics for a table, which returns the model's column descriptions

• Ask normal エージェント questions to a table, such as create a graph with the data or provide a summary

• Send SQL to a table

Enable Preview Feature: MCP Access for Mosaic Models

In the Collaboration Service's config.json file, set uslEnabled to true.

"mcpConfig": {
  "enabled": true,
  "uslEnabled": true,
  ...
}