小智MCP
首页
指南
使用文档
套餐
登录控制台
小智AI MCP 教程与指南
从接入、场景到原理 —— 用最少篇幅讲清小智AI 怎么用 MCP 工具。
小智AI 接入教程
从零接入小智AI 到具体工具场景
小智AI接入 MCP:从零配置教程
手把手教程:小智AI 如何接入 MCP 工具。从了解小智 MCP 接入点(wss)格式、在控制台创建智能体,到通过 MCP Gateway 一个端点装下计算器、日历、高德地图等多个 MCP 服务,再到对音箱说出第一句指令,全程无需写代码,附完整配置截图与常见报错排查,适配小智 ESP32 与官方控制台。
小智AI接高德地图 MCP:从部署到导航生效
小智AI 接高德地图 MCP 完整教程:按 xiaozhi 官方 mcp-endpoint-server 架构,从 Docker 部署接入点、申请高德 API Key、挂载高德 MCP Server 到对小智说「导航去机场」全部生效,含排障,并说明 401 未授权、请求超时与工具不触发的定位思路。
小智AI查天气 MCP:复用高德 maps_weather
小智AI 查天气教程:复用高德 MCP 的 maps_weather 工具,无需再单独接入一个天气服务。讲清天气 MCP Server 怎么选、接入点与 API Key 怎么配、说什么话才会触发工具、返回结果怎么读,并附上工具不生效、查不到城市、地区名错误的逐步排查方法,支持城市名与经纬度两种查询。
小智AI接智能家居:HomeAssistant 控制全家
小智AI 怎么控制家里的灯、空调、电视?用 ha-mcp-for-xiaozhi 让 HomeAssistant 充当 MCP server 直连小智,经 HACS 安装、填入接入点地址并勾选实体即可语音控制全家设备,含多设备冲突处理、实体权限收窄、网络与鉴权异常的常见故障排查,适合初次接入智能家居的用户。
概念与架构
把 MCP 的原理和网关架构讲透
MCP 与 Function Calling 的区别
MCP(Model Context Protocol)与大模型 Function Calling 有什么区别?两者如何配合?为什么像小智这样的语音助手更适合通过 MCP 网关统一管理工具与上下文?从协议定位、调用链路、复用性、鉴权与维护成本逐项对比讲清,并给出不同场景下的选型建议,适合架构选型前通读。
小智 MCP 生态盘点:能接哪些工具
小智AI MCP 生态全景盘点:xiaozhi-esp32 设备端、多语言服务端、xiaozhi-mcphub 桥接、ha-mcp-for-xiaozhi 智能家居、mcp-calculator 工具扩展,一篇看全小智 MCP 能接什么、怎么选,附选型建议与维护成本对比,适合想扩展小智能力的开发者。
多 MCP 服务聚合到一个端点的网关架构
多个 MCP Server 如何聚合成一个接入点?网关如何做工具路由、鉴权、租户隔离、调用审计与配额限流?渐进披露如何按需加载技能、帮语音助手节省上下文?本文从架构分层、数据模型到落地实践系统讲透 MCP 聚合网关设计,附小智接入示例与高并发场景下的路由缓存、故障降级策略,兼顾安全性与可运维性。
使用文档:控制台操作手册
MCP Gateway 使用文档:从注册账号、复制小智 MCP 接入点、粘贴到小智服务端 mcp_endpoint 配置,到对音箱说出第一句话的完整配置教程,含应用市场一键分配、技能库与渐进披露、成员权限与角色、调用审计日志、套餐配额限制及常见接入问题说明,支持 API 与 Webhook 接入便于二次开发。