MCP 工具

Model Context Protocol (MCP) 是開放原始碼標準,可將 AI 應用程式連線至外部系統。 建立特定實體集和定義的結構,做為將各種資料來源和工具連結至 AI 模型的標準方式。

您可以使用 MCP 工具,將代理應用程式連線至現有 MCP 伺服器。

限制

限制如下:

  • CX Agent Studio 僅支援以 StreamableHttpTransport 為基礎的伺服器,不支援 SSE 傳輸伺服器。

建立或選取 MCP 伺服器

如要自行建構 MCP 伺服器,建議使用官方 MCP SDK,或其他可靠的第三方 SDK,例如 FastMCP。建立 MCP 伺服器後,請將其部署至代管服務。 您可以使用 Cloud RunCompute Engine 代管 MCP 伺服器。建議您參閱這份指南,瞭解整個程序: 在 10 分鐘內建構及部署遠端 MCP 伺服器,並在 Cloud Run 中執行。 Google Cloud

您也可以使用預先建構的 MCP 伺服器,例如 Google Cloud MCP 伺服器,不必從頭建構 MCP 伺服器。

驗證

MCP 工具與 OpenAPI 工具的驗證選項相同

獨立測試 MCP 伺服器

將代理程式連線至 MCP 伺服器前,建議先獨立測試 MCP 伺服器。使用 StreamableHttpTransport 建構的伺服器會以後置字元 (/mcp/mcp/) 結尾。舉例來說,如果伺服器託管於 https://example.com,則傳送要求至伺服器的正確網址為 https://example.com/mcp

如要在本機測試伺服器,建議使用 curl 或 Postman (原生支援 MCP 連線)。確保伺服器正常運作,並瞭解與伺服器通訊所需的驗證資訊。

建立 MCP 工具

如要從控制台建立 MCP 工具,請按照下列步驟操作:

  1. 按一下代理程式建構工具右側的工具圖示。
  2. 選取「MCP 工具」
  3. 提供工具名稱。
  4. 提供工具說明。
  5. 提供 MCP 伺服器的伺服器位址。
  6. 選取驗證類型。
  7. 點選「建立」

如果是 Cloud Run 上代管的伺服器,建議選用「服務代理人 ID 權杖」驗證選項。這個方法會使用 CX Agent Studio 服務帳戶 (格式為 service-{PROJECT_NUMBER}@gcp-sa-ces.iam.gserviceaccount.com) 將要求傳送至 Cloud Run 工作。將 Cloud Run 叫用者角色授予 CX Agent Studio 服務帳戶,讓該帳戶能使用自己的身分將要求傳送至伺服器。

將其他工具新增至代理程式前,建議先測試至少一個工具,確保驗證資訊設定正確無誤。