MCP 连接器

借助 Model Context Protocol (MCP) 连接器，您可以在 Integration Connectors 中创建和配置 MCP 连接。您可以在业务应用中使用此连接，以便与 MCP 安全地交换数据并执行操作。

如需查看受支持的实体和操作的列表，请参阅实体操作示例。如需了解支持的连接器专用操作，请参阅操作。

MCP 连接器版本

MCP 连接器支持两个版本：

  • MCP v1：使用此连接器版本可访问 MCP v1 API。
  • MCP v2：使用此连接器版本可访问 MCP v2 API。

如需了解如何创建 MCP 连接，请参阅创建和配置 MCP 连接器。

实体、操作和动作

所有集成连接器都会为所连接应用的对象提供抽象层。您只能通过此抽象访问应用的对象。抽象作为实体、操作和动作向您展示。

  • 实体：实体可以被视为连接的应用或服务中的对象或属性集合。不同连接器的实体定义也会有所不同。例如，在数据库连接器中，表是实体；在文件服务器连接器中，文件夹是实体；在消息传递系统连接器中，队列是实体。

    但可能的情况是，连接器不支持或不具有任何实体，在这种情况下，Entities 列表将为空。

  • 操作：操作是指您可以对实体执行的操作。您可以对实体执行以下任一操作：

    从可用列表中选择一个实体，系统会生成该实体可用的操作列表。如需了解操作的详细说明，请参阅连接器任务的实体操作。不过，如果连接器不支持任何实体操作，则不支持的操作不会列在 Operations 列表中。

  • 动作：动作是可通过连接器接口提供给集成的头等函数。动作可让您对一个或多个实体进行更改，并且动作因连接器而异。通常，操作会包含一些输入参数和一个输出参数。但可能的情况是，连接器不支持任何动作，在这种情况下，Actions 列表将为空。

支持的实体和操作

MCP 连接器支持实体和操作，具体可用的实体和操作取决于通过 MCP 连接的工具。

实体操作示例

本部分提供了不同工具的实体操作示例。

列出 Jira 问题实体

此示例使用 Jira MCP 连接列出了 Issues 实体的所有 Issues。

  1. 在配置连接器任务窗口中，点击实体。
  2. 从实体列表中选择问题。
  3. 选择 List 操作，然后点击完成。
  4. 在连接器任务的任务输入部分，点击 connectorInputPayload，然后在默认值字段中输入类似于以下内容的值： 
    {
      "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。

  1. 在配置连接器任务窗口中，点击实体。
  2. 从实体列表中选择请求。
  3. 选择 List 操作，然后点击完成。

根据 ID 获取用户

此示例从 Users 实体中获取 AccountId 为 `6035864ce2020c0070b5285b` 的用户。`AccountId` 是 Users 实体的主键。如需获取特定实体，请将 List 操作与主键上的 filterClause 搭配使用，因为此实体不支持 Get 操作。

  1. 在配置连接器任务窗口中，点击实体。
  2. 从实体列表中选择用户。
  3. 选择 List 操作，然后点击完成。
  4. 在连接器任务的任务输入部分，点击 filterClause，然后在默认值字段中输入“AccountId”=6035864ce2020c0070b5285b。

操作

MCP 连接器提供各种操作，具体可用的操作取决于通过 MCP 连接的工具。

操作示例

本部分介绍了如何通过 MCP 连接器针对不同工具执行一些操作。

Jira 操作：获取问题

此示例演示了如何使用为 Jira 配置的 MCP 连接列出 Jira 问题。

  1. 在配置连接器任务对话框中，点击操作。
  2. 选择 get_issues 操作，然后点击完成。
  3. 在连接器任务的任务输入部分，点击 connectorInputPayload，然后在默认值字段中输入类似于以下内容的值： 
      {
    "issue_ids": ["YOUR_ISSUE_ID_1", "YOUR_ISSUE_ID_2"]
  }

Linear 操作：列出问题

此示例演示了如何使用为 Linear 配置的 MCP 连接在 Linear 中列出问题。

  1. 在配置连接器任务对话框中，点击操作。
  2. 选择 list_issues 操作，然后点击完成。
  3. 在连接器任务的任务输入部分，点击 connectorInputPayload，然后在默认值字段中输入类似于以下内容的值： 
      {
    "limit": 50
  }

Sentry 操作：Whoami

此示例演示了如何使用为 Sentry 配置的 MCP 连接从 Sentry 获取用户信息。

  1. 在配置连接器任务对话框中，点击操作。
  2. 选择 whoami 操作，然后点击完成。
  3. 在连接器任务的任务输入部分，点击 connectorInputPayload，然后在默认值字段中输入类似于以下内容的值： 
      {
    "name": "example-org"
  }

查找组织

此示例演示了如何使用为 Sentry 配置的 MCP 连接在 Sentry 中查找组织。

  1. 在配置连接器任务对话框中，点击操作。
  2. 选择 find_organizations 操作，然后点击完成。
  3. 在连接器任务的任务输入部分，点击 connectorInputPayload，然后在默认值字段中输入类似于以下内容的值： 
      {}

Intercom 操作：搜索对话

此示例演示了如何使用为 Intercom 配置的 MCP 连接在 Intercom 中搜索对话详细信息。

  1. 在配置连接器任务对话框中，点击操作。
  2. 选择搜索操作，然后点击完成。
  3. 在连接器任务的任务输入部分，点击 connectorInputPayload，然后在默认值字段中输入类似于以下内容的值： 
      {
    "query": "object_type:conversations state:open created_at:gt:2024-01-01"
  }

系统限制

MCP 连接器存在系统限制，这些限制可能会因所连接的特定工具而异。 默认情况下，Integration Connectors 会为连接分配 2 个节点（以提高可用性）。

如需了解适用于 Integration Connectors 的限制，请参阅限制。