# 一个地址加一把 Key：给你的智能体接入任意 MCP 服务

来源: https://www.likelic.com/blog/connect-external-mcp-server.html

智能体只认识知识库，怎么办？
--------------

企业的客服智能体，主要依靠自有知识库回答问题。但客户的问题常常超出知识库范围：

1.  「从你们仓库开车到港口大概要多久？」——需要地图服务；
2.  「帮我查一下这家公司的工商信息」——需要企业信息服务；
3.  「明天上海天气怎么样，影响装柜吗？」——需要天气服务。

过去要回答这些问题，通常需要开发逐个对接接口，周期长、维护成本高。

现在，越来越多的服务商开始提供 **MCP（Model Context Protocol，模型上下文协议）服务**。MCP 相当于 AI 世界的「通用插座」：服务商按统一标准提供工具，AI 按统一方式调用。立刻智能体作为 MCP 客户端，可以直接接入这些服务，**无需编写代码**，就能为智能体扩展新能力。

接入方式：一个地址 + 一把 Key
------------------

接入一台外部 MCP 服务器，核心只需要两样东西：**服务地址**和**密钥**。

#### 服务地址

填写对方提供的 MCP 服务地址即可，要求：

1.  协议为 **Streamable HTTP**（目前主流远程 MCP 服务采用的标准传输方式）；
2.  地址必须是 **https**，保证传输加密。

#### 密钥的三种填法

不同服务商要求把密钥放在不同位置，平台提供三种方式：

| **方式** | **适用情况** | **需要填写** |
| --- | --- | --- |
| 无 | 对方服务不需要密钥 | 不用填 |
| 请求头 | 对方要求在请求头里带密钥，如 `Authorization`、`X-API-Key` | 请求头名称 + 密钥值 |
| 地址参数 | 对方要求在地址后面带密钥，如 `?key=xxx` | 参数名 + 密钥值 |

**举个例子**：某地图服务商提供的 MCP 地址是 `https://mcp.example.com/mcp`，要求在地址上带 `?key=你的密钥`。配置时，地址只填 `https://mcp.example.com/mcp`，密钥方式选「地址参数」，参数名填 `key`，密钥值填你在服务商处申请到的 Key。

如果你习惯直接复制带密钥的完整地址，平台也能识别出其中的密钥参数，自动提取并单独加密保存，避免密钥以明文形式留在地址中。

四步完成接入
------

**第一步：添加服务器**

进入控制台 **外部拓展 → MCP管理 → 接入外部**，点击新增服务器，填写名称、地址，选择密钥方式。

**第二步：自动测试连接**

保存时，平台会自动测试连接并读取对方的工具清单。连接失败时会明确提示原因：

| **提示** | **常见原因** |
| --- | --- |
| 地址无法访问 | 域名解析失败、网络不通、地址不符合安全要求 |
| 鉴权失败 | 密钥错误、过期，或密钥方式、参数名填写有误 |
| 不是 MCP 服务 | 能连上，但对方不是 Streamable HTTP 的 MCP 服务 |
| 超时 | 对方响应过慢 |

**第三步：启用工具**

读取到的工具**默认全部关闭**，管理员可逐个查看说明，只启用需要的工具。

**第四步：绑定到智能体**

在 **智能体管理** 中编辑智能体，在「外部 MCP 工具」中勾选要使用的工具，保存即生效。每个智能体最多可绑定 20 个外部工具。

配置完成后，客户在以下渠道与该智能体对话时，均可使用外部工具：

> 控制台智能对话 · 网页组件 · 企业微信 · 公众号 · QQ 机器人 · 企微机器人

智能体会根据客户问题自动判断是否需要调用工具、调用哪一个，并在获取结果后组织成自然语言回答。图片结果会直接在对话中显示，音频、视频、文件以下载链接形式发送给客户。

对方工具变了怎么办？
----------

第三方服务会持续升级。在工具抽屉中点击「**重新读取**」，平台会与上次清单对比并标记变化：

1.  **新增**：对方新加入的工具，默认关闭，确认后再启用；
2.  **参数有变化**：对方修改了工具的参数说明，提醒确认后继续使用；
3.  **对方已移除**：对方不再提供的工具，自动禁止启用。

这样可以避免因第三方接口变更导致智能体出现误调用。

