纳米AI MCP配置是将客户端与Pixso、优麦云等MCP Server建立安全连接，使其能实时读取设计规范或店铺数据；需确认协议版本为MCP 2026-07-28、正确粘贴含认证信息的JSON配置、验证连接并重启客户端生效。

纳米AI MCP配置是指将纳米AI客户端与支持MCP协议的外部工具服务器（如Pixso、优麦云等）建立安全连接，使其能实时读取设计规范、店铺数据或动态资源。配置失败会导致AI无法识别工具列表、调用时返回“能力不可用”或静默失败，且错误日志中不提示具体缺失项。

确认纳米AI客户端支持MCP协议版本

打开纳米AI桌面端，进入「设置 → 高级 → 协议支持」，检查是否显示“MCP 2026-07-28（无状态核心）”已启用。若仅显示“MCP v1.x”或未勾选，需升级至v2.3.0及以上版本——旧版不兼容当前主流Server的Streamable HTTP传输方式，强行配置会卡在初始化握手阶段。

这一步操作起来很简单，直接把文件拖进去就行。

获取目标MCP Server的接入信息

不同服务提供方暴露的接入参数不同，必须按实际来源获取：

方法一：Pixso智能设计插件 → 安装后登录账号，在插件设置页点击「复制MCP配置」，得到含url和token的JSON片段；

方法二：优麦云ERP → 登录卖家后台 →「AI集成中心」→「MCP密钥管理」→ 点击生成新密钥，复制server_url与api_key；

方法三：自建MCP Server（如FastMCP）→ 查看config.yaml中server_url字段，确保dynamic_throttling: true已开启，否则高并发下易触发429响应。

【注意：优麦云密钥有效期默认为30天，且每个密钥仅限绑定1个纳米AI客户端IP】

在纳米AI中添加并启用MCP Server

第一步：进入「设置 → MCP管理 → 添加服务器」；

第二步：粘贴上一步获取的完整JSON配置（非纯URL），例如：{"url":"https://mcp.pixso.io/v1","headers":{"Authorization":"Bearer abc123"}}；

第三步：点击「验证连接」——此时纳米AI会向目标Server发送一个list_tools探针请求；

第四步：若状态显示“已就绪”，点击「启用」；若显示“连接超时”，检查本地防火墙是否放行 outbound HTTPS 请求，或确认Server是否监听在公网可访问地址；

第五步：重启纳米AI客户端，使配置生效。不重启会导致Client缓存旧的空能力列表，即使Server已上线也无法识别新工具。

验证MCP能力是否真实可用

新建对话窗口，输入：“列出你当前可用的所有工具”。纳米AI应返回结构化清单，包含工具名、描述、参数字段（如project_id: string）；

若返回“我没有可用工具”或仅返回内置功能（如“搜索网页”），说明Server注册失败——大概率是JSON格式非法（多逗号、缺引号）或headers中未正确携带认证凭证；

若返回工具列表但调用时报错“resource not found”，需检查Server端是否已注册对应URI路径，例如Pixso要求/resources/design-system/colors必须存在且返回200。