实战

Claude Code 与 MCP(Model Context Protocol)集成实战:连接 GitHub、Slack、数据库全流程

Claude Code 与 MCP 集成实战完整指南:MCP 三类能力(Tools/Resources/Prompts)、三种配置方式(/mcp 交互命令/.mcp.json 项目级/~/.claude.json 用户级)、GitHub 完整配置(列出 Issues/查看 PR 评论)、Slack 配置(提炼技术决策)、PostgreSQL 配置(分析数据异常)、官方插件市场 8 个预配置 MCP 插件(GitHub/Slack/Atlassian/Linear/Notion/Sentry/Figma/Vercel)、MCP Prompts 作为 /mcp__server__prompt 格式斜杠命令、企业安全白名单(allowManagedMcpServersOnly/enabledMcpjsonServers)和 MCP 调试方法(/mcp/reconnect/--mcp-debug)。

2026/3/84分钟 阅读ClaudeEagle

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(项目级)

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(用户级,所有项目)

json
// ~/.claude.json
{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-...",
        "SLACK_TEAM_ID": "T..."
      }
    }
  }
}

实战:连接 GitHub

bash
# 安装 GitHub MCP 服务器
npx -y @modelcontextprotocol/server-github
json
// .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

json
{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-...",
        "SLACK_TEAM_ID": "T..."
      }
    }
  }
}

使用示例:

在 #engineering 频道中找到最近关于认证模块的讨论,提炼技术决策

实战:连接 PostgreSQL

json
{
  "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 服务器:

json
{
  "allowManagedMcpServersOnly": true,
  "enabledMcpjsonServers": ["github", "slack"],
  "disabledMcpjsonServers": ["filesystem"]
}

调试 MCP 连接

/mcp # 查看所有 MCP 服务器状态 /mcp server-name reconnect # 重新连接指定服务器 claude --mcp-debug # 启用 MCP 调试日志

常见问题:

  • 服务器不启动:检查 commandargs 是否正确;确认 npx 已安装
  • 认证失败:检查 Token/API Key 有效性;部分服务器需要 OAuth 流程(通过 /mcp 完成)
  • 工具不可用:确认服务器连接正常;查看 Claude 的工具权限设置

来源整理:基于 Anthropic MCP 规范Claude Code MCP 文档 和官方插件市场综合

相关文章推荐

实战Claude Code MCP 集成实战:连接外部服务、数据库与 API 的完整教程Claude Code MCP 集成实战:配置文件格式(.mcp.json)、常用 MCP 服务器(GitHub/PostgreSQL/Slack/Brave Search)、三大实战场景(数据库分析/GitHub 自动化/邮件处理),以及 MCP 服务器类型、管理命令和安全注意事项。2026/3/2实战用 Claude Code 处理邮件:MCP + Pipedream 打造个人邮件 AI 代理Harper Reed 用 Claude Code + Pipedream MCP 处理积压邮件:代理读取邮件起草回复、检查日历,人工审核后发送。含血泪教训、CLAUDE.md 规则、Skill 文件配置和 Pipedream MCP 工具栈完整实战教程。2026/3/1实战用 Claude Code + MCP 自动处理邮件:实战经验与避坑指南Harper Reed 用 Claude Code + Pipedream MCP 打造邮件自动处理工作流:Agent 检查收件箱、匹配个人写作风格起草回复、仅保存草稿由人工审核。包含完整目录结构、CLAUDE.md 配置、MCP 服务器设置,以及「让 Agent 直接发邮件」的惨痛教训。2026/2/28实战Claude Code Skills 实战:15 个可直接使用的 SKILL.md 模板(Git/审查/测试/文档/部署/调试)15 个精心设计的开箱即用 SKILL.md 模板:Git 工作流类(Smart Commit/PR Creator/Branch Cleanup);代码审查类(Security Review 含 OWASP 清单/Performance Review N+1 检测);测试类(Test Generator/Coverage Check);文档类(API Doc Generator OpenAPI 格式/Changelog Generator);部署运维类(Pre-deploy Checklist);调试类(Error Analyzer);效率工具类(Code Explainer/Refactor Advisor/Dependency Auditor/Daily Standup Helper)。2026/5/10实战Claude Code 成本优化完整指南:Token 节省策略、模型选择和 Prompt Cache 配置Claude Code 成本优化完整指南:Token 消耗来源分析(对话历史/大文件读取/工具输出/MCP 服务器/长 CLAUDE.md);8 个优化策略(/compact 主动压缩/精确 @ 引用/控制 MCP 数量/模型选择 Haiku vs Sonnet vs Opus 价格对比/努力等级按需调整/Prompt Cache 1 小时 TTL/CLAUDE.md 精简/usage 监控);不同场景的成本估算(个人/小团队/企业);以及订阅 vs API 的临界点分析。2026/5/8实战Claude Code 企业规模化最佳实践:AI 网关、成本控制和可观测性完全指南Claude Code 企业级部署完整指南:原生局限(订阅模式无实时仪表盘/API 密钥散落风险);AI 网关层解决方案(7 个最佳实践:凭证三级层级/预算速率限制/完整请求可观测性/请求元数据标签/多提供商故障转移/输入输出护栏/灵活提供商切换);Portkey 2 分钟配置示例;Enterprise 专属功能(managed-settings/allowManagedDomainsOnly/OpenTelemetry);以及团队 CLAUDE.md 安全策略模板。2026/5/7