Appearance
Claude Code MCP教程：从代码助手到全链路协作伙伴
如果说 Claude Code 是优秀的打字员和测试员，加上 MCP 则让它真正拥有外部感官和手脚——能连接外部世界的资源与工具，成为全链路开发协作伙伴。
一、什么是 MCP？
MCP = Model Context Protocol，Anthropic 推出的标准化协议。
核心逻辑：不要让 AI 去逐一学习所有工具的使用规则，而是让所有工具都提供统一接口给 AI。
就像现实中的通用插座——插座统一标准，所有电器都能直接使用。
二、为什么 Claude Code 需要 MCP？
| 场景 | 无 MCP | 有 MCP |
|---|---|---|
| 跨仓库分析 | 只能分析当前文件夹 | 跨仓库协作，关联其他仓库 |
| 需求同步 | 手动复制粘贴文档 | 实时同步 Slack/JIRA 讨论 |
| 数据库验证 | 手动查表结构 | 直接联动 MySQL 查询 |
| 自动化流程 | 生成代码片段供手动复制 | 自动执行 Puppeteer 脚本 |
MCP 让 Claude Code 从被动接收信息的助手，变成主动获取信息、执行操作的协作伙伴。
三、基本使用方式
核心命令：claude mcp
| 子命令 | 作用 |
|---|---|
claude mcp add | 添加 MCP 服务器 |
claude mcp list | 查看所有已配置服务器 |
claude mcp get | 查看某个服务器详情 |
claude mcp remove | 删除服务器 |
/mcp | 在 Claude Code 中查看状态/认证 |
四、三种接入方式
1. 远程 HTTP 服务器（推荐）
适用于云服务类工具，最通用的方式：
bash
# 基础语法
claude mcp add --transport http <服务器名称> <服务器URL>
# 示例：连接 Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp
# 带身份验证
claude mcp add --transport http secure-api https://api.example.com/mcp \
--header "Authorization: Bearer 你的令牌"2. 远程 SSE 服务器（已弃用）
仅兼容旧版工具，优先用 HTTP 替代：
bash
claude mcp add --transport sse asana https://mcp.asana.com/sse3. 本地 stdio 服务器
适用于本地系统访问（数据库、自定义脚本）：
bash
# 基础语法（注意参数顺序）
claude mcp add --transport stdio [--env 环境变量] <服务器名称> -- <启动命令>
# 示例：连接 Airtable
claude mcp add --transport stdio --env AIRTABLE_API_KEY=你的密钥 airtable \
-- npx -y airtable-mcp-server关键注意：
--transport/--env等参数必须放在服务器名称前面--用于分隔 Claude 参数和服务器命令
五、配置范围
| 范围 | 用途 | 命令示例 |
|---|---|---|
| local（默认） | 仅当前项目可用，私密配置 | claude mcp add --scope local ... |
| project | 团队共享（存储在 .mcp.json） | claude mcp add --scope project ... |
| user | 所有项目可用，个人全局 | claude mcp add --scope user ... |
优先级：local > project > user
六、实用示例
示例 1：GitHub 代码审查
bash
claude mcp add --transport http github https://api.githubcopilot.com/mcp/> Review PR #456 and suggest improvements
> Show me all open PRs assigned to me示例 2：Sentry 生产环境排错
bash
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp> /mcp # 完成 OAuth 登录
> What are the most common errors in the last 24 hours?示例 3：直接查 PostgreSQL
bash
claude mcp add --transport stdio db \
-- npx -y @bytebase/dbhub \
--dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"> Show me the schema for the orders table
> Which users haven't purchased in 90 days?七、高级使用方式
1. 使用 @ 引用 MCP 资源
> Analyze @github:issue://123 and suggest a fix
> Compare @postgres:schema://users with @docs:file://user-model2. MCP Prompt 作为斜杠命令
/mcp__github__list_prs
/mcp__jira__create_issue "Login bug" high八、关键注意事项
| 注意点 | 说明 |
|---|---|
| 身份验证 | 远程 MCP 需执行 /mcp 完成 OAuth 2.0 授权 |
| Windows兼容 | stdio 服务器需加 cmd /c 包装（如 -- cmd /c npx -y 包名） |
| 第三方风险 | 确认来源可信，避免提示注入/安全风险 |
| 参数顺序 | stdio 配置时 -- 前后参数不可颠倒 |
总结
| 内容 | 说明 |
|---|---|
| 核心 | MCP = AI 工具的「万能插座」 |
| 命令 | claude mcp add/list/get/remove |
| 接入方式 | HTTP（推荐）、SSE（弃用）、stdio（本地） |
| 配置范围 | local > project > user |
MCP 让 Claude Code 从「聊天工具」变成「操作系统」。
关键词：Claude Code MCP, Model Context Protocol, claude mcp命令, HTTP接入, stdio服务器, MCP配置
