理解 MCP 概念以后下一步就是把真实系统接进去。比如公司工单系统 内部 CRM 订单后台 部署平台 知识库 自建搜索服务这一讲我们用一个通用方法讲清楚如何把外部系统包装成 MCP Tool。先说结论先设计边界再写工具不要一上来就写call_api()。先回答这个 MCP Server 暴露给谁 哪些操作是读 哪些操作有副作用 需要哪些认证 哪些数据不能返回给模型 哪些动作需要人工确认MCP Tool 的难点不在“HTTP 请求怎么发”而在“把外部系统的能力切成安全、清晰、可调用的接口”。第一步选一个窄场景不要把整个外部系统一次性接进来。先选一个窄场景查询今天待处理工单 根据订单号查状态 创建一条低风险内部备注 读取某个知识库页面 生成发布候选清单窄场景更容易定义输入、输出、权限和测试。第二步把能力拆成 Tool / Resource / Prompt同一个系统可能需要三种 MCP primitive。以工单系统为例Tool ticket.search ticket.add_comment ticket.update_status Resource ticket://schema ticket://queue/today Prompt ticket_triage incident_summary不是所有东西都应该做成 Tool。静态背景和 schema 更适合 Resource固定分析模板更适合 Prompt会产生动作的才是 Tool。第三步设计 Tool schemaTool schema 要让模型知道工具做什么 参数有哪些 哪些字段必填 字段格式是什么 返回什么 失败时是什么样坏 schemado_ticket_action(action, data)好 schematicket_search({ query: string, status?: open | closed | pending, limit?: number })越具体模型越不容易误用。第四步实现认证和最小权限外部系统通常需要 token、OAuth 或服务账号。原则不要把密钥返回给模型 不要在日志里打印密钥 给 MCP server 最小权限 token 读写权限分开 生产动作加确认如果是 stdio server日志写 stderr不要写 stdout避免破坏 JSON-RPC。第五步错误要结构化不要只返回failed更好的错误{ ok: false, code: TICKET_NOT_FOUND, message: No ticket matched the given id., retryable: false }这样 Agent 才能判断是参数错 是权限错 是临时失败 要不要重试 要不要问用户第六步接入 OpenClawOpenClaw 可以管理 outbound MCP server definitions也可以通过openclaw mcp serve作为 MCP server 暴露 OpenClaw 会话。在“把外部系统接成工具”这个方向你通常是在写一个外部 MCP server再让 OpenClaw runtime 消费它。接入后要验证server 是否能启动 tools/list 是否能看到工具 tools/call 是否能返回结果 错误是否清晰 权限是否生效 长任务是否不会卡死一个真实场景把内部订单系统接成 MCPTools: order.lookup order.refund_status order.add_internal_note Resources: order://schema order://refund-policy Prompts: refund_risk_review其中lookup 是读操作 refund_status 是读操作 add_internal_note 有副作用但风险较低 真正退款不能直接做成无确认工具这就是“能力切分”。常见误解误解一把所有 API 都暴露成 Tool不要。只暴露 Agent 真正需要、边界清楚的能力。误解二Tool 名越短越好不一定。具体、唯一、表达意图更重要。误解三MCP server 可以直接信任模型输入不行。参数仍要校验权限仍要检查。误解四错误自然语言返回就够了不够。结构化错误更利于恢复和重试。最后总结把外部系统接成 MCP 工具本质是接口设计。一句话总结先缩小场景再拆 Tool / Resource / Prompt然后用清晰 schema、最小权限和结构化错误把系统接进 Agent。本节作业选一个外部系统列出三个适合暴露的能力。判断这些能力分别应该是 Tool、Resource 还是 Prompt。为一个 Tool 写出输入 schema。写出一个结构化错误返回格式。下一节预告下一节讲 Plugin 基础把 Skill、MCP 和前端能力打包。参考资料MCP DocsBuild an MCP serverMCP DocsArchitecture overviewMCP SpecToolsMCP SpecTransportsOpenClaw DocsMCP CLI原文链接把一个外部系统接成 MCP 工具 | Harries Blog™