---
lastModified: 2026-11-13
title: 添加你自己的MCP服务器
description: 通过URL连接远程MCP服务器，并选择Runner智能体可以用它的每个工具做什么。
seo:
  description: "通过URL把你自己的远程MCP服务器连接到Runner，可以使用API密钥，也可以不用。在智能体使用之前，把每个工具设为“允许”“先问我”或“关闭”。"
---

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

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

## 开始前

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

你需要：

- 商店所有者或管理员角色。其他成员无法添加、修改或移除服务器；
- 远程MCP服务器的URL，例如`https://example.com/mcp`；以及
- 如果服务器需要密钥，还需要API密钥及其请求头名称。

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

- 必须位于公网上。Runner不会连接`localhost`或私有网络地址。
- 必须使用MCP HTTP传输（Streamable HTTP）。Runner不会替你运行本地命令行（stdio）服务器。
- 必须无需登录，或使用请求头中的API密钥。**OAuth**暂不可用。

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

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

## 添加服务器

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

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

## 相关指南

- [连接和控制智能体应用](./agent-apps)
- [应用和集成概览](../apps-and-integrations)
- [排查应用连接问题](./troubleshooting)