添加你自己的MCP服务器

通过URL连接远程MCP服务器，并选择Runner智能体可以用它的每个工具做什么。

如果你使用的服务有MCP服务器，你可以把它的工具交给Runner智能体。粘贴服务器URL，Runner会找到服务器的工具。然后由你选择智能体可以用每个工具做什么。

这适用于连接你的工具中没有的服务，例如你自己的ERP、库存系统或团队运行的工具。

开始前

入口路径：项目 → 智能体 → 工具 → 添加你自己的 MCP 服务器

你需要：

服务器必须满足以下条件：

每个商店最多可以添加10个MCP服务器。Runner从每个服务器最多保留100个工具。

重要：Runner无法检查自定义服务器如何处理你的数据。只添加你自己运行或非常了解的服务器。

打开你的项目，选择智能体 → 工具。
在添加你自己的 MCP 服务器这一行，选择添加服务器。
输入服务器 URL。也可以把服务器文档中的JSON配置粘贴到粘贴 JSON 配置。Runner会根据配置填入URL和密钥请求头。
可选：输入名称。如果留空，Runner会使用服务器自己的名称。Runner使用工具时会在聊天中显示这个名称。
在Runner 的登录方式下，选择无需登录或API 密钥。选择API 密钥时，输入请求头名称和密钥，例如Authorization和Bearer sk-…。Runner会加密保存密钥。包括你在内，任何人都无法再读取。
哪些智能体可以使用显示为所有智能体。之后可以按智能体单独修改。
选择我信任这个服务器。
选择连接并查找工具。Runner会连接服务器并列出它的工具。
为每个工具选择规则。然后选择带服务器名称的添加按钮，例如添加 Shop ERP。

添加后，服务器会显示在已连接下，并带有自定义 MCP标签。

每个工具都有以下三种规则之一：

Runner会根据每个工具的名称猜测一个初始规则，并按这个规则把工具分组：

分组	初始规则	Runner放入此组的工具名称
读取数据	允许	以读取类词语开头的名称，例如`list`、`get`或`search`。Runner无法识别的名称也都放在这里。
修改数据	先问我	包含`send`、`reply`、`remove`、`publish`、`pay`、`charge`、`refund`或`price`的名称。
删除数据	关闭	包含`delete`或`trash`的名称。

添加服务器前，请检查每个工具的规则。Runner只读取工具的名称，不看工具实际做什么。像update_inventory或create_customer这样的工具，初始规则是读取数据中的允许，因此智能体可能不经询问就修改数据。请把这类工具设为先问我或关闭。

添加服务器前，你可以修改任何工具的规则。之后，在服务器页面的所有智能体可以做什么下修改。服务器之后新增的工具默认为先问我；如果名称包含delete或trash，则默认为关闭。

这些规则适用于此项目中的所有聊天。Runner会在每次调用工具时检查规则。

在智能体 → 工具的已连接中打开服务器。服务器页面有以下控件：

控件或信息	作用
服务器URL和复制按钮	位于连接下。复制服务器 URL会复制URL。
状态	显示服务器上次响应的时间，或显示尚未检查。
登录	显示无需登录或密钥的最后4个字符。添加密钥或替换可更换密钥。
测试连接或刷新工具	重新连接服务器并获取当前工具列表。新工具默认为先问我，删除类工具默认为关闭。
移除服务器	移除服务器。智能体将无法使用它的工具，它的工具规则也会被删除。之后可以重新添加。

提示信息	处理方法
请输入完整的服务器 URL，例如 https://example.com/mcp。	输入完整的URL，包括路径。
Runner 只能连接公网服务器。此 URL 指向私有网络。	使用可以从互联网访问的URL。
此 URL 有响应，但不是 MCP 服务器。请检查路径。	在服务器文档中查找MCP路径。它通常以`/mcp`结尾。
Runner 无法连接到这个服务器。请检查 URL 以及服务器是否在线。	确认服务器正在运行，并且URL正确。
服务器拒绝了密钥。请检查请求头名称和密钥。	检查这两个值。有些服务器需要在密钥前加上`Bearer` 。
服务器有响应，但没有任何工具。	服务器没有向这个密钥提供工具。请检查服务器的设置。
这个店铺的 MCP 服务器已达上限。请先移除一个。	移除一个你不用的服务器。

在已连接中，停止工作的服务器会显示无法连接或密钥被拒绝。选择修复打开服务器，然后替换密钥或检查服务器。