Claude Code MCP 快速高效使用指南

概述

Model Context Protocol (MCP) 是一个开放协议，使大型语言模型能够访问外部工具和数据源。在 Claude Code 中，MCP 提供了标准化的方式来扩展 Claude 的功能，连接外部工具和服务。

基本配置命令

添加 MCP 服务器

基本语法：

claude mcp add <name> <command> [args...]

常用示例：

# 添加文件系统服务器claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Projects# 添加 GitHub 服务器claude mcp add github -s user -- env GITHUB_TOKEN=your_token npx -y @modelcontextprotocol/server-github# 添加 Puppeteer 服务器claude mcp add puppeteer -s user -- npx -y @modelcontextprotocol/server-puppeteer# 添加 Playwright 服务器claude mcp add playwright npx @playwright/mcp@latest

服务器传输类型

SSE (Server-Sent Events)：

claude mcp add --transport sse sse-server https://example.com/sse-endpoint

HTTP：

claude mcp add --transport http http-server https://example.com/mcp

管理命令

# 列出所有配置的服务器claude mcp list# 获取特定服务器的详细信息claude mcp get my-server# 删除服务器claude mcp remove my-server# 重置项目选择claude mcp reset-project-choices

配置作用域

• local (默认)：仅在当前项目中可用
• project：通过 .mcp.json 文件与项目中的所有人共享
• user：在所有项目中可用

配置文件详解

直接配置文件编辑

配置存储在 .claude.json 文件中，包含 mcpServers 对象：

{  "mcpServers": {    "sequential-thinking": {      "type": "stdio",      "command": "npx",      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]    }  }}

高级配置示例

包含环境变量和 API 密钥的复杂配置：

{  "mcpServers": {    "mcp-omnisearch": {      "type": "stdio",      "command": "npx",      "args": ["-y", "mcp-omnisearch"],      "env": {        "TAVILY_API_KEY": "",        "BRAVE_API_KEY": "",        "KAGI_API_KEY": "",        "PERPLEXITY_API_KEY": "",        "JINA_AI_API_KEY": ""      }    }  }}

2025 年新特性与6-7月最新更新

远程服务器支持（2025年7月重大更新）

Claude Code 现已正式支持远程 MCP 服务器，这是从之前仅支持本地服务器的重大升级：

核心优势：

• 低维护成本：只需将供应商的 URL 添加到 Claude Code - 无需手动设置
• 自动更新：供应商负责更新、扩展和可用性管理
• 专注开发：开发者可以专注于构建，而不是管理服务器基础设施

配置示例：

# 添加远程 MCP 服务器claude mcp add --transport sse remote-server https://vendor.com/mcp-endpoint

OAuth 认证集成（2025年6月）

Claude Code 现在提供原生的 OAuth 支持，显著改善了安全性和用户体验：

特性：

• 一次认证：只需认证一次，Claude Code 自动处理后续连接
• 无需管理 API 密钥：OAuth 流程自动处理身份验证
• 安全连接：与现有账户的安全连接
• SAML 执行：支持企业级身份验证

使用流程：

1. 添加支持 OAuth 的 MCP 服务器
2. Claude Code 自动打开浏览器进行安全登录
3. 完成认证后，后续连接自动处理

热门新增远程 MCP 服务器

GitHub MCP 服务器（2025年6月）

GitHub 官方推出了远程 MCP 服务器公共预览版：

特性：

• OAuth 2.0 认证：推荐的认证方式，支持作用域访问
• SAML 执行：企业级安全支持
• 自动更新：GitHub 托管服务器，自动应用更新
• 一键设置：无需本地安装或运行

Linear MCP 服务器

Linear 的 MCP 集成将项目管理直接引入 Claude Code：

功能：

• 实时上下文：从 Linear 获取结构化、实时的上下文
• 问题详情：Claude Code 可以提取问题详情和项目状态
• 工作流集成：在规划、编写代码和管理问题之间保持流畅

DigitalOcean MCP 服务器

DigitalOcean MCP 服务器连接 Claude Code 到您的 DigitalOcean 账户：

能力：

• 应用部署：直接部署应用
• 日志获取：获取服务日志
• 服务重启：重启服务
• 资源管理：管理云资源

用户增长和采用情况

