纳米AI MCP怎么配合智能体

MCP工具需完成服务端注册、智能体启用及调用验证三步才能被真正调用：先在万能工具箱添加并确认Server在线；再在智能体能力设置中开启MCP调用开关；最后通过自然语言或流程节点触发，并通过调试面板日志确认调用成功与响应解析。

在纳米AI中让MCP工具真正被智能体调用起来，不是配置完工具就自动生效的，必须完成客户端与服务端的双向绑定和上下文注入。

确认MCP服务已接入纳米AI万能工具箱

打开纳米AI应用→进入「智能体」页面→点击右上角「万能工具箱」入口→检查工具列表是否显示“已连接”状态。若显示“未连接”或灰显，说明MCP Server尚未注册成功，

。

点击“+添加工具”，选择“手动配置”，填入MCP Server地址（如http://localhost:3000/mcp）、名称、描述，保存后等待状态变为绿色“在线”。这一步验证的是底层通信链路是否打通。

为智能体启用MCP工具调用能力

进入目标智能体编辑页→找到「能力设置」或「插件管理」区域→勾选「允许调用MCP工具」开关。该开关默认关闭，不开启则智能体完全看不到工具列表。

纳米AI会自动扫描万能工具箱中所有已连接的MCP Server，并将其转化为结构化工具描述（name、description、parameters），注入到智能体的系统提示词中。这一步决定了大模型能否“知道有这个工具可用”。

在智能体工作流中触发MCP调用

方法一：通过自然语言指令直接触发
在智能体对话框里直接输入“查一下我上周的微信账单”，前提是工具箱中已经接入支持微信数据查询的MCP Server，而且它的tool name字段里包含“wechat”或“账单”等关键词。纳米AI会自动完成意图解析、工具匹配、参数构造，再发起MCP call。

方法二：在自定义任务流程中硬编码调用
进入「案例广场」→复制一个含MCP节点的模板→编辑流程图→拖入「MCP工具调用」节点→从下拉菜单中选择已注册的工具→填写必填参数（如date_range: "last_week"）→连接至后续处理节点。这种方式绕过LLM解析，调用更稳定，但灵活性降低。

注意：若调用返回空结果或报错，优先检查MCP Server日志，而非调整智能体提示词——问题90%出在Server端权限、认证或输入校验上。

验证调用是否真实生效

第一步：在纳米AI右下角点击「调试面板」图标，开启「工具调用日志」；
第二步：向智能体发送一条能明确触发工具的指令，比如“生成一份PDF格式的会议纪要”；
第三步：留意日志里有没有出现类似{"mcp_call":"pdf_generator","status":"success","response_size":2456}这样的记录。要是根本没有这条记录，说明调用压根没发出去；如果有记录但status显示error，那就得进一步查看response字段里的具体错误码。

成功日志出现后，再检查智能体最终回复里是否包含了工具返回的实际内容（比如PDF文件下载链接或文本摘要）。如果只有“正在处理中”之类模糊反馈，说明智能体未正确解析MCP响应体，需检查工具定义中的output_schema是否与实际返回JSON结构一致。