快速入门指南将会向你展示最快速的安装、配置、启动方式。 完成本指南后，你将拥有一个可以自由集成不同 MCP 的服务，允许你可有控制提供给小智的 MCP 工具。
前期准备: 在开始之前，你至少需要有一个小智硬件设备，并已添加至小智官方服务端。

​
环境准备

请先安装好 node 与 pnpm。
如果你已经准备好 node & pnpm 可以跳过此步骤
1

安装Node

请前往 Node官方安装地址 进行安装，并验证安装是否成功。以下为 node:22(LTS) + pnpm 的安装方式
# 下载并安装 nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# 重启shell
\. "$HOME/.nvm/nvm.sh"

# 下载并安装 Node.js:
nvm install 22

# 验证 Node.js 版本:
node -v # 应该打印出 "v22.19.0".

# 下载并安装 pnpm:
corepack enable pnpm

# 验证 pnpm 版本:
pnpm -v
2

安装 xiaozhi-client 命令行工具

pnpm install -g xiaozhi-client
3

创建应用

# 创建应用
xiaozhi create my-app

# 进入应用目录
cd my-app

# 安装依赖
pnpm install
4

设置小智接入点

小智AI配置MCP接入点的 使用说明
xiaozhi config set mcpEndpoint "<从小智服务端获取到的接入点地址>"
5

启动服务

xiaozhi start
6

验证是否成功

最后，请前往小智服务端，检查对应的接入点，刷新后是否能获取到工具列表