Claude Code 加 MCP server 的两种方式
Claude Code 有两条路接入 MCP server。最快的是命令行：`claude mcp add <名字> -- npx -y <包名>`，它会自动注册并写好配置。
第二种是直接改配置文件——当你需要精细控制环境变量、参数，或接一个远程 HTTP server 时用它。两者最终写到同一个地方，命令行只是个便捷封装。
无论用哪种，心智模型一样：你在告诉 Claude Code「用什么命令启动这个 server」（本地 stdio）或者「去哪个 URL 连它」（远程）。
配置文件：长什么样、放哪里
MCP 配置的核心是一段 JSON，放在 `mcpServers` 键下。每个 server 有一个名字、一个 `command`（如 `npx`）、一个 `args` 数组（包名和参数）。
一个最简本地 server 长这样：`{ "mcpServers": { "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/projects"] } } }`。最后那个参数是允许它访问的目录。
改完配置文件后重启 Claude Code，它会重新读配置、把 server 作为子进程拉起来。
传密钥：用环境变量，别写明文
大多数有用的 server 都要凭据——GitHub token、数据库连接串、API key。这些要通过 server 配置块里的 `env` 对象传，别硬塞进 args，否则会泄进日志和命令历史。
例如 GitHub server 用 `"env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..." }`。token 按最小权限配——只读的活就给只读 token。
如果是团队共享的 server，别把 token 提交进配置，改从你的 shell 环境注入。
确认 server 真的连上了
重启后最快的检查：直接问 Claude「你现在有哪些 MCP 工具？」连上了的话，它的工具会出现在列表里。
如果没出现，说明 server 没起来。最常见两个原因：包名写错（args 里有 typo）、缺运行时（server 要 Node 或 Python，你机器上没有）。
在终端手动跑一遍 server 的启动命令——比如 `npx -y <包名>`——就能看到真正的报错，这个错 Claude Code 平时是吞掉不显示的。
大家最常踩的坑
刚启动就「Server disconnected」：通常是缺了某个必需的环境变量。查 server 的 README 看它要哪些 env。
工具出现了但每次调用都失败：几乎都是凭据/权限问题——token 过期，或权限范围太窄够不着这个动作。
在别的客户端能用、Claude Code 却不行：不同客户端从不同文件读配置。确认你改的是 Claude Code 的配置，不是 Claude Desktop 的。
一旦连上、测试调用能返回真实数据，就搞定了——server 现在是 Claude 上下文的一部分，你可以用大白话直接使唤它。