• Claude Code 的活跃用户基数在 Claude 4 模型发布后三个月内增长了 160%
• 远程 MCP 服务器支持显著简化了外部工具和服务的集成
• 开发者不再需要管理本地服务器基础设施的复杂性

技术改进

增强的连接性

• HTTP + Server-Sent Events (SSE)：改进的性能和可靠性
• 实时通信：支持实时数据流
• 自动重连：网络中断时自动重新连接

安全性增强

• OAuth 2.0 标准：使用业界标准的身份验证
• 作用域访问：精确控制访问权限
• 企业级支持：SAML 执行和企业身份提供商集成

增强的传输协议

• 改进的性能和可靠性
• 实时通信支持
• 流式 JSON 输出

2025年最受欢迎的Top 10 MCP服务器

根据开发者使用情况和社区评价，以下是2025年最受欢迎的Claude Code MCP服务器：

1. GitHub MCP Server ?

连接 Claude Code 到 GitHub 的 REST API，实现与仓库的无缝交互。

功能特点：

• 读取问题、管理PR、触发CI/CD工作流
• 分析提交历史，代码审查
• 支持OAuth认证，安全可靠

安装：

claude mcp add github -s user -- env GITHUB_TOKEN=your_token npx -y @modelcontextprotocol/server-github

2. Browser Tools MCP Server ?

通过自然语言控制和自动化浏览器操作。

功能特点：

• 网页导航、表单填充、数据抓取
• 支持Puppeteer和Playwright
• 适用于Web开发和测试

安装：

claude mcp add puppeteer -s user -- npx -y @modelcontextprotocol/server-puppeteerclaude mcp add playwright npx @playwright/mcp@latest

3. File System MCP Server ?

管理本地文件，让 Claude Code 读写编辑本机文件。

功能特点：

• 项目管理、日志分析、快速编辑
• 精确的目录权限控制
• 安全的文件访问机制

安装：

claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Projects

4. Apidog MCP Server

简化API开发，集成API文档、测试和代码生成。

功能特点：

• 查询API规范、测试端点
• 生成客户端代码
• 一站式API开发环境

安装：

claude mcp add apidog -s user -- npx -y @apidog/mcp-server

5. Sequential Thinking MCP Server

增强问题解决能力，将复杂任务分解为逻辑步骤。

功能特点：

• 多阶段规划和架构设计
• 系统分解和大规模重构
• 逻辑推理增强

安装：

claude mcp add sequential-thinking -s user -- npx -y @modelcontextprotocol/server-sequential-thinking

6. PostgreSQL MCP Server

通过自然语言查询数据库。

功能特点：

• 直接数据库交互
• 自然语言SQL查询
• 数据分析和报表生成

安装：

claude mcp add postgres -s user -- env DATABASE_URL=your_db_url npx -y @modelcontextprotocol/server-postgres

7. Notion MCP Server

从 Claude 直接更新 Notion 知识库。

功能特点：

• 内部知识库管理
• 页面创建和更新
• 团队协作增强

安装：

claude mcp add notion -s user -- env NOTION_TOKEN=your_token npx -y @modelcontextprotocol/server-notion

8. Memory Bank MCP Server

为AI代理提供跨会话的上下文记忆。

功能特点：

• 集中式记忆系统
• 大型代码库导航
• 项目级理解维护

安装：

claude mcp add memory-bank -s user -- npx -y @modelcontextprotocol/server-memory-bank

9. Zapier MCP Server

自动化跨应用工作流程。

功能特点：

• 连接数千个应用
• 工作流自动化
• 安全的跨应用交互

安装：

claude mcp add zapier -s user -- env ZAPIER_API_KEY=your_key npx -y @modelcontextprotocol/server-zapier

10. Docker MCP Server

在容器中安全执行代码操作。

功能特点：

• 隔离的执行环境
• 安全的代码执行
• AI开发工作流增强

安装：

claude mcp add docker -s user -- npx -y @modelcontextprotocol/server-docker

选择MCP服务器的建议

开发者必备组合

• GitHub + File System + Sequential Thinking：适合代码开发和版本控制
• Browser Tools + Apidog + Memory Bank：适合Web开发和API测试
• PostgreSQL + Notion + Zapier：适合数据驱动的项目管理

安全性考虑

