第二十二篇：使用MCP Server打造“外部连接”：从数据库到Jira、Slack全打通

标签#MCP#集成#实战案例#外部工具仅凭 Claude Code 本身就已经相当强大但在装上 MCP 之后它的能力会得到一次质的飞升——可以直接连接数据库、管理 Jira 工单、向 Slack 发送通知以及和整个开发工具链无缝协同。目前有不少现成的 MCP 服务器可以直接使用。这一篇将完整演示如何把真实的外部工具接入 Claude Code让 AI 真正融入你的日常开发工作流。1. MCP Server 是什么MCPModel Context Protocol模型上下文协议是一个专门为 AI 工具连接外部数据源和服务设计的开放标准。AI 助手可以借助 MCP 服务器实现以下功能从 Google Drive 读取文档更新和查询 Jira 工单从 Slack 获取消息和上下文直接在本地连接 PostgreSQL、MySQL 等数据库通过浏览器实现自动化操作与团队自建的各种内部工具对接MCP 服务器在运行时会暴露工具、资源和提示词Claude Code 会根据具体任务自主决定何时调用哪个 MCP 工具。2. 配置 MCP Server 的三种方式在 Claude Code 中连接 MCP 服务器主要有三种方式。建议按需选择方式一CLI 命令最快这是最简洁直接的方式适合快速添加。# stdio 传输用于本地命令行工具claude mcpaddslack-webhook-tstdio -- npx-yagentuse/mcp-slack-webhook# HTTP 传输用于远程服务claude mcpadd--transporthttp pgmcplocal http://localhost:3000/mcpCLI 添加的服务器会自动写入settings.json文件也可以用claude mcp remove server-name来移除。方式二直接编辑 settings.json最灵活适合需要精确控制配置、设置工作目录或引用环境变量的场景。项目级配置存放在.claude/settings.json推荐可随项目共享用户级配置存放在~/.claude/settings.json全局生效{mcpServers:{jira:{command:npx,args:[-y,jira-rest-mcp-server],env:{JIRA_BASE_URL:${JIRA_BASE_URL},JIRA_EMAIL:${JIRA_EMAIL},JIRA_API_TOKEN:${JIRA_API_TOKEN}}}}}各字段含义如下command指定要运行的可执行文件必需args传递给命令的参数数组env传递给服务器的环境变量cwd设置服务器的工作目录transport传输类型支持stdio默认和http方式三使用 Agent SDK通过编程方式集成适合需要更灵活调用的场景。3. 实战一连接 PostgreSQL 数据库通过 MCP 服务器让 Claude Code 直接查询数据库是最能体现 MCP 实际价值的场景之一。选择一使用 pg-mcp推荐只读模式这款服务器实现的是只读访问INSERT、UPDATE、DELETE等写入操作在到达数据库之前就会被阻断天然适合 AI 查询无需担心数据安全问题。配置步骤# 1. 全局安装npminstall-gmir1198yusuf/pg-mcp# 2. 首次运行会进入交互式配置设置端口、添加数据库连接pg-mcp# 3. 添加 MCP server 到 Claude Codeclaude mcpadd--transporthttp--scopelocalpgmcplocal http://localhost:3000/mcp之后打开浏览器访问http://localhost:3000/ui可以添加和管理更多数据库连接。⚠️ 安全提醒~/.pg-mcp/dbs.json中包含数据库明文凭证切勿提交或对外分享。不要在公网服务器上运行这个服务器。使用示例Claude Code 列出所有已配置的数据库 [调用 list_dbs 工具] Claude Code 查询 orders 表最近的 10 条订单记录选择二使用 passionfroot/postgres-mcpPrisma 集成如果项目中使用了 Prisma这个服务器能带来更好的体验。它会合并实时数据库和 Prisma schema让 AI 不仅能看到原始的数据库结构还能理解模型名、字段映射和表之间的关联关系。配置方式创建postgres-mcp.toml配置文件添加数据库源。# 可选关联 Prisma schema # prisma_schema_path ~/work/myproject/prisma/schema.prisma [[sources]] id production dsn postgres://user:passdb-host:5432/mydb?sslmoderequire readonly true使用示例Claude Code 搜索与 User 模型相关的所有表 [调用 search_objects 工具] Claude Code 执行 SQL 查询分析订单状态的分布情况4. 实战二Jira —— 让 AI 管理你的工单让 Claude Code 直接操作 Jira可以省去在开发环境和浏览器之间反复切换的成本。前置准备获取 Jira API Token访问 https://id.atlassian.com/manage-profile/security/api-tokens点击Create API token并立即复制保存。准备关键信息Jira 实例的 base URL、你的登录邮箱、上一步获取的 API Token。推荐方案使用jira-rest-mcp-server相比官方的 Atlassian SSE 端点jira-rest-mcp-server的连接更稳定不会因为认证丢失而导致 API 调用失败。配置步骤创建.claude/settings.local.json加入.gitignore防泄露{env:{JIRA_BASE_URL:https://your-domain.atlassian.net,JIRA_EMAIL:your-emailexample.com,JIRA_API_TOKEN:your-api-token}}然后在.claude/settings.json中添加{mcpServers:{jira:{command:npx,args:[-y,jira-rest-mcp-server],env:{JIRA_BASE_URL:${JIRA_BASE_URL},JIRA_EMAIL:${JIRA_EMAIL},JIRA_API_TOKEN:${JIRA_API_TOKEN}}}}}使用示例Claude Code 查询分配给 sarah 且状态为 In Progress 的 issue Claude Code 在 PROJ-123 下面加一条评论代码已提交至 PR #456等待 Code Review Claude Code 把 ISSUE-456 的状态从 In Progress 更新为 In Review Claude Code 当前 sprint 里有哪些还未被指派的 bug备选方案使用mcp-jira-stdio这款服务器可以通过一条 CLI 命令快速完成配置claude mcpaddjira npx mcp-jira-stdiolatest\--envJIRA_BASE_URLhttps://yourcompany.atlassian.net\--envJIRA_EMAILyour-emailexample.com\--envJIRA_API_TOKENyour-api-token执行后服务器即自动配置完成无需额外编辑配置文件。5. 实战三Slack —— 让 AI 自动推送消息Slack 集成有两种典型路径单向通知Webhook和完整交互。路径一Slack Webhook仅发送最简单前置准备在 Slack API 中创建应用启用 Incoming Webhooks生成一个指向特定频道的 webhook URL。配置方法{mcpServers:{slack-webhook:{command:npx,args:[-y,agentuse/mcp-slack-webhook],env:{SLACK_WEBHOOK_URL:https://hooks.slack.com/services/YOUR/WEBHOOK/URL}}}}使用示例Claude Code 使用 send-message 向 #alerts 频道发送一条消息构建失败请检查。 [支持文本或 Block Kit 富文本格式]路径二完整 Slack 集成通过 Composio 等平台实现认证让 Claude Code 读取消息、管理频道、操作表情和提醒。快速接入步骤将 Composio MCP 添加到 Claude启动 Claude Code打开 MCP 列表选择 Composio 并完成认证更多能力发送消息到指定频道或设置自然语言定时提醒管理表情和反应归档不再活跃的频道添加 Google Drive 等外部文件共享链接6. 其他实用的 MCP Server类别推荐 Server功能说明代码协作GitHub / GitLab搜索代码、PR 审查、创建 issue、管理仓库项目管理Jira / Linear / Asana查询/创建/更新工单、管理冲刺监控告警Sentry / Datadog查询错误信息、分析性能数据、获取告警设计工具Figma读取设计稿、提取设计 token、生成代码文档查询Context7 / Brave Search获取最新的 API 文档、联网搜索浏览器自动化Playwright网页截图、填写表单、执行 JavaScript7. 多个 MCP Server 串连的实战工作流把多个 MCP Server 组合起来使用可以实现开发工作流的端到端自动化。你可以一次性输入下面这种复合指令让 Claude Code 自主规划并依次调用对应的 MCP 工具帮我检查刚刚 push 的 commit 在 GitHub 上的 CI 状态 - 如果通过在 Jira 上将对应的 ticket 移到 QA 列并在 #deployments Slack 频道发一条成功通知 - 如果失败去 Sentry 查询相关错误整理关键信息发到 #alerts 频道同时在 Jira ticket 上添加一条包含失败原因的评论8. 验证、管理及故障排查验证服务器状态在 Claude Code 会话中输入/mcp可以查看已连接的服务器和可用的工具列表。常用管理命令命令作用claude mcp list列出所有已添加的服务器claude mcp remove name移除指定的服务器claude mcp add-from-claude-desktop从 Claude Desktop 导入已有配置常见问题问题可能原因解决方法/mcp看不到工具服务器未正确启动运行claude mcp list确认状态检查服务器进程是否正常运行工具调用返回认证错误API Token 失效或权限不足重新生成 API Token更新配置文件中的对应变量stdio 通信失败服务器代码中意外使用了console.logstdio 模式下 stdout 需严格保留给 JSON-RPC 协议移除多余的console.log9. 安全与成本建议安全性凭证保护使用.claude/settings.local.json并加入.gitignore或用${VAR}语法引用环境变量只读优先对生产数据库优先选择只读 MCP 服务器本地运行数据库 MCP 服务器只在本地运行不要暴露到公网审计日志记录关键操作便于追踪成本管理MCP Server 会调用外部 API如 GitHub、Jira可能产生额外费用MCP 工具返回的大块数据如数据库查询结果、API 响应会进入上下文被计入 token在提示词中建议 AI 精简 MCP 返回结果定期用/cost监控额外开销10. 下篇预告MCP 把 Claude Code 和外部世界连接了起来。但如何让 AI 记住“你是如何在终端里构建这个项目的”——测试命令、编译指令、项目模式。下一篇我们将学习跨会话项目记忆让 AI 不再每次都需要你重新告诉它你的习惯。下一篇跨会话项目记忆让AI自动记住你的测试命令、编译指令和项目模式思考题自测理解如果要让 Claude Code 分析 Sentry 中过去 24 小时的错误并针对每个错误在 GitHub 上创建对应的 Issue需要用到哪几个 MCP Server这些服务器的工作流程如何串联stdio 与 HTTP 两种传输模式分别适合哪些场景本地数据库应该选用哪一种使用只读模式的 PostgreSQL MCP Server 相比允许写操作的普通数据库连接在什么情境下会更有优势MCP 把门打开了但学会让它记住你的习惯才能成为真正的开发伙伴。下一章我们聊聊 AI 的长期记忆。