MCP 連接器

您可以使用 Model Context Protocol (MCP) 連接器，在 Integration Connectors 中建立及設定 MCP 連線。您可以在商用應用程式中使用這項連線，與 MCP 安全地交換資料及執行作業。

如需支援的實體和作業清單，請參閱「實體作業範例」。如要瞭解支援的連接器專屬動作，請參閱「動作」。

MCP 連接器版本

MCP 連接器支援兩個版本：

MCP v1：使用這個連結器版本存取 MCP v1 API。
MCP v2：使用這個連結器版本存取 MCP v2 API。

如要瞭解如何建立 MCP 連線，請參閱「建立及設定 MCP 連接器」。

實體、作業和動作

所有整合連接器都會為所連應用程式的物件提供抽象層。您只能透過這個抽象化存取應用程式的物件。抽象化會以實體、作業和動作的形式向您公開。

實體： 實體可以視為已連結應用程式或服務中的物件，或是屬性集合。實體的定義會因連接器而異。舉例來說，在資料庫連接器中，資料表是實體；在檔案伺服器連接器中，資料夾是實體；在訊息系統連接器中，佇列是實體。
不過，連接器可能不支援或沒有任何實體，在這種情況下，Entities 清單會是空白。
作業： 作業是指您可以在實體上執行的活動。您可以對實體執行下列任一操作：
- 列出
- 取得
- 建立
- 更新
- 刪除
從可用清單中選取實體，系統會產生該實體可用的作業清單。如需作業的詳細說明，請參閱 Connectors 工作的實體作業。不過，如果連接器不支援任何實體作業，Operations 清單就不會列出這類不支援的作業。
動作： 動作是透過連接器介面提供給整合的第一類函式。動作可讓您變更一或多個實體，且因連接器而異。一般來說，動作會有一些輸入參數和輸出參數。不過，連接器可能不支援任何動作，此時 Actions 清單會是空白。

支援的實體和作業

MCP 連接器支援實體和作業，可用的具體項目取決於透過 MCP 連接的工具。

實體作業範例

本節提供不同工具的實體作業範例。

列出 Jira 問題實體

這個範例會使用 Jira MCP 連線，列出「問題」實體中的所有「問題」。

在「設定連接器工作」視窗中，按一下「實體」。
從「Entity」清單中選取「Issues」。
選取「List」作業，然後按一下「Done」。

在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下「connectorInputPayload」，然後在「Default Value」(預設值) 欄位中輸入類似下列的值：

{
      "operation": "LIST_ENTITIES",
      "connection_name": "projects/YOUR_PROJECT_ID/locations/YOUR_LOCATION/connections/YOUR_JIRA_CONNECTION_NAME",
      "service_name": "projects/YOUR_TENANT_PROJECT_ID/locations/YOUR_LOCATION/namespaces/cloudrun/services/YOUR_RUNTIME_SERVICE",
      "host": "https://YOUR_TENANT_PROJECT_ID-YOUR_LOCATION.us-west1-runtime-connectors-google.com",
      "entity": "Issues",
      "entity_id": "Issues",
      "page_token": ""
    }

列出所有要求

這個範例會列出「Requests」實體中的所有「Requests」。

在「設定連接器工作」視窗中，按一下「實體」。
從「實體」清單中選取「要求」。
選取「List」作業，然後按一下「Done」。

依 ID 取得使用者

這個範例會從 Users 實體取得 AccountId 為 `6035864ce2020c0070b5285b` 的使用者。`AccountId` 是「Users」實體的主鍵。如要取得特定實體，請使用 List 作業和主鍵上的 filterClause，因為系統不支援對這個實體執行 Get 作業。

在「設定連接器工作」視窗中，按一下「實體」。
從「Entity」(實體) 清單中選取「Users」(使用者)。
選取「List」作業，然後按一下「Done」。
在「Connectors」(連結器) 工作的「Task Input」(工作輸入) 區段中，按一下「filterClause」(篩選子句)，然後在「Default Value」(預設值) 欄位中輸入 `AccountId`=6035864ce2020c0070b5285b。

動作

MCP 連接器提供各種動作，可用的具體動作取決於透過 MCP 連線的工具。

動作範例

本節說明如何透過 MCP 連接器，對不同工具執行部分動作。

Jira 動作：取得問題

這個範例示範如何使用為 Jira 設定的 MCP 連線，列出 Jira 問題。

在「設定連接器工作」對話方塊中，按一下「動作」。
選取「get_issues」動作，然後按一下「完成」。
在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下「connectorInputPayload」，然後在「Default Value」(預設值) 欄位中輸入類似下列的值：
```
  {
    "issue_ids": ["YOUR_ISSUE_ID_1", "YOUR_ISSUE_ID_2"]
  }
```

線性動作：列出問題

這個範例示範如何使用為 Linear 設定的 MCP 連線，列出 Linear 中的問題。

在「設定連接器工作」對話方塊中，按一下「動作」。
選取「list_issues」動作，然後按一下「完成」。
在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下「connectorInputPayload」，然後在「Default Value」(預設值) 欄位中輸入類似下列的值：
```
  {
    "limit": 50
  }
```

Sentry Actions：Whoami

這個範例說明如何使用為 Sentry 設定的 MCP 連線，從 Sentry 取得使用者資訊。

在「設定連接器工作」對話方塊中，按一下「動作」。
選取「whoami」動作，然後按一下「完成」。
在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下「connectorInputPayload」，然後在「Default Value」(預設值) 欄位中輸入類似下列的值：
```
  {
    "name": "example-org"
  }
```

尋找機構

這個範例示範如何使用為 Sentry 設定的 MCP 連線，在 Sentry 中尋找機構。

在「設定連接器工作」對話方塊中，按一下「動作」。
選取 find_organizations 動作，然後按一下「完成」。
在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下「connectorInputPayload」，然後在「Default Value」(預設值) 欄位中輸入類似下列的值：
```
  {}
```

對講機動作：搜尋對話

這個範例說明如何使用為 Intercom 設定的 MCP 連線，在 Intercom 中搜尋對話詳細資料。

在「設定連接器工作」對話方塊中，按一下「動作」。
選取「搜尋」動作，然後按一下「完成」。
在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下「connectorInputPayload」，然後在「Default Value」(預設值) 欄位中輸入類似下列的值：
```
  {
    "query": "object_type:conversations state:open created_at:gt:2024-01-01"
  }
```

系統限制

MCP 連接器有系統限制，可能因連接的特定工具而異。根據預設，Integration Connectors 會為連線分配 2 個節點 (以提高可用性)。

如要瞭解 Integration Connectors 適用的限制，請參閱「限制」一文。