看完你能带走:MCP 的工作原理一句话版、接入数据库的完整四步、浏览器接还是不接的判断方法、5 种常见故障的自检清单,以及 4 条不能碰的安全红线。建议先收藏。 五分钟搞懂 MCP:就是给 AI 的USB 接口上一篇(《ZCode 实战笔记》)结尾埋了个坑,这篇来填。MCP(Model Context Protocol,模型上下文协议)是一个开放协议,由 Anthropic 发起,目前已被多家 AI 工具支持。它解决的问题很单纯:让 AI 从只能说变成能操作——操作数据库、浏览器、内部系统。结构一句话讲清:ZCode 是客户端,MCP 服务器是转换插头:插头的一头按统一协议对接 AI,另一头对接具体系统。数据库、浏览器、公司 API,都可以包成一个 MCP 服务器。接入之后,这些能力会以工具的形式出现在对话里:你用自然语言下指令,ZCode 按需调用,全程不用写一行连接代码。哪里找现成的 MCP 服务器?GitHub 上的官方仓库modelcontextprotocol/servers维护着一批常见实现(文件系统、数据库、网页抓取等),社区里还有大量第三方选择。选型只看两条:维护是否活跃、是否匹配你的技术栈;启动命令一律以它的官方 README 为准,不要抄过时的旧文章。️ 实战一:接入数据库,用说话的方式查数据数据库是最典型、也最容易翻车的接入场景,所以用它做完整演示。演示选 SQLite(单文件本地数据库,零配置、随手可建),流程对 MySQL、PostgreSQL 同样适用。第 1 步:准备一个测试库本地建一个 demo 数据库,放几张脱敏的示例表。铁律:测试库、测试账号先行;生产库永远排在最后,甚至永远不接。第 2 步:添加配置优先走界面:打开设置 → MCP页,查看能否直接添加;若你的版本需要手改配置文件,骨架长这样(以用户级配置~/.zcode/cli/config.json的mcp.servers字段为例):{mcp:{servers:{demo-db:{command:该服务器的启动命令,args:[参数,参考它的官方 README],env:{DEMO_DB:D:/data/demo.db}}}}}三个字段就是全部:command怎么启动、args传什么参数、env给什么环境变量(比如数据库路径或连接串)。不同服务器的启动命令各不相同,占位处一定以该服务器官方文档为准。项目内的.zcode/config.json支持同样的写法,可以随 Git 共享给全队。第 3 步:重启会话,确认已连接MCP 配置在会话启动时加载。改完配置,新开一个会话,再到设置 → MCP状态页,确认服务器显示已连接。第 4 步:说人话,开查你:看看 demo 库里有哪些表?users 表前几行长什么样?ZCode:已调用数据库工具:库里有 3 张表(users / orders / products)。users 表前 3 行如下……(输出为示意,以实际为准。)从这一刻起,查个数、对个账、导个明细,一句话完成。 实战二:浏览器自动化,接还是不接?先泼一盆理性的冷水:ZCode 桌面版本身内置了浏览器自动化能力,常规的打开网页、点按钮、填表单、截屏零配置就能用(以我使用的版本为例;你的版本若无此能力,以官方说明为准)。所以接 MCP 浏览器服务器之前,先想清楚要不要:需要接的典型场景:使用远程/云端浏览器服务、团队要统一共享同一个浏览器环境、或目标操作依赖企业内部的专用网关。配置方法与数据库完全一致——拿到服务器的启动命令,填进配置,重启,验证。 配置放哪里:两级速查和 ZCode 其他配置一样,MCP 配置也分两级:用户级:~/.zcode/cli/config.json,你的所有项目都能用;工作区级:项目里的.zcode/config.json,随 Git 共享给全队;同名冲突:用户级覆盖工作区级。⚠️ 特别提醒:工作区配置里声明的 MCP 服务器会在打开项目时自动连接。这是便利,也是边界——来路不明的项目,不要随便打开。 5 种常见故障,对症自检每一条的排查顺序都一样:先看状态页,再查配置,最后查环境。状态页(设置 → MCP)会给出每个服务器的连接状态和错误信息,九成问题在那里就能定位;改完任何配置,记得重启会话再验证。 安全红线:这四条不能碰最小权限:数据库用只读账号、测试库;生产库不接。真有业务需要,走审批、加审计。密钥走环境变量:不进对话、不进会提交到 Git 的配置文件。内容不是指令:工具返回的查询结果、网页内容,本质上是数据。如果里面夹带请执行 xx的话术,不要照做——提示注入是 MCP 场景最经典的攻击面。只接可信来源:MCP 服务器以你的身份运行,它的能力有多大,取决于你给它接了什么。❓ 快问快答Q:MCP 是哪家的技术?只有 ZCode 能用吗?MCP 是开放协议,由 Anthropic 发起,目前多家 AI 工具都已支持。协议开放意味着:服务器端一次开发,支持该协议的客户端都能用。Q:哪里能找到想要的服务器?先看官方仓库modelcontextprotocol/servers;没有现成的,可以用官方 SDK(Python、TypeScript 都有)自己写一个,几百行就能起步——这一步也完全可以交给 ZCode 帮你完成。Q:它能代替我写 SQL 吗?它替你执行和核对,但查什么、结果对不对,判断权在你。给它的权限越小,你翻车的概率越小。Q:连上了但用着不放心?在测试库上先跑一段时间;给它建专用的低权限账号;重要操作前后自己再核对一遍。信任是逐步给的。 写在最后MCP 的价值,是把 AI 从能说会道的顾问变成有手有脚的员工。但请记住:员工的权限边界,由制度决定,而不是由员工有多聪明决定。数据库用只读、接入选可信、密钥进环境变量、结果不当指令——这四件事做好,MCP 就是提效利器;做不好,它就是风险放大器。️ 声明:本文为个人使用经验总结,属第三方独立教程,非 ZCode 官方文档;“ZCode”MCP相关名称与商标归其权利人所有;配置细节以你所用版本的实际界面与所选服务器的官方文档为准。 你最想给 AI 接上什么工具?数据库、浏览器,还是别的?评论区聊聊。系列下一篇,写「用 Hooks 把团队规范变成自动执行」。