Claude Code 与 MCP 服务器使用指南

Claude Code想必不用多做介绍，编码界的扛把子。虽然Anthropic的模型因为一些原因用不了，但是接上国内的大模型也依然能打，比如DeepSeek、GLM（智谱）。MCP（模型上下文协议）也是Anthropic出的一款技术，让AI大模型可以通过统一接口访问模型外的数据。

下面是MCP的简单介绍：

MCP是一种开放源代码标准，它允许 Claude Code 与数百种外部工具、数据库和 API 进行无缝连接。通过 MCP，Claude Code 不再局限于对话，而是能够直接操作你的开发环境、查询实时数据并执行复杂的自动化工作流。

1. Claude Code中安装MCP Server

在添加MCP服务器之前，需要确定其作用范围 (Scope)，这决定了配置文件的存储位置和共享性：

• Local (默认) ：配置存储在 ~/.claude.json 中，仅在当前项目目录中可用，适合个人开发或包含敏感凭据的实验。
• Project ：配置存储在项目根目录的 .mcp.json 中，可存入版本控制系统（如 Git），确保团队成员拥有相同的工具。
• User ：配置存储在 ~/.claude.json 中，可跨所有项目使用，适合通用的个人实用工具。

Local方式和User方式使用相同的配置文件，唯一区别是Local方式安装的MCP Server是项目级别可用的，而User方式安装的MCP Server，该用户环境下全部项目都可以使用。

三种安装方式的优先级如下，

Local-based>Project-based>User-based

比如要安装notion官方的MCP Server，下面是三种方式的安装展示，

Local-based安装

aneirin@xuliat14p:~/claudeTestA$ claude mcp add --transport http notion https://mcp.notion.com/mcp
Added HTTP MCP server notion with URL: https://mcp.notion.com/mcp to local config
File modified: /home/aneirin/.claude.json [project: /home/aneirin/claudeTestA]

安装后，MCP服务器配置在文件"/home/aneirin/.claude.json"中，因为在键"/home/aneirin/claudeTestA"下，所以只有在项目claudeTestA里面可用。如下，

Project-based安装

aneirin@xuliat14p:~/claudeTestA$ claude mcp add --transport http notion --scope project https://mcp.notion.com/mcp
Added HTTP MCP server notion with URL: https://mcp.notion.com/mcp to project config
File modified: /home/aneirin/claudeTestA/.mcp.json

安装后，MCP服务器配置在文件/home/aneirin/claudeTestA/.mcp.json中，因为在项目根目录下，配合上Git，可以实现团队共享。

User-based安装

aneirin@xuliat14p:~/claudeTestA$ claude mcp add --transport http notion --scope user https://mcp.notion.com/mcp
Added HTTP MCP server notion with URL: https://mcp.notion.com/mcp to user config
File modified: /home/aneirin/.claude.json

安装的位置和Local-based一样，但是这时整个用户下的项目都可以访问到这个MCP，

使用下面图片更直观些，

MCP Server删除

如果不需要安装的notion mcp server，使用下面命令删除

  claude mcp remove notion -s local
  claude mcp remove notion -s project
  claude mcp remove notion -s user

2. 实战案例：连接并查询 PostgreSQL 数据库

这是一个非常实用的例子，展示了如何让 Claude Code 具备直接分析生产或开发环境数据库的能力。

步骤 A：安装数据库 MCP 服务器 你可以使用 stdio 传输协议来添加本地数据库服务器。在终端中输入以下命令：

claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://username:password@localhost:5432/analytics"

注：此命令使用了 stdio 传输方式，并将连接字符串作为参数传递给服务器。

步骤 B：使用自然语言进行查询 安装完成后，你可以直接在 Claude Code 中像对话一样下达数据库指令：

• "查询本月的总收入是多少？"
• "展示订单表 (orders table) 的架构。"
• "找出 90 天内没有购买记录的客户。"

3. 其他常见应用场景示例

除了数据库，你还可以连接其他流行的服务：

• GitHub 代码审查 ：
  1. 使用 claude mcp add --transport http github https://api.githubcopilot.com/mcp/ 添加服务器。
  2. 通过 /mcp 命令进行身份验证。
  3. 要求 Claude："审查 PR #123 并提出改进建议"或"为刚才发现的 Bug 创建新 issue"。
• Sentry 错误监控 ：
  1. 添加 Sentry 服务器：claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
  2. 查询："过去 24 小时内最常见的错误是什么？"或"显示错误 ID abc123 的堆栈跟踪"。

4. 高阶用法：资源引用与提示词命令

• 资源引用 (@ mentions)：你可以像引用文件一样引用 MCP 资源。

例如，输入 @ 调出自动补全菜单，输入 > 请分析 @github:issue://123 并建议修复方案。

• 作为命令执行 (/ prompts)：MCP 服务器提供的提示词会变成 Claude Code 的命令。

例如，直接输入 /mcp__github__list_prs 来查看当前所有的拉取请求。

放在最后

• 管理命令 ：使用 claude mcp list 查看已配置的MCP服务器，或在 Claude Code 内部使用 /mcp 检查状态。
• 安全风险：使用第三方 MCP 服务器需自担风险。Anthropic 尚未验证所有服务器的安全性，尤其是能够获取不可信内容的服务器，可能存在提示词注入风险。
• 输出限制 ：默认情况下，MCP 工具的输出限制为 25,000 token 。如果处理大型数据集，可以通过设置环境变量 MAX_MCP_OUTPUT_TOKENS 来调高此限制。