烧饼的分享站

12.Claude Code MCP

9 min read

如果说 Claude Code 是一个优秀的打字员（代码生成）和测试员（代码校验），那么加上 MCP（Model Context Protocol，模型上下文协议） 则是让 Claude 真正拥有了外部感官和手脚——它不再局限于当前项目的代码文件，而是能主动连接外部世界的资源与工具，成为你的全链路开发协作伙伴。

什么是 MCP (Model Context Protocol)？

MCP 是 Anthropic 推出的一套开放的标准化协议，专为解决AI 与外部工具协作的核心痛点而生。

MCP 的核心逻辑颠覆了传统思路：不要让 AI 去逐一学习所有工具的使用规则，而是让所有工具都提供一个统一的接口给 AI。

这个逻辑就像现实中的通用插座——不用让电器适配不同的插座，只要插座统一标准，所有电器都能直接使用。

连接 MCP 服务器后，你可以让 Claude Code：

  • 从 JIRA/工单系统获取需求并开发功能、创建 GitHub PR

  • 分析 Sentry 监控数据、定位生产环境错误

  • 查询 PostgreSQL/MySQL 等数据库数据

  • 基于 Figma 设计更新代码、自动化生成邮件草稿等

为什么 Claude Code 需要 MCP？

在没有 MCP 之前，Claude Code 的能力被严格限制在你当前打开的项目文件夹内，就像一个坐井观天的助手，只能看到眼前的代码，无法感知项目之外的任何信息。而 MCP 的出现，彻底打破了这个信息孤岛，让 Claude 能深度参与全流程开发：

举几个直观的场景对比，你就能快速理解 MCP 的价值：

场景无 MCP 时有 MCP 时
跨仓库分析只能分析当前文件夹内的代码，无法关联其它仓库跨仓库协作：“帮我分析仓库 A 的接口文档，然后在仓库 B 中编写对应的调用方法”
需求 / 讨论同步需要你手动把需求文档、团队讨论记录复制粘贴到对话框实时同步协作信息：“查一下 Slack 里 feature-x 频道的讨论记录，看看大家对该功能的修改建议”
数据库验证无法直接验证代码与数据库的适配性，只能手动查表结构直接联动数据库：“去查一下 MySQL 中 users 表的结构和前 5 条数据，判断我写的用户查询接口是否匹配”
自动化流程只能生成代码片段，供你手动复制使用自动化执行：“帮我写浏览器自动化脚本，并通过 MCP 调用 Puppeteer 执行，验证登录页面的交互逻辑”

简单来说，MCP 让 Claude Code 从被动接收信息的助手，变成了主动获取信息、执行操作的协作伙伴。

Claude Code 中 MCP 的基本使用方式

Claude Code 内置了完整的 MCP 管理能力，核心命令只有一个：

Claude mcp

常用子命令:

命令作用
claude mcp add添加一个 MCP 服务器
claude mcp list查看所有已配置服务器
claude mcp get <name>查看某个服务器详情
claude mcp remove <name>删除服务器
/mcp在 Claude Code 中查看状态/认证

需要我帮你补充 命令参数说明 或 使用示例 吗？

安装 MCP 服务器

MCP 服务器支持 HTTP/SSE/stdio 三种接入方式，推荐优先使用 HTTP（SSE已弃用）。

远程 HTTP 服务器（推荐）

适用于云服务类工具，是最通用的方式：

#基础语法
claude mcp add --transport http <服务器RL
#示例1:连接Notion
claude mcp add --transport http notion
https://mcp.notion.com/mcp
#示例2:带身份验证的HTTP服务器
claude mcp add --transport http secure-api
https://api.example.com/mcp \
--header"Authorization:Bearer 你的令牌"

远程 SSE 服务器（已弃用）

仅兼容旧版工具，优先用 HTTP 替代：

#基础语法(仅兼容用)
claude mcp add --transport sse<服务器URL
#示例:连接Asana
claude mcp add --transport sse asana
https://mcp.asana.com/sse

本地 stdio 服务器

适用于需要本地系统访问的工具（如本地数据库、自定义脚本）：

#基础语法(注意:--前是Claude参数,--后是服务器命令)
claude mcp add --transport stdio[--env 环境变量]
<服务器名称>
<启动命令>
#示例:连接Airtable(需替换自己的API密钥)
claudermcp add --transport stdio --env AIRTABLE_API_KEY=你的密
钥airtable\
-- npx -y airtable-mcp-server

关键注意：—transport/—env 等参数必须放在服务器名称前面，— 用于分隔Claude参数和服务器命令，避免参数冲突。

管理 MCP 服务器

配置完成后，你可以通过以下命令管理服务器：

#列出所有已配置的服务器
claude mcp list
 
#查看指定服务器详情(如github)
claude mcp get github
 
#删除指定服务器
claude mcp remove github
 
#在Claude Code中检查服务器状态
/mcp

配置范围（控制服务器可见性）

你可以指定 MCP 服务器的生效范围，适配个人/团队使用场景：

范围用途配置命令示例
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 代码审查

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

在 Claude Code 中：

Review PR #456 and suggest improvements
Show me all open PRS assigned to me

示例 2：Sentry 生产环境排错

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
/mcp #完成 OAuth登录
> What are the most common errors in the lLast 24 hours?

示例 3：直接查 PostgreSQL

claude mcp add --transport stdio db \
-- npx-y @bytebase/dbhub\
--dsn "postgresql://readonly:pass@prod.db.com:5432/:analytics
>Showmetheschemafortheorderstable
> Which users haven't purchased in 90 days?

在对话中使用 MCP 的高级方式

1、使用 @ 引用 MCP 资源

Analyze @github:issue://123 and suggest a fiix

支持多个资源对比：

Compare @postgres:schema://users with @docs:file://user-model

2、MCP Prompt 作为斜杠命令

MCP 可以暴露命令：

/mcp_github__list_prs
/mcp_jira_create_issue "Login bug" high

Claude 会像执行内置命令一样执行它们。

关键注意事项

  • 身份验证：远程MCP服务器（如GitHub/Sentry）需在Claude Code中执行 /mcp 完成OAuth 2.0授权；

  • Windows兼容：本地stdio服务器若用npx，需加cmd /c包装（如— cmd /c npx -y 包名），否则会报”Connection closed”错误；

  • 第三方风险：使用非官方MCP服务器时，需确认来源可信，避免提示注入/安全风险；

  • 参数顺序：stdio服务器配置时，— 前后的参数不可颠倒，否则会执行失败。

相关链接

01.Claude Code 简介 | 02.Claude Code 安装与使用 | 03.Claude Code 如何工作 | 04.Claude Code API 配置 | 06.Claude Code 第一次使用

Graph View

Backlinks