### 安全与管控

将外部服务接入客服系统，安全是首要考虑。平台提供了以下设计：

1.  **密钥加密保存**：密钥采用 AES-256-GCM 加密存储，页面打码显示，保存后不再明文展示；编辑时留空表示保留原密钥。
2.  **更换主机必须重填密钥**：服务地址改为另一个主机时，必须重新填写密钥，旧密钥不会带入新地址。
3.  **禁止连接内网**：地址在保存时和每次调用前都会复核，指向内网、本机等不安全地址的请求一律拒绝，防止被用于探测企业内部网络。
4.  **地址不能夹带凭证**：地址中若残留 `key`、`token` 等疑似密钥的参数会被拒绝，必须放入专门的密钥栏加密保存。
5.  **敏感权限单独授予**：新增、修改服务器和启用工具需要「MCP管理 · 接入外部」权限，该权限不包含在「全部标准功能」中，必须由管理员单独授予。普通员工只能在智能体中勾选管理员已启用的工具。
6.  **调用有记录**：每次外部工具调用均可在 **MCP管理 → 调用记录 → 接入外部** 中查看，失败时会标明原因类别。

### 稳定性设计

1.  **单次调用 30 秒超时**：对方服务响应异常时，不会阻塞整轮对话；
2.  **共用调用上限**：外部工具与平台技能共用每轮调用次数上限，避免无限循环调用；
3.  **临时故障不掉线**：服务器测试连接失败时，已启用的工具仍保留装载，对方恢复后即可继续使用，无需重新配置。确定不再使用时，手动「停用」即可。

使用上限与计费
-------

| **项目** | **专业版（Pro）** | **旗舰版（Ultra）** |
| --- | --- | --- |
| 可接入服务器数 | 5 台 | 20 台 |
| 每台服务器工具数 | 最多 50 个 | 最多 50 个 |
| 每个智能体外部工具数 | 最多 20 个 | 最多 20 个 |
| 单次调用时长 | 30 秒 | 30 秒 |
| 单个结果文件 | 20MB | 20MB |
| 调用记录保留 | 90 天 | 365 天 |

调用外部工具**不扣平台技能点**，仅按正常对话计算模型 Token。第三方服务本身的费用，以服务商的计费规则为准。

套餐降至基础版时，外部工具暂停使用，但配置会保留；升回专业版或旗舰版后自动恢复，无需重新填写。

智能广场：别人调通的，你一键复用
----------------

企业接入一个好用的 MCP 服务后，可以将其提交到**智能广场**。提交内容**不包含密钥**，经平台审核后上架。

其他企业在广场找到该服务后，可一键复制到「接入外部」，状态显示为「待填写密钥」，填入自己申请的 Key 即可使用，地址、密钥方式、参数名等配置无需重新研究。

目前支持与暂不支持
---------

为了便于接入前判断，以下列出当前支持范围：

**目前支持**

1.  Streamable HTTP 协议的远程 MCP 服务（https）；
2.  密钥方式：无 / 请求头 / 地址参数。

**暂不支持**

1.  **需要 OAuth 授权登录的 MCP 服务**：例如需先跳转到服务商页面登录、点击同意后才能使用的服务；
2.  **SSE 传输方式**：部分早期 MCP 服务使用的旧传输协议；
3.  **stdio 本地进程方式**：需在本机安装、以命令行方式启动的 MCP 服务；
4.  **内网部署的 MCP 服务**：出于安全考虑，只能接入公网 https 地址。

简单来说，**只要对方提供的是「一个 https 地址 + 一把 Key（或不需要 Key）」的远程 MCP 服务，即可接入**。目前大多数云服务商提供的远程 MCP 服务均采用这种方式。对于暂不支持的方式，平台将根据用户需求持续评估。

如何开始
----

1.  **入口**：控制台 → 外部拓展 → MCP管理 → 接入外部
2.  **套餐**：专业版 / 旗舰版
3.  **权限**：MCP管理 · 接入外部（`mcp-client`），企业管理员默认拥有，员工需单独授予
4.  **文档**：帮助中心搜索「外部 MCP」

> 注：平台不内置第三方 MCP 服务，也不提供第三方密钥。接入第三方服务前，请确认相关服务的商业授权与使用条款。