将 MCP 服务器连接到您的机器人 #

MCP 服务器让您的 AI 机器人能够在实时对话中使用来自其他系统的工具，而无需您手动构建每一个工具。您只需将机器人指向一个 MCP 服务器，该服务器提供的所有工具都会自动变为可用。

如果您使用过“自定义函数”（Custom Functions），其理念是一样的，只是更进了一步：自定义函数是您自己手动连接的单个工具，而 MCP 服务器是一个现成的工具包，机器人可以自行发现并调用其中的工具。

什么是 MCP 服务器？ #

MCP (Model Context Protocol) 是一种为 AI 助手提供外部工具访问权限的开放标准。许多现代应用程序和服务现在都会发布“MCP 服务器”——即一个单一的 Web 地址，它公开了一组 AI 可以调用的工具：例如查找信息、获取记录、运行查询或创建项目。

与其向机器人逐一描述每个工具，不如直接为 Your AI Connector 提供服务器地址和访问密钥。Your AI Connector 会询问服务器“你能做什么？”，获取工具列表，并将其提供给您的机器人。当服务器添加新工具时，您的机器人无需进行任何额外设置即可使用它。

自定义函数与 MCP 服务器 — 该如何选择：

您可以在同一个 Agent 上同时使用这两者。

工作原理（简易版） #

1. 您在 MCP Servers 页面注册一个 MCP 服务器——输入其网址和授权标头（通常是 API 密钥）。
2. Your AI Connector 连接并发现服务器的工具，并记住该列表。
3. 您在 Agent 上启用该服务器。
4. 在对话过程中，当客户询问工具可以回答的问题时，机器人会调用该工具，读取结果并自然地进行回复。

客户永远看不到背后的机制 — 他们只会得到由真实、最新的信息支持的答案。

MCP 工具调用的费用 #

来自 MCP 服务器的工具调用计费方式与自定义函数调用完全相同，按您代理的 AI 质量等级计费：

添加 MCP 服务器（分步指南） #

在主侧边栏的 AI Studio 下，点击 MCP Servers。然后点击 + Add Server。

填写表单：

选择登录方式：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) 控件。它会打开与你可以为自定义函数设置的相同的执行限制，并仅应用于该特定工具。当服务器的工具调用付费第三方服务，或者某个工具在每次对话中只能运行一次时，这非常有用。此处的所有设置均为可选；保持为空时，工具的行为将与之前完全一致。

• 只读 (Read-only)。 一些服务器会为每个工具声明它是否仅读取数据。自动（服务器设置）会信任该声明；你可以根据需要覆盖它——当你确定某个工具从不创建或更改任何内容时，将其标记为只读（这允许 AI 在中断的回复中安全地重试，而不是让客户得不到答案）；或者当你由于不信任服务器的声明而将其标记为非只读。
• 重复调用时提供缓存结果 (Serve cached result on repeat calls)。 当 AI 使用相同的输入再次调用该工具时，将重用之前的结果（最长保留 24 小时），而不是再次调用服务器。
• 每次对话最大运行次数 (Max runs per conversation) 和 每个时间窗口最大运行次数 (max runs per time window) 的工作方式与自定义函数完全相同：仅针对成功的运行。当限制生效时，AI 会被告知原因，并使用它已有的信息进行回答——客户永远不会被晾在一边。测试对话不受此限制。

关于信任的一点诚恳说明：限制控制的是我们调用服务器的方式和频率——它们无法改变服务器在被调用后内部执行的操作。此外，将第三方工具覆盖为“只读”比在自己的自定义函数上进行此操作要求更高，因为那是别人的代码；请仅针对你了解的工具进行此操作。

在智能体上启用服务器 #

注册服务器使其变为可用状态；您仍需选择哪些智能体可以使用它。

1. 打开智能体并转到其人工智能能力 (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 美元以下的保暖跑步夹克”）来查找产品，并获取实时价格、变体和库存信息。
• 产品详情——特定产品的完整信息，包括选项和可用性。
• 商店政策和常见问题解答——根据商店页面回答有关运输、退货、退款和隐私的问题。
• 购物车——为客户构建购物车并提供结账链接。

要连接商店，请添加一个服务器并填写以下信息：

保存，点击 Test Connection（测试连接），然后在您的代理上启用该服务器——这就是全部设置过程。

需要了解两点：

• 订单信息不在此服务器上。 Shopify 特意将订单数据排除在此公共端点之外。对于“我的订单在哪里？”这类问题，请将此服务器与一个自定义函数配合使用——请参阅 Shopify 订单状态示例。
• 它适用于任何 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 服务器，则说明您当前的计划不包含此功能——请升级到包含开发者工具的计划以启用它。

后续步骤 #

• 自定义函数 — 手动连接单个工具，而不是连接整个服务器。
• AI Agent — 在此处为机器人启用 MCP 服务器。
• AI Agent — MCP 服务器所属的 AI Studio 组的主页面。