MCP(Model Context Protocol)是 Anthropic 主导的开放标准,让 AI 工具能够连接外部数据源和服务。Claude Code 通过 MCP 可以读取 Google Drive 文档、更新 Jira 工单、查询数据库、操作 GitHub 仓库——将 AI 与整个工程工具链打通。
MCP 核心概念
MCP 服务器:提供工具(Tools)、资源(Resources)和提示词(Prompts)的进程,Claude Code 作为 MCP 客户端连接它。
三类 MCP 能力:
- Tools:Claude 可以调用的函数(如「搜索 GitHub Issues」)
- Resources:Claude 可以读取的数据(如「当前 PR 内容」)
- Prompts:MCP 服务器暴露的提示词模板,以
/mcp__<server>__<prompt>格式调用
配置 MCP 服务器
方式一:通过 /mcp 命令(交互式)
/mcp # 打开 MCP 管理界面
在界面中添加服务器、查看连接状态、处理 OAuth 认证。
方式二:编辑 .mcp.json(项目级)
// .mcp.json(提交到 git,团队共享)
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
}
},
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres"],
"env": {
"DATABASE_URL": "postgresql://user:pass@localhost:5432/mydb"
}
}
}
}方式三:编辑 ~/.claude.json(用户级,所有项目)
// ~/.claude.json
{
"mcpServers": {
"slack": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-slack"],
"env": {
"SLACK_BOT_TOKEN": "xoxb-...",
"SLACK_TEAM_ID": "T..."
}
}
}
}实战:连接 GitHub
# 安装 GitHub MCP 服务器
npx -y @modelcontextprotocol/server-github// .mcp.json
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxx" }
}
}
}配置后,Claude Code 可以:
列出仓库所有 open Issues,找出最近 7 天新建的高优先级 bug
查看 PR #123 的所有评论,总结主要争议点
实战:连接 Slack
{
"mcpServers": {
"slack": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-slack"],
"env": {
"SLACK_BOT_TOKEN": "xoxb-...",
"SLACK_TEAM_ID": "T..."
}
}
}
}使用示例:
在 #engineering 频道中找到最近关于认证模块的讨论,提炼技术决策
实战:连接 PostgreSQL
{
"mcpServers": {
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres",
"postgresql://user:pass@localhost:5432/mydb"]
}
}
}使用示例:
分析 orders 表过去 30 天的数据,找出异常订单模式
官方插件市场中的 MCP 插件
Claude Code 官方插件市场(claude-plugins-official)提供预配置 MCP 插件,无需手动配置:
/plugin install github@claude-plugins-official
/plugin install slack@claude-plugins-official
/plugin install atlassian@claude-plugins-official # Jira + Confluence
/plugin install linear@claude-plugins-official
/plugin install notion@claude-plugins-official
/plugin install sentry@claude-plugins-official
/plugin install figma@claude-plugins-official
/plugin install vercel@claude-plugins-official
MCP Prompts 作为斜杠命令
MCP 服务器可以暴露提示词模板,自动以 /mcp__<server>__<prompt> 格式注册为命令:
/mcp__github__create-issue # 引导创建 GitHub Issue
/mcp__slack__summarize-channel # 总结 Slack 频道内容
在 /mcp 界面中查看每个连接服务器暴露的所有 Prompts。
企业安全:MCP 服务器白名单
管理员可通过 managed-settings.json 限制允许的 MCP 服务器:
{
"allowManagedMcpServersOnly": true,
"enabledMcpjsonServers": ["github", "slack"],
"disabledMcpjsonServers": ["filesystem"]
}调试 MCP 连接
/mcp # 查看所有 MCP 服务器状态
/mcp server-name reconnect # 重新连接指定服务器
claude --mcp-debug # 启用 MCP 调试日志
常见问题:
- 服务器不启动:检查
command和args是否正确;确认npx已安装 - 认证失败:检查 Token/API Key 有效性;部分服务器需要 OAuth 流程(通过
/mcp完成) - 工具不可用:确认服务器连接正常;查看 Claude 的工具权限设置
来源整理:基于 Anthropic MCP 规范、Claude Code MCP 文档 和官方插件市场综合