智能体只认识知识库，怎么办？
企业的客服智能体，主要依靠自有知识库回答问题。但客户的问题常常超出知识库范围：
- 「从你们仓库开车到港口大概要多久？」——需要地图服务；
- 「帮我查一下这家公司的工商信息」——需要企业信息服务；
- 「明天上海天气怎么样，影响装柜吗？」——需要天气服务。
过去要回答这些问题，通常需要开发逐个对接接口，周期长、维护成本高。
现在，越来越多的服务商开始提供 MCP（Model Context Protocol，模型上下文协议）服务。MCP 相当于 AI 世界的「通用插座」：服务商按统一标准提供工具，AI 按统一方式调用。立刻智能体作为 MCP 客户端，可以直接接入这些服务，无需编写代码，就能为智能体扩展新能力。
接入方式：一个地址 + 一把 Key
接入一台外部 MCP 服务器，核心只需要两样东西：服务地址和密钥。
服务地址
填写对方提供的 MCP 服务地址即可，要求：
- 协议为 Streamable HTTP（目前主流远程 MCP 服务采用的标准传输方式）；
- 地址必须是 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 机器人 · 企微机器人
智能体会根据客户问题自动判断是否需要调用工具、调用哪一个，并在获取结果后组织成自然语言回答。图片结果会直接在对话中显示，音频、视频、文件以下载链接形式发送给客户。
对方工具变了怎么办？
第三方服务会持续升级。在工具抽屉中点击「重新读取」，平台会与上次清单对比并标记变化：
- 新增：对方新加入的工具，默认关闭，确认后再启用；
- 参数有变化：对方修改了工具的参数说明，提醒确认后继续使用；
- 对方已移除：对方不再提供的工具，自动禁止启用。
这样可以避免因第三方接口变更导致智能体出现误调用。
安全与管控
将外部服务接入客服系统，安全是首要考虑。平台提供了以下设计：
- 密钥加密保存：密钥采用 AES-256-GCM 加密存储，页面打码显示，保存后不再明文展示；编辑时留空表示保留原密钥。
- 更换主机必须重填密钥：服务地址改为另一个主机时，必须重新填写密钥，旧密钥不会带入新地址。
- 禁止连接内网：地址在保存时和每次调用前都会复核，指向内网、本机等不安全地址的请求一律拒绝，防止被用于探测企业内部网络。
- 地址不能夹带凭证：地址中若残留
key、token等疑似密钥的参数会被拒绝，必须放入专门的密钥栏加密保存。 - 敏感权限单独授予：新增、修改服务器和启用工具需要「MCP管理 · 接入外部」权限，该权限不包含在「全部标准功能」中，必须由管理员单独授予。普通员工只能在智能体中勾选管理员已启用的工具。
- 调用有记录：每次外部工具调用均可在 MCP管理 → 调用记录 → 接入外部 中查看，失败时会标明原因类别。
稳定性设计
- 单次调用 30 秒超时：对方服务响应异常时，不会阻塞整轮对话；
- 共用调用上限：外部工具与平台技能共用每轮调用次数上限，避免无限循环调用；
- 临时故障不掉线：服务器测试连接失败时，已启用的工具仍保留装载，对方恢复后即可继续使用，无需重新配置。确定不再使用时，手动「停用」即可。
使用上限与计费
| 项目 | 专业版（Pro） | 旗舰版（Ultra） |
| 可接入服务器数 | 5 台 | 20 台 |
| 每台服务器工具数 | 最多 50 个 | 最多 50 个 |
| 每个智能体外部工具数 | 最多 20 个 | 最多 20 个 |
| 单次调用时长 | 30 秒 | 30 秒 |
| 单个结果文件 | 20MB | 20MB |
| 调用记录保留 | 90 天 | 365 天 |
调用外部工具不扣平台技能点，仅按正常对话计算模型 Token。第三方服务本身的费用，以服务商的计费规则为准。
套餐降至基础版时，外部工具暂停使用，但配置会保留；升回专业版或旗舰版后自动恢复，无需重新填写。
智能广场：别人调通的，你一键复用
企业接入一个好用的 MCP 服务后，可以将其提交到智能广场。提交内容不包含密钥，经平台审核后上架。
其他企业在广场找到该服务后，可一键复制到「接入外部」，状态显示为「待填写密钥」，填入自己申请的 Key 即可使用，地址、密钥方式、参数名等配置无需重新研究。
目前支持与暂不支持
为了便于接入前判断，以下列出当前支持范围：
目前支持
- Streamable HTTP 协议的远程 MCP 服务（https）；
- 密钥方式：无 / 请求头 / 地址参数。
暂不支持
- 需要 OAuth 授权登录的 MCP 服务：例如需先跳转到服务商页面登录、点击同意后才能使用的服务；
- SSE 传输方式：部分早期 MCP 服务使用的旧传输协议；
- stdio 本地进程方式：需在本机安装、以命令行方式启动的 MCP 服务；
- 内网部署的 MCP 服务：出于安全考虑，只能接入公网 https 地址。
简单来说，只要对方提供的是「一个 https 地址 + 一把 Key（或不需要 Key）」的远程 MCP 服务，即可接入。目前大多数云服务商提供的远程 MCP 服务均采用这种方式。对于暂不支持的方式，平台将根据用户需求持续评估。
如何开始
- 入口：控制台 → 外部拓展 → MCP管理 → 接入外部
- 套餐：专业版 / 旗舰版
- 权限：MCP管理 · 接入外部（
mcp-client），企业管理员默认拥有，员工需单独授予 - 文档：帮助中心搜索「外部 MCP」
注：平台不内置第三方 MCP 服务，也不提供第三方密钥。接入第三方服务前，请确认相关服务的商业授权与使用条款。