通过 MCP 连接 Claude Code 与工具
原文：Connect Claude Code to tools via MCP
一句话
通过 Model Context Protocol (MCP) 连接 Claude Code 与外部工具、数据库和 API。
什么时候翻这页
- 需要将 Claude Code 与外部工具（如 JIRA、Sentry、PostgreSQL 等）集成时
- 希望自动化工作流程，减少手动复制数据到聊天中的操作
- 需要构建自定义 MCP 服务器扩展 Claude Code 功能时
- 遇到 MCP 服务器认证或配置问题需要参考
核心概念
- Model Context Protocol (MCP)：开源的 AI 工具集成标准，允许 Claude Code 连接数百个外部工具和数据源
- MCP 服务器：提供 Claude Code 访问工具、数据库和 API 的接口程序
- 传输方式：MCP 服务器可通过 HTTP、SSE、WebSocket 或 stdio 方式连接
- 范围：MCP 服务器配置可设置为本地（local）、项目（project）或用户（user）范围
- 工具搜索：延迟加载 MCP 工具定义，仅在需要时加载，减少上下文窗口使用
怎么做
连接 MCP 服务器
- 查找可用服务器：在 Anthropic Directory 浏览已审核的连接器
- 安装服务器：
- HTTP 服务器：
claude mcp add --transport http <name> <url>
- SSE 服务器：
claude mcp add --transport sse <name> <url>
- 本地 stdio 服务器：
claude mcp add [options] <name> -- <command> [args...]
- WebSocket 服务器：通过
.mcp.json 或 claude mcp add-json 配置
- 管理服务器：
- 列出所有服务器：
claude mcp list
- 获取特定服务器详情：
claude mcp get <name>
- 移除服务器：
claude mcp remove <name>
- 在 Claude Code 中检查状态：
/mcp
构建自定义 MCP 服务器
- 安装
mcp-server-dev 插件：/plugin install mcp-server-dev@claude-plugins-official
- 运行构建命令：
/mcp-server-dev:build-mcp-server
- 根据提示选择 HTTP 或 stdio 服务器类型
认证远程服务器
- 添加需要认证的服务器：
claude mcp add --transport http <name> <url>
- 在 Claude Code 中运行：
/mcp
- 按照浏览器提示完成 OAuth 流程
命令 / 配置速查
| 命令 | 描述 |
|---|
claude mcp add --transport http <name> <url> | 添加 HTTP 传输的 MCP 服务器 |
claude mcp add --transport sse <name> <url> | 添加 SSE 传输的 MCP 服务器 |
claude mcp add [options] <name> -- <command> [args...] | 添加本地 stdio 服务器 |
claude mcp list | 列出所有配置的服务器 |
claude mcp get <name> | 获取特定服务器详情 |
claude mcp remove <name> | 移除服务器 |
/mcp | 在 Claude Code 中检查服务器状态 |
| 配置文件 | 位置 | 描述 |
|---|
.mcp.json | 项目根目录 | 项目范围的服务器配置 |
~/.claude.json | 用户主目录 | 本地或用户范围的服务器配置 |
初学者易错点
- 忘记使用
-- 分隔符：添加 stdio 服务器时，必须在命令前使用 -- 分隔符，否则参数会被错误解析
- 环境变量未设置：stdio 服务器依赖
CLAUDE_PROJECT_DIR 环境变量，确保服务器代码能正确读取
- OAuth 认证失败：如果浏览器未自动打开，手动复制回调 URL 到 Claude Code 提示中
- 服务器名称冲突：
workspace 是保留名称，不能用作服务器名称
- 传输方式选择错误：SSE 传输已弃用，优先使用 HTTP 传输
相关词条
mcp-quickstart MCP 快速入门指南channels 通道功能，用于推送消息到会话plugins 插件系统，可捆绑 MCP 服务器managed-mcp 管理的 MCP 配置，用于组织控制settings Claude Code 设置，包括 MCP 相关配置hooks 钩子系统，可自定义 MCP 行为