MCP Gateway登录控制台

使用文档

从注册到语音调用的完整指引，也适用于小智（xiaozhi）语音助手接入 MCP 的场景。遇到问题请联系平台管理员。

一、快速开始：注册到第一次语音调用
  1. 注册租户（首页右上角「注册账号」），或由平台管理员为你开通账号；
  2. 登录控制台，进入「小智端点」页；
  3. 在小智官方平台复制你的 MCP 接入点（wss://…/mcp/?token=…），粘贴到端点配置并保存，网关即完成握手；
  4. 对音箱说一句话试试：「用计算器算一下 12 乘 18」。
  5. 如果调用没有生效，按顺序检查：端点是否显示已连接 → 应用是否已分配且连接 → 工具是否启用 → 「调用审计」中是否有失败记录。
二、应用与工具
  1. 平台维护统一的应用目录（计算器、日历、高德地图、技能中心等），租户在「应用」页看到的是已分配给自己的应用；
  2. 需要新应用时联系平台管理员从模板安装并分配；
  3. 「工具」页可查看每个工具的说明并试运行；租户管理员可按工具维度启用/停用，停用后语音助手不再上报该工具。
三、技能库（管理员）
  1. 技能 = 给语音助手的操作指令包。平时只上报一句话简介，被调用时才加载完整指令，节省语音助手的上下文；
  2. 平台超管可在「技能库」在线编写（SKILL.md 格式）或上传 zip 压缩包；
  3. zip 上传的技能默认停用待审核，审核通过后自动上架为工具；
  4. 每次保存自动记录版本（保留最近 20 版），可在版本历史中一键回滚。
四、成员与权限（管理员）
  1. 「成员管理」页创建成员账号；成员可查看应用与工具、试运行、查看日志，但不能修改租户配置；
  2. 「工具权限」矩阵可精细控制每个成员能试运行哪些工具（仅约束控制台调用，语音调用不受限）；
  3. 成员账号忘记密码由租户管理员在成员页重置；租户管理员自己的密码通过登录页「忘记密码」邮件找回，请务必在设置页绑定邮箱。
五、账号安全
  1. 建议在「设置」页开启两步验证（2FA）：用 Google Authenticator 等验证器扫码绑定，登录时需输入 6 位动态码；
  2. 绑定邮箱后可自助找回密码，也会收到配额用尽等告警通知；
  3. 「设置」页可随时导出本租户全部数据（JSON 格式）。
六、配额与计费
  1. 按租户每日工具调用量计：免费版 100 次/天、标准版 1000 次/天、专业版不限量；
  2. 每分钟内调用频次也有上限（默认 60 次/分钟/租户），超频请稍后重试；
  3. 每次调用的来源（语音/控制台）、参数与结果都可在「调用审计」中追溯，审计数据保留 30 天。

常见问题（FAQ）

小智AI能接多个 MCP 服务吗？

可以。小智智能体默认只认一个 MCP 接入点，但你可以通过 MCP Gateway 把计算器、日历、高德地图、自有业务等多个 MCP 服务聚合到一个端点，小智只接入网关即可调用全部工具。

MCP Gateway 是什么？

一个面向小智AI的多租户 MCP 工具聚合网关 SaaS：提供应用市场、技能渐进披露、多租户隔离、调用审计与套餐配额管理。

接入 MCP Gateway 需要写代码吗？

不需要。MCP Gateway 会为你的租户生成一个 MCP 接入点（wss 地址），把它填到小智服务端的 mcp_endpoint 配置即可完成接入；应用由平台管理员从模板一键安装，对音箱说话即可调用工具。

MCP Gateway 收费吗？

有免费版，每日 100 次工具调用；标准版每日 1000 次；专业版不限量。按租户每日调用量计费。