从工具名称、JSON Schema、只读结果和错误返回四部分定义第一个 MCP 工具，避免让模型猜参数。
这篇要解决什么
搜索这个问题的读者通常正在尝试：为智能体提供一个只读状态查询工具，并让调用方能验证参数和返回值。。先在测试环境用只读或模拟数据完成链路，再考虑接入真实业务。
按步骤完成
- 把工具缩小为单一任务，例如按工单号查询状态；名称要表达动作，不能用含糊的 run 或 process。
- 给每个必填参数写类型、枚举或格式约束，服务器在业务查询前校验输入。
- 返回可机器读取的状态、来源和错误说明；结果内容与业务成功分开记录。
用一条固定消息检查链路
以下只是协议层示例，展示要记录的字段，不代表已经连到你的服务器：
{"name":"lookup_ticket","inputSchema":{"required":["ticket_id"]}}把其中的工具名、参数和允许范围替换成自己的清单。不要把密钥、客户资料、订单号或生产地址写进演示文件。
怎样验收结果
用一个合格工单号、一个缺少参数请求和一个不存在编号分别调用。只有第一种返回可用结果；另外两种必须保留可解释的错误，不得伪装成空成功。
失败边界
示例只讨论只读工具契约，不连接订单、库存或客户数据。写工具需要另行定义权限、确认和业务幂等规则。
依据与核验日期
以上官方资料于 2026-10-01 核对。协议、SDK 和客户端界面会更新；实施前应再次阅读对应版本的官方说明。
相关问答
工具返回成功就能说明业务完成吗？
不能。工具返回只说明该调用得到响应；涉及写入时还要核对业务系统的最终状态、权限和审计记录。
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/32562.html