• 使用用户级别安装 (-s user) 确保权限控制
• 定期更新MCP服务器以获得最新安全补丁
• 谨慎配置文件系统和数据库访问权限

常用 MCP 服务器（传统配置）

文件系统服务器

claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Projects

GitHub 集成

claude mcp add github -s user -- env GITHUB_TOKEN=your_token npx -y @modelcontextprotocol/server-github

浏览器自动化

claude mcp add puppeteer -s user -- npx -y @modelcontextprotocol/server-puppeteerclaude mcp add playwright npx @playwright/mcp@latest

搜索工具

claude mcp add fetch -s user -- npx -y @kazuph/mcp-fetch

最佳实践（2025年更新版）

1. 配置管理

• 优先使用远程服务器：减少本地维护负担，享受自动更新
• OAuth 认证优先：使用 OAuth 替代 API 密钥管理
• 使用直接配置文件编辑获得更好的控制和灵活性
• 遵循配置作用域层次结构：本地 > 项目 > 用户
• 将项目特定的配置存储在 .mcp.json 文件中以便团队共享

2. 服务器选择策略

• 本地服务器：适合开发和测试环境，完全控制
• 远程服务器：适合生产环境和团队协作，低维护
• 混合使用：根据具体需求选择合适的服务器类型

3. 安全性最佳实践

• OAuth 2.0 优先：更安全、更便于管理
• SAML 企业集成：确保合规性和企业级安全
• 权限最小化：仅授予必要的访问权限
• 定期审查：定期检查和更新服务器配置

4. 环境变量管理

• 使用 -e 或 --env 标志设置环境变量
• 配置 MCP 服务器启动超时：MCP_TIMEOUT=10000 claude
• 将敏感信息存储在环境变量中，而非配置文件

5. 上下文管理

• 有效管理上下文是充分利用 Claude Code 的关键
• 注意上下文左侧指示器和 Claude 自动压缩较旧部分的时机
• 在工作流程的自然断点处主动压缩

6. 自定义斜杠命令

• 将重复的工作流程存储在 .claude/commands 文件夹中的 Markdown 文件中
• 这些命令可通过斜杠命令菜单访问
• 可以提交到 git 中供团队共享

7. 监控和维护

• 远程服务器优势：自动更新和维护
• 状态监控：使用 claude mcp list 检查服务器状态
• OAuth 令牌：监控认证状态和令牌有效性

调试和监控

调试模式

claude --mcp-debug

检查 MCP 状态

/mcp

显示每个 MCP 服务器的连接状态（"connected" 或 "failed"）

头部模式自动化

claude -p "your prompt" --output-format stream-json

实际应用场景

1. 视觉开发工作流

• 使用浏览器截图（通过 Puppeteer MCP 服务器）
• 提供视觉模型，让 Claude 实现设计
• 截图并迭代直到结果匹配模型

2. 数据库集成

• 使用数据库 MCP 服务器（如 Postgres）
• 让 Claude Code 直接与数据库交互进行查询和数据分析

3. 自动化工作流

• 在 CI、pre-commit 钩子和自动化中使用头部模式
• 流式 JSON 输出用于程序化处理

资源访问

使用资源

• 在提示中输入 @ 查看所有连接的 MCP 服务器的可用资源
• 资源与文件一起出现在自动完成菜单中

社区资源

• 访问 mcp.so 和 smithery.ai 探索更多 MCP 服务器
• 查看 Claude MCP 社区 (claudemcp.com) 获取最新服务器

故障排除

常见问题

1. 服务器连接失败：检查命令路径和参数
2. 环境变量未设置：确保 API 密钥正确配置
3. 权限问题：检查文件系统权限和网络访问

解决方案

• 使用 --mcp-debug 标志识别配置问题
• 检查 .claude.json 文件语法
• 验证网络连接和 API 密钥有效性

总结

Claude Code MCP 在 2025 年为开发者提供了强大的扩展能力，通过标准化协议连接外部工具和服务。正确配置和使用 MCP 服务器可以显著提高开发效率和 Claude 的功能范围。

记住关键原则：

• 选择合适的配置作用域
• 安全管理 API 密钥
• 有效利用上下文管理
• 善用社区资源和最佳实践

通过遵循本指南，你可以快速高效地在 Claude Code 中使用 MCP，充分发挥其潜力。