给 Agent 装插件实战：MCP 配置全流程与常用清单

MCP 的接入方式高度统一：在工具的配置文件里声明 Server 的启动命令，Agent 启动时把它们拉起来，工具列表里就多了对应的能力。本文以最通用的 JSON 配置为例走一遍。

配置结构逐行讲

一个典型的 mcpServers 配置长这样：

{"mcpServers": {"filesystem": {"command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "D:/work"], "env": {}}}}

• filesystem：你给这个 Server 起的名字，随意但要可辨识
• command + args：怎么把它启动起来（npx / uvx / 本地可执行文件），args 里最后一个是它可访问的目录——只给必要目录，别把整个硬盘授权出去
• env：需要 API Key 的 Server（如搜索、数据库）在这里注入，别写进任何会公开的文件

常用 Server 清单（按场景）

• 文件与代码：filesystem（读写指定目录）、GitHub（仓库与 Issue 操作）——编程型 Agent 的左膀右臂
• 联网：浏览器类 Server（打开网页、点击、填表）、搜索类 Server（给 Agent 一双眼睛）
• 数据：SQLite / Postgres 查询、表格处理——做数据分析类 Agent 的基础件
• 效率：时间日期、计算器、单位换算这类小工具不起眼，但能显著减少模型「一本正经算错」

安装四步

• 确认你的 Agent 工具支持 MCP，并找到它的配置文件位置（设置页一般有入口）
• 先只加一个 filesystem 练手：粘贴配置、重启工具、在对话里让它列一下授权目录的文件
• 能列出来 = 全线通；再逐个加其他 Server，每次只加一个，出问题好定位
• 加完在工具的「工具列表」里逐个核对开关，不用的能力随手关掉，减少误触发

排错顺序

• Server 起不来：多半是本机缺运行环境（Node / Python），先在终端单独跑一遍 command 看报错
• 工具不出现：配置 JSON 格式错一位全灭，先用校验工具过一遍，再重启工具（多数工具不热加载）
• 能列不能用：权限或路径问题，Windows 路径用正斜杠或双反斜杠，别用单反斜杠
• 安全兜底：给涉及写操作与执行的 Server 单独建测试目录验证，确认行为符合预期再放进生产目录

下一篇预告：Skill 技能包实战——把一套「周报撰写流程」做成可复用的 Skill。