12 · MCP：连接外部工具

📚 系列导航：上一篇 11 权限与安全红线 讲的是怎么防。这一篇换个方向——给 Claude 接上外部世界：数据库、Jira、Figma，一个统一对接口搞定。

---

01 MCP 是什么

Claude Code 默认只能摸你本地的文件和命令。MCP（Model Context Protocol）就是那个统一外接口——接一次，一堆外部服务的工具就摆到了它面前。

TIP

判断标准：当你发现自己从另一个工具复制数据到聊天中时，就该连接一个 MCP server 了。

---

02 两种 server 形态

形态	跑在哪	怎么加	适合
stdio（本地进程）	你机器上，作为子进程启动	claude mcp add <name> -- <command>	本地浏览器、本地数据库套接字
HTTP（远程托管）	某个网址上	claude mcp add --transport http <name> <url>	云服务（Sentry、Notion、GitHub），官方推荐

WARNING

SSE 已弃用，见到就换 HTTP。

---

03 加 server 的命令

远程 HTTP server：

claude mcp add --transport http notion https://mcp.notion.com/mcp

本地 stdio server：

claude mcp add airtable -- npx -y airtable-mcp-server

WARNING

所有选项（--transport、--scope、--env）必须在 server 名字之前。 -- 之后的全是传给 server 的。位置错了就不认。

三种作用域

作用域	在哪些项目加载	存哪
local（默认）	仅当前项目	~/.claude.json
project	仅当前项目，进 git 全队共享	项目根 .mcp.json
user	你的所有项目	~/.claude.json

# 跨所有项目都能用
claude mcp add --scope user --transport http sentry https://mcp.sentry.dev/mcp
# 跟全队共享
claude mcp add --scope project --transport http github https://api.githubcopilot.com/mcp/

直接写 .mcp.json

{
  "mcpServers": {
    "claude-code-docs": {
      "type": "http",
      "url": "https://code.claude.com/docs/mcp"
    },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    }
  }
}

NOTE

改完 .mcp.json 要退出再重启会话才生效。项目 .mcp.json 的 server 首次加载要你批准。

---

04 安全：接 server 的三条规矩

1. 优先用官方目录和大厂官方 server：Anthropic 不替第三方 server 做安全审计
2. 抓外部内容的 server 当心提示注入：网页/工单里可能藏恶意指令
3. 给数据库只用只读账号：能用只读就别给写

---

05 动手：接上官方文档 server

claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp

预期：打印 Added 确认。

claude mcp list

预期：claude-code-docs 旁边标 ✓ Connected。

claude

用 claude-code-docs server 查一下 MCP_TIMEOUT 这个环境变量是干什么的

预期：第一次调用会问你要不要批准。批准后返回说明，工具调用旁标着 claude-code-docs。

练完拆掉：

claude mcp remove claude-code-docs

---

06 小结

环节	关键动作
加 server	HTTP 给网址，stdio 给命令，开关放名字前
作用域	个人实验 local、跨项目 user、全队共享 project
安全	优先官方目录，数据库只读，抓外部内容的当心
清理	不用的及时 remove，省上下文窗口

NOTE

下一篇：13 Subagent 与多 Agent 协作：进阶篇——派分身干脏活，让主会话保持清爽。