工具不触发的根本原因是MCP Server未注册成功或智能体未启用MCP调用能力。需先确保Server在线并手动配置地址，再勾选「允许调用MCP工具」开关，最后通过关键词匹配或流程节点调用验证，调试面板可确认调用是否发出。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
纳米AI给智能体添加工具后，界面显示已接入、开关已开启，但实际对话中完全不触发调用——这不是配置遗漏，而是客户端与服务端未完成双向绑定或上下文未注入导致的静默失效。
确认MCP Server是否真正在线
打开纳米AI应用→进入「智能体」页面→点击右上角「万能工具箱」入口→检查目标工具卡片右下角状态。若显示“未连接”“灰显”或“正在重连”，说明MCP Server未注册成功。【必须先完成Server注册,否则后续所有调用都会失败】
点击“+添加工具”→选择“手动配置”→填入MCP Server地址（如http://localhost:3000/mcp）、名称、描述→保存后等待状态变为绿色“在线”。这一步验证的是底层HTTP通信链路是否打通，不是看工具是否出现在列表里。
为智能体启用MCP调用能力
进入目标智能体编辑页→找到「能力设置」区域→勾选「允许调用MCP工具」开关。该开关默认关闭，不开启则智能体在推理时根本看不到任何工具描述。
纳米AI会自动扫描万能工具箱中所有已连接的MCP Server，并将其转化为结构化工具定义（name、description、parameters），注入到智能体的系统提示词中。这一步决定了大模型能否“知道有这个工具可用”，而不是“能不能用”。
验证工具是否被正确识别并匹配
方法一：自然语言触发需满足关键词匹配
在对话框中输入指令时，必须包含工具定义中name或description字段里的核心词。例如工具name为“wechat_bill_fetcher”，description含“微信账单查询”，则输入“查我上周微信账单”可触发；若只说“查账单”，因缺少“微信”这一关键锚点，匹配失败。
纳米AI是一款基于人工智能大模型技术开发的智能应用工具，主要用于提供AI问答、内容生成、信息整理与智能搜索辅助等功能。用户可通过自然语言交互方式获取结构化信息与文本内容，用于学习、办公及内容创作等多种场景。
方法二：流程节点调用需硬编码参数
进入「案例广场」→复制含MCP节点的模板→编辑流程图→拖入「MCP工具调用」节点→从下拉菜单中选择已注册工具→手动填写必填参数（如date_range: "last_week"）→连接至后续节点。这种方式绕过LLM意图解析，调用更稳定，但要求参数格式与Server端严格一致。
注意：若调用返回空结果或报错，优先检查MCP Server日志，而非调整智能体提示词——问题90%出在Server端权限、认证或输入校验上。
调试面板中确认调用是否真实发出
第一步：在纳米AI右下角点击「调试面板」图标→开启「工具调用日志」；
第二步：向智能体发送一条明确触发工具的指令（如“用log_search工具查service=auth-service、level=WARN、最近10分钟的日志”）；
第三步：观察调试面板中是否出现MCP call发起记录、请求URL、参数快照及响应状态码。若日志为空白，则说明调用未发出，问题仍在前三个阶段；若出现401/403/500等错误码，则问题在Server端配置。
