小智AI接入 MCP 教程

MCP 是什么？为什么语音助手需要它

MCP（Model Context Protocol，模型上下文协议）是 Anthropic 于 2024 年底开源的开放协议，用来统一「大模型 / 智能体」与「外部工具」之间的连接方式。你可以把 MCP 想象成工具世界的 USB-C：过去每个助手接每个服务都要单独写一套接口，现在只要服务方实现一个 MCP Server、助手方实现一个 MCP Client，两边就能互通。

对小智这类语音助手来说，MCP 的价值在于：助手不需要提前内置「计算器怎么做」「高德地图怎么调」，而是在需要时向 MCP 服务发现并调用工具。你只需要把工具以 MCP 服务的形式暴露出来，对音箱说「算一下 12 乘 18」，助手就会自动走一遍 工具发现 → 选择 → 调用 的流程。

为什么小智只接「一个」MCP 接入点

小智智能体的设计默认只连接一个 MCP 接入点（一个 wss 端点）。如果你的工具分散在多个 MCP 服务里——一个计算器、一个日历、一个高德地图、一个你们自己的业务系统——直接把每个服务都塞给小智是行不通的：助手只会认它配置里的那一个端点。

MCP Gateway 解决的就是这个问题：网关本身以一个 MCP Server 的身份对外提供「一个接入点」，内部再把请求按工具前缀路由到你注册的各个 MCP 服务。对小智来说它只面对网关，对工具方来说它们各自的服务不变。这就是「一个端点，装下所有 MCP 工具」。

第一步：注册租户并登录控制台

打开 MCP Gateway 首页，点击右上角「注册账号」（或直接访问 /register），填写管理员用户名、密码与邮箱，同意用户协议后提交。注册成功后系统会为你创建一个独立租户，并把平台预置的应用（如技能中心）自动分配给你。

用刚才的账号登录，你会进入租户控制台。左侧「小智端点」「应用」「工具」「调用审计」等页面就是后续所有操作的入口。

第二步：从小智平台复制 MCP 接入点

登录小智AI的开放平台 / 后台，找到 MCP 或「技能 / 工具」相关配置页。小智会为你的设备生成一个专属的 MCP 接入点，形如：

wss://你的小智域名/mcp/?token=xxxxxxxx 或 wss://xiaozhi.me/mcp/?token=…

请完整复制这段 wss:// 地址（注意带上 token 参数），它就是你设备与 MCP 服务之间的「钥匙」。

第三步：粘贴到 MCP Gateway 租户控制台

回到 MCP Gateway 控制台，进入「小智端点」页，把上一步复制的 wss 地址粘贴到端点输入框并保存。网关会立即尝试与该端点建立连接（wss 握手）。

保存后，网关会以小智 MCP Server 的身份完成握手，并把当前租户已分配的工具清单（名称、一句话简介）上报给语音助手。你在「应用」页看到的每个已分配应用，其工具都会出现在这份清单里。

第四步：对音箱说第一句话

完成连接后，对你的小智音箱 / 设备说一句：「用计算器算一下 12 乘 18」。语音助手会调用网关上的 calculator 工具，并把结果念给你听。

如果没反应，按这个顺序排查：① 控制台「小智端点」页是否显示已连接；② 「应用」页里对应应用是否已分配且状态为已连接；③ 「工具」页里该工具是否处于启用状态；④ 打开「调用审计」，看语音调用是否到达网关、返回了什么错误。

进阶：技能渐进披露与上下文管理

工具一多，助手每次对话都要携带全部工具描述，会挤占宝贵的上下文。MCP Gateway 的技能机制把「完整指令」与「一句话简介」分离：平时只上报一句话简介，当语音真正触发某个技能时，网关才加载该技能的完整 SKILL.md 指令交给助手。

这样助手记得更准、响应更快，也是多工具场景下控制成本与延迟的关键手段。