2026年，MCP（Model Context Protocol）已成为AI Agent的"标准USB-C接口"。今天手把手带你给Claude Code接上4个必备MCP服务器，让它从"能聊天的AI"变成"能干活的神器"。

什么是MCP？一句话解释

MCP是Anthropic在2024年底推出的开放标准，2025年12月移交给Linux基金会治理。本质就是让AI助手通过统一协议连接外部工具——就像USB-C让不同的设备插上同一个接口就能工作。

没有MCP之前：你想让Claude Code帮你查GitHub Issue，得手动复制粘贴、切浏览器、再粘贴回来。
有了MCP之后：Claude Code自动调GitHub API查看Issue列表，找到对应PR，看diff，判断修复是否合理——全程你只需在终端里说一句话。

截至2026年7月，MCP生态已有官方SDK支持5种语言、数百个社区服务器、公开注册中心。Claude Code、Cursor、Codex、Hermes Agent都在原生支持。

5分钟极速接入（实测）

前置条件

Claude Code已安装并认证
终端打开任意项目目录（空的也行）
Node.js 18+ （跑Playwright MCP用）

Step 1：接入第一个MCP服务器（30秒）

在终端执行（不要在claude会话里执行）：

claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp

这条命令做了什么：
- claude mcp add：注册一个MCP服务器
- --transport http：这是个远程HTTP服务器（不是本地进程）
- claude-code-docs：你给服务器起的名字（随便取，Claude会用它标记工具来源）
- 最后的URL：服务器的地址

返回 Added HTTP MCP server claude-code-docs 说明注册成功。

Step 2：验证连接（10秒）

claude mcp list

看到 ✓ Connected 就是通了。常见状态对照：

状态	含义
`✓ Connected`	就绪，可以使用
`! Needs authentication`	需要浏览器登录或Token
`✗ Failed to connect`	服务器没响应（检查URL）
`⏸ Pending approval`	项目级服务器待审批

Step 3：在会话中实际使用

claude

进去后直接说：

用 claude-code-docs 服务器查一下 MCP_TIMEOUT 环境变量的作用

Claude会调用MCP工具，返回结果会标注 [claude-code-docs] 来源。第一次调用会弹出权限确认，点允许即可。

搞定！你已经接入了第一个MCP服务器。

一人公司必备的4个MCP服务器

上面是演示案例，下面是真正能帮你干活的组合：

1. 文件系统（Filesystem）——读写项目外的文件

场景：你的代码在 ~/project-a/，但需要读取 ~/docs/ 下的设计文档。Claude Code默认只能访问当前工作目录，接上这个MCP就能扩展范围。

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /home/user/docs /home/user/archive

参数说明：空格分隔多个允许的目录路径。-- 之后是所有传给服务器进程的参数。

2. GitHub MCP —— Issue/PR/Release全自动

场景：每天手动查GitHub Issue很烦？接上后Claude能直接列出Issue、读取PR diff、查看Release notes。

claude mcp add github --transport http https://api.githubcopilot.com/mcp --header "Authorization: Bearer ghp_你的Token"

Token生成：GitHub Settings → Developer settings → Personal access tokens → Fine-grained tokens，只勾选 Read access to issues 即可（最小权限原则）。

实战用法：

帮我看看 hermes-agent 仓库最近3天的新Issue，按标签分类，有P0的标红

3. Playwright MCP —— 浏览器自动化

场景：竞品调研、网页截图、自动填表、Lighthouse审计。

claude mcp add playwright -- npx -y @playwright/mcp@latest

这个命令会自动下载Playwright包（首次较慢，给60秒超时：MCP_TIMEOUT=60000 claude）。

实战用法：

打开 theverge.com/ai-artificial-intelligence，截图前3篇文章的标题，汇总成表格

4. Git MCP —— 结构化Git操作

场景：Claude Code虽然能跑shell命令，但 git log 输出经常占满上下文窗口。用Git MCP可以让模型直接调用结构化工具，省token效果更好。

claude mcp add git -- npx -y @modelcontextprotocol/server-git --repository /path/to/your/repo

实战用法：

帮我看看这个分支上最近3次commit改了哪些文件，用git blame查一下这几行是谁改的

配置管理：.mcp.json 和 ~/.claude.json

claude mcp add 命令实际上在写配置文件。有三个作用域：

作用域	配置文件	谁可见
`local`（默认）	`~/.claude.json`	只有你，只有当前项目
`project`	项目根目录的 `.mcp.json`	全团队（提交到Git）
`user`	`~/.claude.json` 顶层	只有你，所有项目

推荐实践：
- 个人工具用 user 域：claude mcp add --scope user ...
- 团队共享用 project 域：claude mcp add --scope project ...，然后提交 .mcp.json
- 敏感凭证（API Key）不要在 .mcp.json 里硬编码，用环境变量代替

常见坑和解决方案

坑1：stdio服务器连接超时

症状：claude mcp list 显示 ✗ Failed to connect

原因：npx 首次下载包超过30秒默认超时。

解决：

MCP_TIMEOUT=60000 claude mcp list

坑2：上下文窗口爆炸

症状：接了4-5个MCP服务器后，Claude反应变慢、经常说"上下文太长"

原因：每个MCP服务器的工具名和描述都会加载到每次会话的上下文中。一个Playwright MCP就有30+工具，4个服务器轻松吃掉几千token。

解决：
- 只装真正需要的（参考上面的4选1原则，不是越多越好）
- 不用的服务器及时 claude mcp remove <名称>
- 团队项目里只分享必要的，私人工具放 user 域

坑3：OAuth登录在headless环境失败

症状：服务器要求浏览器登录，但你在SSH/CI环境里

解决：用API Key代替OAuth。大部分HTTP MCP服务器同时支持两种认证，传 --header "Authorization: Bearer <key>" 即可。

坑4：修改 .mcp.json 后不生效

原因：Claude Code只在会话启动时读取配置。

解决：退出当前 claude 会话重新进入。如果是之前拒绝过的项目级服务器，先执行：

claude mcp reset-project-choices

总结：一人公司的MCP最小套装

✅ Filesystem MCP — 跨目录读写（0配置）
✅ GitHub MCP — Issue/PR自动化（需要PAT）
✅ Playwright MCP — 浏览器自动化（需要Chrome）
✅ Git MCP — 结构化版本控制（0配置）

这四个加起来，覆盖了AI创业者80%的日常自动化场景。装好之后，你的Claude Code就从一个"智能问答机器人"变成了一个能读写文件、查Issue、操作浏览器、管理代码的全能AI助手。

下一步：装上这四个MCP，然后试试这句 prompt：

用playwright打开我的GitHub仓库主页，截图，然后用github MCP列出所有open的Issue，整理成优先级表格

AI创业 #ClaudeCode #MCP #Agent工坊 #一人公司 #AI工具