实战

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 命令行工具开发实战:用 AI 快速构建专业 CLI 工具Claude Code 辅助命令行工具(CLI)开发的完整实战指南:Python Click/Typer、Go Cobra、Rust Clap 技术栈选型、用 Claude Code 生成完整 CLI 项目结构(参数解析/子命令/全局选项)、交互式提示和彩色输出、配置文件管理、Shell 自动补全生成、跨平台打包(PyInstaller/goreleaser),以及发布到 PyPI/npm/Homebrew 的完整流程。2026/3/26实战Claude Code Vue 3 实战完全指南:Composition API 开发到企业级前端工程化Claude Code 辅助 Vue 3 开发的完整实战指南:Composition API 组件生成(setup/ref/computed)、Pinia 状态管理代码生成、Vue Router 4 路由配置、TypeScript 类型定义生成(Props/Emits)、Composables 抽象、Vitest 单元测试生成、性能优化(虚拟滚动/v-memo),以及 Options API 迁移和响应式丢失问题排查的 Prompt 模板。2026/3/26实战Claude Code Django 实战完全指南:从模型设计到 REST API 开发全流程Claude Code 辅助 Django 开发的完整实战指南:用 Claude Code 生成 Django 项目结构和 Models(含迁移文件)、Django REST Framework(DRF)API 开发(Serializer/ViewSet/Router)、用户认证系统(JWT/Session/第三方登录)、Django ORM 查询优化(select_related/prefetch_related/annotate)、异步任务(Celery + Redis)、测试用例生成(pytest-django)、Docker 化部署,以及在现有 Django 项目中快速定位和修复 Bug 的 Prompt 技巧。2026/3/26