# 将 MCP 服务器连接到您的机器人 MCP 服务器让您的 AI 机器人能够在实时对话中使用来自其他系统的工具，而无需您手动构建每一个工具。您只需将机器人指向一个 MCP 服务器，该服务器提供的所有工具都会自动变为可用。 如果您使用过“自定义函数”（Custom Functions），其理念是一样的，只是更进了一步：自定义函数是您自己手动连接的单个工具，而 MCP 服务器是一个现成的工具包，机器人可以自行发现并调用其中的工具。 --- ## 什么是 MCP 服务器？ MCP (Model Context Protocol) 是一种为 AI 助手提供外部工具访问权限的开放标准。许多现代应用程序和服务现在都会发布“MCP 服务器”——即一个单一的 Web 地址，它公开了一组 AI 可以调用的工具：例如查找信息、获取记录、运行查询或创建项目。 与其向机器人逐一描述每个工具，不如直接为 Your AI Connector 提供服务器地址和访问密钥。Your AI Connector 会询问服务器“你能做什么？”，获取工具列表，并将其提供给您的机器人。当服务器添加新工具时，您的机器人无需进行任何额外设置即可使用它。 **自定义函数与 MCP 服务器 — 该如何选择：** | | 自定义函数 | MCP 服务器 | | ------------------ | --------------------------------------------------- | -------------------------------------------------------------- | | **设置内容** | 一次一个工具，完全手动设置（URL、输入、响应映射）。 | 一个服务器地址 — 机器人会自动为您发现所有工具。 | | **适用场景** | 对您自己的系统进行单一、特定的调用。 | 连接到已经支持 MCP 并提供多种工具的服务。 | | **维护** | 当工具发生变化时，您需要更新函数。 | 服务器提供的新工具会自动出现。 | 您可以在同一个 Agent 上同时使用这两者。 --- ## 工作原理（简易版） 1. 您在 **MCP Servers** 页面**注册一个 MCP 服务器**——输入其网址和授权标头（通常是 API 密钥）。 2. Your AI Connector **连接并发现**服务器的工具，并记住该列表。 3. 您在 **Agent** 上**启用该服务器**。 4. 在对话过程中，当客户询问工具可以回答的问题时，**机器人会调用该工具**，读取结果并自然地进行回复。 客户永远看不到背后的机制 — 他们只会得到由真实、最新的信息支持的答案。 ### MCP 工具调用的费用 来自 MCP 服务器的工具调用计费方式与自定义函数调用完全相同，按您代理的 AI 质量等级计费： | AI 质量等级 | 每个 MCP 工具调用的积分 | 连接您自己的 Anthropic 密钥 (BYOK) | |---|---|---| | Pro | 1 积分 | 0 积分 — 使用您的密钥运行 | | Economy (已弃用) | 0.5 积分 | 0 积分 — 使用您的密钥运行 | | Max | 0.25 积分 | 仍为 0.25 积分，即使连接了您自己的密钥也会计费，因为 Max 运行在我们自己的模型上 | | Mini | 0.15 积分 | 仍为 0.15 积分，即使连接了您自己的密钥也会计费，因为 Mini 运行在我们自己的模型上 | --- ## 添加 MCP 服务器（分步指南） 在主侧边栏的 **AI Studio** 下，点击 **MCP Servers**。然后点击 **+ Add Server**。 填写表单： | 字段 | 输入内容 | 示例 | | -------------------- | ----------------------------------------------------------------------------- | --------------------------------- | | **名称 (Name)** | 服务器的简短标签（也用于为机器人命名其工具）。 | `Order System` | | **服务器 URL (Server URL)** | 服务器的 MCP 地址（有时称为“端点”），以 `https://` 开头。 | `https://tools.mystore.com/mcp` | | **授权标头名称 (Auth Header Name)** | 服务器进行身份验证所需的标头。除非服务器文档另有说明，否则请保留为 `Authorization`。 | `Authorization` | | **授权标头值 (Auth Header Value)** | 凭据本身，格式需符合服务器要求。 | `Bearer sk_live_abc123` | ### 选择登录方式：API 密钥或 OAuth Your AI Connector 支持两种与服务器进行身份验证的方式。请根据服务器文档的说明，使用表单顶部的 **Authentication**（身份验证）选项进行选择： - **API key / header（API 密钥/标头）：** 上述原始方法。您将固定凭据（API 密钥或令牌）粘贴到 **Auth Header Value** 字段中，Your AI Connector 会在每次请求时发送它。最适合提供长期有效密钥的服务器。 - **OAuth (sign in)（OAuth 登录）：** 适用于要求您登录而不是粘贴密钥的服务器。使用 OAuth 时无需复制密钥——您只需通过登录来批准访问权限，这与在其他网站上使用“使用 Google 账号登录”的方式相同。 **使用 OAuth 连接：** 1. 选择 **OAuth** 作为身份验证方法。授权标头字段将消失，取而代之的是一个 **Connect**（连接）卡片 — 您无需使用密钥。 2. 填写 **Name**（名称）和 **Server URL**（服务器 URL），然后点击 **Save**（保存）。服务器会被添加到您的列表中，但目前显示为 **not connected**（未连接）。 3. 点击服务器上的 **Connect**（连接）。系统会打开一个安全的登录窗口，您可以在其中批准访问权限。 4. 批准后，窗口会自动关闭。服务器现在显示为已连接，Your AI Connector 会加载其工具。 就是这样。Your AI Connector 会在后台自动保持连接处于活跃状态，因此您通常无需再次进行任何操作。如果服务器断开连接（例如，登录过期或有人在服务器端撤销了权限），它会显示为已断开连接——只需点击 **Reconnect**（重新连接）并再次登录即可。 如果点击 Connect 时无法自动设置服务器，系统会要求您粘贴一些详细信息（登录地址和客户端 ID），这些信息由服务器自身的文档提供，之后即可完成连接。 ### 测试连接 保存前，请点击 **Test Connection**（测试连接）。Your AI Connector 会联系服务器并向您展示其提供的工具列表。这是确认您的 URL 和密钥是否正确的快捷方式——如果连接失败，您会直接看到错误消息，而不是在对话中途才发现问题。 测试成功后，点击**保存 (Save)**。您的服务器将出现在列表中，并显示一个绿色状态点以及它所提供的工具数量。 ### 查看服务器列表 列表中的每个服务器都会显示： - **状态点** — 上次连接成功时为绿色，上次尝试失败时为红色（悬停可查看错误信息），在首次成功连接前为灰色。 - **服务器地址**及其当前提供的工具数量。 - **开关按钮**，用于在不删除服务器的情况下快速启用或禁用整个服务器。 Your AI Connector 大约每天会在后台刷新一次每个服务器的工具列表，因此新工具会自动显示出来。缓慢或暂时无法访问的服务器绝不会阻碍对话——机器人只会使用最后已知的工具列表，如果调用无法成功，它会优雅地进行回退处理。 ### 选择机器人可使用的工具 服务器提供的工具往往比您希望机器人触及的要多。您可以在不断开整个服务器连接的情况下，单独开启或关闭某些工具。 1. 点击列表中服务器旁的**铅笔（编辑）**图标。 2. 滚动到**工具 (Tools)** 部分——服务器提供的每个工具都会列出，并配有各自的开关。 3. 关闭您不希望机器人调用的任何工具，或使用**全部启用 (Enable all)** / **全部禁用 (Disable all)** 一键设置。 4. 点击**保存更改 (Save changes)**。 只有您保持开启的工具才会提供给机器人。被关闭的工具对机器人来说是完全不可见的——它无法调用该工具，且该工具也不会计入 40 个工具的限制中。 有两点值得注意： - **新工具默认保持关闭，直到您手动开启。** 一旦您对某个服务器的工具进行了筛选，该服务器后续添加的任何工具在到达时都会处于关闭状态，因此在您决定启用之前，机器人无法使用任何新工具。（您从未筛选过的服务器将保持其所有工具开启，与之前完全一致。） - **这与下方的智能体 (Agent) 选择是分开的。** 在此处，您决定哪些服务器工具在账户范围内存在；而在智能体设置中，您决定该智能体可以访问哪些服务器——如果需要，您还可以针对该智能体进一步缩小其可用的工具范围。 ### 为每个工具设置执行限制 在每个工具的开关旁边，你会找到一个**限制 (Limits)** 控件。它会打开与你可以为[自定义函数](custom-functions.md#execution-limits)设置的相同的执行限制，并仅应用于该特定工具。当服务器的工具调用付费第三方服务，或者某个工具在每次对话中只能运行一次时，这非常有用。此处的所有设置均为可选；保持为空时，工具的行为将与之前完全一致。 - **只读 (Read-only)。** 一些服务器会为每个工具声明它是否仅读取数据。**自动（服务器设置）**会信任该声明；你可以根据需要覆盖它——当你确定某个工具从不创建或更改任何内容时，将其标记为**只读**（这允许 AI 在中断的回复中安全地重试，而不是让客户得不到答案）；或者当你由于不信任服务器的声明而将其标记为**非只读**。 - **重复调用时提供缓存结果 (Serve cached result on repeat calls)。** 当 AI 使用相同的输入再次调用该工具时，将重用之前的结果（最长保留 24 小时），而不是再次调用服务器。 - **每次对话最大运行次数 (Max runs per conversation)** 和 **每个时间窗口最大运行次数 (max runs per time window)** 的工作方式与自定义函数完全相同：仅针对成功的运行。当限制生效时，AI 会被告知原因，并使用它已有的信息进行回答——客户永远不会被晾在一边。测试对话不受此限制。 关于信任的一点诚恳说明：限制控制的是我们*调用*服务器的方式和频率——它们无法改变服务器在被调用后内部执行的操作。此外，将第三方工具覆盖为“只读”比在自己的自定义函数上进行此操作要求更高，因为那是别人的代码；请仅针对你了解的工具进行此操作。 --- ## 在智能体上启用服务器 注册服务器使其变为可用状态；您仍需选择哪些智能体可以使用它。 1. 打开[智能体](../ai-agents/ai-agents.md)并转到其**人工智能能力 (AI Abilities)** 选项卡。（对于仍直接持有自身 AI 设置而非通过独立智能体设置的战役，同样的列表会出现在该战役自身的**人工智能能力**步骤中。） 2. 找到 **MCP 服务器 (MCP servers)** 部分。 3. 开启您希望此智能体的机器人能够使用的每个服务器。 4. 点击**保存更改 (Save changes)** — 只有保存后，所选内容才会生效。 每个 **Agent 最多可启用 5 个服务器**。只有启用的服务器才可供该 Agent 的机器人使用，这有助于让机器人专注于相关的工具。 ### 选择 Agent 可以使用的工具 一旦在 Agent 上启用了服务器，您还可以缩小该特定 Agent 可以调用的**工具范围**——当一个 Agent 只需要读取数据，而另一个 Agent 还需要创建记录时，这非常有用。 1. 在 **AI 能力**选项卡上，找到已启用的服务器，点击 **“……个工具已为此 Agent 启用”** 行以展开工具列表。 2. 关闭该 Agent 不应使用的任何工具，然后点击**保存更改**。 两条规则可确保此过程的可预测性： - **Agent 只能缩小范围，不能扩大范围。** 您在账户范围内（在“MCP 服务器”页面上）关闭的工具不会出现在此处，也无法为单个 Agent 重新启用。 - **Agent 默认继承设置。** 如果您未触动某个 Agent 的工具列表，它将遵循账户范围内的选择——包括您随后在那里启用的工具。一旦您缩小了某个 Agent 的列表，新工具在该 Agent 上将保持关闭状态，直到您手动启用它们。 --- ## 现成示例：连接 Shopify 商店 每个 Shopify 商店都自带一个内置的 MCP 服务器——无需安装任何应用，也无需创建密钥。Shopify 会将其托管在商店自己的网址末尾，并加上 `/api/mcp`。 机器人可以从中获取的内容： - **产品搜索**——通过描述客户需求（例如“100 美元以下的保暖跑步夹克”）来查找产品，并获取实时价格、变体和库存信息。 - **产品详情**——特定产品的完整信息，包括选项和可用性。 - **商店政策和常见问题解答**——根据商店页面回答有关运输、退货、退款和隐私的问题。 - **购物车**——为客户构建购物车并提供结账链接。 要连接商店，请添加一个服务器并填写以下信息： | 字段 | 输入内容 | |---|---| | **名称** | `Shopify Store`（或商店名称） | | **服务器 URL** | 商店网址加上 `/api/mcp`——例如 `https://mystore.com/api/mcp`。商店的技术地址也可以：`https://mystore.myshopify.com/api/mcp`。 | | **身份验证** | 保持选中 **API key / header**，并将 **Auth Header Value** 留空——此服务器不需要密钥。 | 保存，点击 **Test Connection**（测试连接），然后在您的代理上启用该服务器——这就是全部设置过程。 需要了解两点： - **订单信息不在此服务器上。** Shopify 特意将订单数据排除在此公共端点之外。对于“我的订单在哪里？”这类问题，请将此服务器与一个自定义函数配合使用——请参阅 [Shopify 订单状态示例](custom-functions.md#complete-example-shopify-order-status)。 - **它适用于任何 Shopify 商店**——包括您代为管理账户的客户商店。您只需要商店的网址即可。 --- ## 安全性——仅连接您信任的服务器 您连接的 MCP 服务器可被您的机器人调用，并返回机器人读取和执行操作的文本。请将其视为任何其他持有您系统密钥的集成： - **仅注册您控制或完全信任的服务器。** 工具描述由运行服务器的人编写，机器人会读取这些描述来决定何时使用工具。 - **使用专用且受限的 API 密钥**，而非管理员凭据。您的密钥会被安全存储，且绝不会在数据导出中显示。OAuth 登录同样适用——访问令牌会被安全存储并从任何导出中脱敏。 - **URL 必须是公共 `https://` 地址。** 出于安全考虑，内部地址、localhost 和专用网络地址将被拒绝。 - **一旦不再信任某个服务器，请立即禁用它**——将其切换为关闭或删除，它将立即从所有 Agent 中移除。 --- ## 故障排除 - **红色状态点 / 连接失败：** 重新打开服务器并点击 **测试连接** 以查看具体错误。最常见的原因是密钥错误或过期、URL 拼写错误，或者服务器要求的标头名称不是 `Authorization`。 - **OAuth 服务器停止工作 / 要求重新连接：** OAuth 登录可能会在服务器端被撤销或过期。打开服务器并再次点击 **连接** 以重新登录。请注意，OAuth 登录信息不会在账户之间复制，因此复制的 Agent 或活动的服务器必须在您将其复制到的账户中重新连接。 - **机器人未使用工具：** 首先检查该工具是否已在服务器的 **工具** 部分中开启（编辑服务器以查看列表）——未开启的工具对机器人是不可见的。然后确保该服务器已在该特定 Agent 上启用，并且客户的请求明确符合该工具的功能。与自定义函数一样，服务器端清晰的工具名称和描述有助于机器人做出正确的选择。 - **服务器提供的工具未显示在机器人中：** 如果您已对该服务器的工具进行了筛选，请记住，在您筛选后添加的任何工具默认都是关闭的。编辑服务器，打开 **工具** 部分，然后将其开启。 - **连接器是否处理 MCP HTTP 会话？** 是的。如果您的服务器在建立连接时发出 `mcp-session-id` 标头，我们会将其存储并在随后的每次请求中连同 `MCP-Protocol-Version` 标头一起发送。有状态服务器无需您进行任何额外配置即可工作。 - **工具被跳过：** 一个 Agent 最多可同时使用 5 个服务器和 40 个 MCP 工具。如果服务器提供的工具数量非常多，部分工具可能无法加载——请在服务器的 **工具** 部分关闭您不需要的工具，或者让每个服务器专注于您实际使用的工具。 --- ## 套餐要求 MCP 服务器与自定义函数一样，属于开发者工具集的一部分。如果您在侧边栏的“AI Studio”部分中没有看到 **MCP 服务器**，则说明您当前的计划不包含此功能——请升级到包含开发者工具的计划以启用它。 --- ## 后续步骤 - [自定义函数](custom-functions.md) — 手动连接单个工具，而不是连接整个服务器。 - [AI Agent](../ai-agents/ai-agents.md) — 在此处为机器人启用 MCP 服务器。 - [AI Agent](../ai-agents/ai-agents.md) — MCP 服务器所属的 AI Studio 组的主页面。