跳转到主要内容

Claude Code 最值得先加的 MCP(2026):按工作流选第一批集成

先接最能补上当前缺口的一个 MCP:PR 和 issue 选 GitHub,版本文档选 Context7,页面验证选 Playwright,线上错误选 Sentry。接入完成的标准,是认证通过、所需工具可用,并实际读到任务需要的资料。

LaoZhang AI Team发布于更新于 22 分钟阅读
文章目录
Claude Code MCP 起步选择图,展示仓库、文档和浏览器工作流

Claude Code 的第一批 MCP,按你反复缺少的资料或操作来选:GitHub 补 PR 和 issue,Context7 补库的版本文档,Playwright 补浏览器验证,Sentry 补线上错误上下文。 先接其中最需要的一个,做到能返回有用结果,再判断是否需要第二个。

如果本地文件、已有命令行工具或浏览器集成已经能完成任务,可以先不加 MCP。例如,已经授权的 GitHub CLI 能读取 PR 信息;Context7 和 Playwright 也提供 CLI + Skills 路线。MCP 的价值在于把这些能力作为工具接入会话,并不意味着没有 MCP 就无法访问外部资料。GitHub CLI 文档、Context7 项目说明、Playwright MCP 项目说明

下面的接入方法依据 2026 年 10 月 7 日核对的官方文档。命令和任务提示是供你操作的示例,本文没有进行账户登录、服务器安装或真实工具调用;成功与否应以你的会话状态和返回资料判断。

先用一张路线板决定第一步

GitHub、Context7、Playwright 和 Sentry 对应的任务缺口与首次读取目标示意

你反复遇到的问题优先考虑维护者与连接形式第一次要拿到的结果
本地代码看得到,但不知道 PR 讨论、issue 背景和远程状态GitHub MCPGitHub 维护;官方托管 HTTP,也有本地运行方式指定 PR 的标题、状态和相关讨论
框架升级后,生成的代码还在用旧方法Context7Upstash 维护;托管 MCP、插件或本地 stdio与实际依赖版本匹配的文档段落
修了页面,却不知道实际操作是否正常Playwright MCPMicrosoft 维护;本地 stdio指定页面的结构和可复现操作结果
错误只在线上出现,代码里找不到触发背景Sentry MCPSentry 托管 HTTP,使用 OAuth指定组织、项目和时间范围的错误资料

这四个选项覆盖不同缺口,没有统一的必装顺序。只需要查看一个已有 PR,先用现有 gh 工作流也合理;如果每天都要在会话里连续查看 PR、issue 和讨论,GitHub MCP 才更值得接入。前端项目同理:已有浏览器工具能完成验证,就不用为了名单完整再装 Playwright。

不要把旧目录里的同名包直接当成当前实现。@modelcontextprotocol/server-github 等参考服务器已被归档;GitHub 当前维护的是 github/github-mcp-server。MCP 参考仓库也明确区分教学实现与服务器目录,出现于列表不等于获得生产或安全认证。MCP 参考服务器仓库

先分清传输方式和配置作用域

接入前确认 Claude Code 已经安装并完成自身登录。以下命令在终端执行,/mcp、插件命令和任务提示则在 Claude Code 会话里使用。

HTTP、stdio 是“怎么连接”;local、project、user 是“配置给谁用”。 两者可以自由组合:托管 HTTP 服务可以只对当前项目的你可见,本地 stdio 进程也可以配置为跨项目使用。

CLI 配置作用域保存位置适合什么时候用
local,默认值~/.claude.json 中当前项目对应的条目你自己在这个项目试用
project仓库根目录 .mcp.json团队需要共享同一服务器配置
user~/.claude.json 顶层配置你在多个项目都要使用

远程托管服务优先按其文档使用 HTTP;SSE 已被 Claude Code 文档列为弃用方式。当前文档说明,从 v2.1.265 起,HTTP 连接在适用情况下会自动回退到 SSE,因此旧服务的行为还要结合客户端版本判断。本地 stdio 则由 Claude Code 启动一个子进程,依赖本机的运行环境。stdio 命令中的 -- 用于分隔 Claude 的选项与服务器命令,不能随意省略。Claude Code MCP 文档

普通个人试用先选 local。只有确实需要共享端点、工具选择等配置时,才放入 .mcp.json。下面 GitHub 的项目文件示例适合需要共享配置的仓库,其他示例使用个人范围;这不是从低级到高级的升级顺序。

真正配得上第一批位置的 Claude Code MCP

GitHub:把远程 PR 和 issue 带进会话

GitHub MCP 适合补充本地 checkout 没有的协作上下文,例如 PR 状态、issue 讨论和 review。托管端点由 GitHub 提供;GitHub Enterprise Server 不使用同一条托管接入路线。GitHub MCP Server

如果你已经有可用的 GitHub CLI,先试现有入口即可:

bash
gh pr view 42 --repo OWNER/REPO --comments

把 OWNER/REPO 和 42 换成你有权访问的仓库与 PR。它适合直接读取一个 PR;当你希望 Claude 在连续任务中自己调用 GitHub 工具时,再接 MCP。gh pr view 文档

Claude Code 的托管接入可以按 GitHub 专用指南使用 PAT。 不要因为别的客户端能用 OAuth,就假设 Claude Code 的远程配置也会自动完成同样的 OAuth 流程。GitHub 说明远程 OAuth 需要客户端注册应用支持,本地 Docker 的 OAuth 又是另一条路线。Claude Code 接入指南

为首次读取选一个只允许目标仓库和必要操作的 PAT,并通过你的终端或开发环境的秘密管理方式提供 GITHUB_MCP_PAT。不要把真实 token 写入仓库。需要团队共享配置时,在仓库根目录创建或合并以下 .mcp.json;已有文件要保留其他条目:

json
{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/readonly",
      "headers": {
        "Authorization": "Bearer ${GITHUB_MCP_PAT}"
      }
    }
  }
}

${GITHUB_MCP_PAT} 是环境变量引用,不是要填进文件里的 token。每个使用者都要提供自己的凭据。JSON 的 type: http 不能漏掉:普通服务器条目未写类型会默认按 stdio 解释,只有 URL 的条目无法因此变成 HTTP 服务。Claude Code 配置说明

/readonly 用来暴露读工具,方便从读取任务起步;它不会撤销 PAT 本身已有的写权限。需要缩小工具范围时,GitHub 还提供单个工具集的 /x/{toolset}/readonly 路径和工具选择请求头。未知工具集可能被忽略,所以仍要检查实际加载的工具,不能只凭配置文字认定限制已生效。GitHub 远程服务器说明

回到该仓库的 Claude Code 交互会话,按提示批准项目配置,再打开 /mcp 检查 GitHub 状态。可以提出这样的读取任务:

请用 GitHub MCP 读取 OWNER/REPO 的 PR #42。
列出标题、当前状态和最近与修复方案有关的讨论,并附原始链接。
只读取信息,不发布评论、不修改 PR;如果无法访问,请保留工具错误。

把占位符换成真实目标后,确认会话调用了 GitHub 工具,返回的仓库、PR 编号和内容都匹配。Claude 自己给出一段像 PR 摘要的回答,不足以证明它访问了 GitHub。

Context7:先解决依赖版本和 API 用法不匹配

Context7 适合需要查询库文档的任务。它的两个主要 MCP 工具是 resolve-library-id 和 query-docs:先确定库的标识,再查询相关文档。文档是否覆盖你的版本、回答是否与实际依赖一致,仍需要核对。Context7 项目说明

在交互式 Claude Code 中,可以使用其官方插件路线,逐条执行:

/plugin marketplace add upstash/context7
/plugin install context7@context7-marketplace

安装后重启 Claude Code,打开 /mcp,完成 Context7 的浏览器登录。这条插件路线连接托管 MCP,不要求本机安装 Node、npm 或 npx,也不读取 CONTEXT7_API_KEY。Context7 的 Claude Code 文档

若你在 SSH、无浏览器或 CI 环境中使用,改按同一官方文档的 API key 路线处理。手动托管 /mcp 使用 Bearer 服务 key,远程 OAuth 的手动端点是 /mcp/oauth;本地 stdio 使用 API key。npx ctx7 setup --claude 也有 Node 18+、设备 OAuth、生成 key 和安装适用 skill 的步骤,不是一条无认证的查询命令。选适合环境的一条路线即可,不必把插件、手动 MCP 和 CLI 都装一遍。客户端配置与认证

第一次验证应给出真实依赖版本和具体问题,例如:

先查看本项目 package.json 和锁文件,确认 @tanstack/react-query 的版本。
再通过 Context7 找到对应库的文档,查询该版本中 invalidateQueries 的用法。
请注明使用的 library ID、文档版本和依据;若没有匹配版本,先说明缺项,暂不改代码。

你要看的是实际工具调用、匹配的 library ID 和返回的 API 说明。如果查到的版本与锁文件不同,先解决版本差异,再让 Claude 按文档修改代码。接上文档服务可以增加可核验依据,不能保证生成代码一定正确。

Playwright:从一个页面、一条操作路径开始

Playwright MCP 适合需要在浏览器中探索页面、复现交互和查看页面结构的任务。Microsoft 维护的实现通过结构化无障碍快照提供页面信息。本地包要求 Node 18+;如果客户端已有合适的浏览器集成,可以继续使用现有能力。Playwright MCP 项目说明

个人项目试用时,在终端注册:

bash
claude mcp add --transport stdio --scope local playwright -- npx -y @playwright/mcp@latest --isolated

这个配置会在连接时运行 npm 包,并非只写入一个网址。--isolated 使用隔离的浏览器上下文,关闭会话或浏览器后不会保留其存储状态;因此它适合先验证无需登录的页面,不能指望自动继承你日常浏览器的登录。

例如,启动你自己的开发站点后,可以让 Claude:

用 Playwright MCP 打开 http://localhost:3000/products。
查看页面结构,找到筛选控件,选择一个现有选项。
报告筛选前后的可见产品和当前 URL,并说明实际执行的操作。
只验证这条浏览路径,不提交订单、不登录账号。

确认会话确实调用了浏览器工具,并从返回的页面快照或操作结果中看到目标页面与筛选变化。若你尚未启动站点,连接失败不代表 MCP 包安装失败,要先区分站点不可达和服务器不可用。

默认持久化 profile、隔离模式和连接现有浏览器的扩展模式各有用途。多个客户端共用同一个持久化 profile 可能冲突;访问已登录浏览器还涉及额外授权。隔离模式和来源限制都不是安全边界,首次验证宜从自己允许访问的页面开始。官方也明确指出 MCP 本身不构成安全边界。Playwright profile 与安全说明

Sentry:只有线上排障确实需要时才靠前

已经在 Sentry 中记录错误、经常需要定位线上问题,才值得把 Sentry 放进第一批。它补充错误与运行信息,不会因为安装了连接器就为尚未接入 Sentry 的应用生成监控数据。

Sentry 托管端点使用 OAuth。在终端加入当前项目的个人配置:

bash
claude mcp add --transport http --scope local sentry https://mcp.sentry.dev/mcp

进入 Claude Code 后打开 /mcp,选择 Sentry 并完成浏览器授权。如果你的任务只围绕固定组织和项目,可以按官方路由使用 https://mcp.sentry.dev/mcp/{organizationSlug}/{projectSlug},把两个占位符替换为真实值。限定路径会默认使用对应组织和项目,并隐藏不必要的发现工具,但不等于仅凭 URL 就缩小了账号的全部授权。Sentry MCP 官方说明

首次任务可以限定为:“读取指定项目最近 24 小时的一条未解决错误,给出 issue 链接、错误信息和与本仓库排查有关的上下文;不修改状态。”检查工具返回的项目、时间范围和 issue 是否对应。当前账号没有相应项目访问权时,添加端点不会替你获得权限。

从“已添加”到真正可用,要核对四件事

上面的路线只选一条先试。终端提示 Added 或写入配置,证明的是注册成功;接下来还需要检查连接和结果。Claude Code MCP 快速入门

  1. 配置在正确范围。 在你要工作的项目目录中运行 claude mcp list,必要时用 claude mcp get github 查看选中条目;其他服务器换成对应名称。确认端点或启动命令属于预期服务。
  2. 连接与认证通过。 在会话里打开 /mcp。Needs authentication 应先完成服务登录;Pending approval 应检查项目批准;Failed 或连接错误应读具体错误,而不是继续要求模型猜答案。
  3. 任务所需工具可用。 即使显示 Connected,仍可能出现工具获取失败。检查实际可调用的工具,并确认 GitHub 的工具过滤或 Context7 的文档工具没有被遗漏。
  4. 实际读取结果正确。 发出一个范围小的任务,核对有明确服务器身份的工具调用、返回对象和内容。PR 编号、库版本、页面 URL、Sentry 项目等应与任务一致;错误也要作为结果保留。

连接检查可能启动本地服务器进程或访问远程服务,执行前应确认这是你准备使用的集成。缓存的工具发现信息和一句“连接好了”,都不能替代这次实际读取。

看到的症状先查什么用什么结果继续判断
已添加,但当前会话找不到项目目录、作用域、是否重启会话、同名条目list、get 与 /mcp 是否指向同一配置
远程服务要求认证PAT/key 是否属于这个服务,OAuth 是否完成登录后的状态和一次有权限的读取
stdio 进程起不来运行环境、命令参数、-- 分隔、进程错误服务器能启动并列出工具,而非仅 npm 命令存在
Connected,但没有目标工具工具发现错误、过滤条件、会话中的实际工具所需工具出现,并能返回目标对象
工具返回内容,却答非所问仓库、版本、URL、项目和查询范围原始结果与任务一致,再形成答案

什么时候才该共享 .mcp.json

HTTP 与 stdio 传输方式、个人与项目配置作用域以及成员独立凭据的关系示意

当团队需要相同的服务端点和工具配置时,.mcp.json 可以减少重复设置。它共享的是配置,不是 OAuth 登录状态,也不是某个人的 PAT。每个成员都要有自己的服务权限;缺少凭据时,文件已经存在也不能完成读取。

交互式 CLI 首次使用项目配置通常需要批准。非交互式 -p、Agent SDK、云端等运行环境的加载与审批行为有不同条件,不能推断每种环境都会弹同一个确认框;也不应为了让连接成功而跳过必要的权限控制。Claude Code 作用域与审批说明

排查重复配置时还要注意:在普通 CLI 中,同名条目按 local、project、user 的顺序优先选取,选中的是整条配置,不会把一个条目的 URL 和另一个条目的 headers 合并。托管策略和其他客户端界面可能有不同规则。你修改了 .mcp.json,却仍使用旧端点,就应先检查当前项目的同名 local 条目。

插件也不必等到团队规模变大才用。Context7 的插件就是适合交互式个人接入的入口。判断标准应是认证方式、当前环境和维护者文档,而不是一律从“手动配置”升级到“插件”。

如果你已经在 claude.ai 授权某个连接器,也别假定任意 Claude Code 登录方式都会自动带入它。CLI 获取这些连接器依赖适用的订阅凭据和授权,API key、第三方提供方等路径不会自动等价;Desktop 和云端还有各自的交付条件。先检查当前会话已有连接,避免重复添加。Claude Code 连接器说明

第一条集成有效后,什么时候继续加

当第一次读取已经解决问题,就先停下来使用它。下一条 MCP 应对应新的重复缺口:有了 GitHub 后仍查不清依赖 API,再考虑 Context7;文档正确了但页面行为仍不明,再考虑浏览器工具。没有新的任务缺口,更多服务只会增加认证、配置和维护对象。

服务器数量也不能直接推导上下文占用。当前 Claude Code 工具搜索默认延迟加载工具定义,但仍会提供工具名称和服务器说明;支持行为还受版本、模型及接入路径影响。工具返回的大段日志和页面内容,同样会影响会话。需要更多服务器时,先把第一次读取缩小到所需资料,不要靠数量估计速度或费用。Claude Code 工具搜索说明

已经接好却频繁压缩上下文,可以继续读 Claude Code MCP 上下文爆掉:排查占用、工具搜索与输出压缩。如果你缺的其实是公司内部 API 的工具入口,而不是这几家服务的接入,转到 Claude MCP 内部工具 API 集成,再决定直连工具还是自建 MCP。

FAQ

Claude Code MCP 推荐,新手应该先装哪一个?

先选你今天能给出明确读取任务的那个。缺 PR 和 issue 背景选 GitHub;需要匹配依赖版本的文档选 Context7;要复现页面操作选 Playwright;已有 Sentry 监控且需要线上排障再选 Sentry。已有 CLI 或浏览器工具够用时,可以暂不添加。

local MCP 就是本地 stdio 吗?

不是。local 是当前项目中个人可见的配置作用域;stdio 是本机启动服务器进程的传输方式。GitHub、Sentry 这样的托管 HTTP 服务也能使用 local 作用域。两者决定的事情不同。

为什么显示 Added,Claude 还是不能用?

Added 表示配置写入,不代表认证或工具调用成功。到 /mcp 查看是否需要登录、批准或处理连接错误,再确认工具存在,最后读取一个真实目标。只有返回了对应资料,才完成这条接入路径。

Context7 必须安装 Node 和申请 API key 吗?

不一定。当前 Claude Code 插件路线使用托管 MCP 和浏览器登录,不要求本地 Node,也不手动读取 CONTEXT7_API_KEY。CLI setup 和本地 stdio 是另一条路线,前者要求 Node 18+,并有认证、生成 key 的步骤;手动托管接入也要按其端点区分 Bearer key 和 OAuth。

MCP 和 Skills 应该二选一吗?

不必。MCP 提供工具接口,Skills 提供可复用的工作说明;一个 skill 也可以调用已经授权的外部 CLI。选型应看任务是否已有可用工具,以及是否需要把它以 MCP 工具形式接入会话。安装 skill 本身不会授予缺失的服务凭据。

2026 年的工具搜索是否让 MCP 不再占上下文?

不会。延迟加载减少了启动时直接放入的工具定义,但工具名称、服务器说明、实际加载的定义和调用结果仍有成本。也不能保证所有模型和接入路径都使用相同行为。出现占用问题应查看实际会话,而不是按装了几个服务器判断。

官方或开源 MCP 都免费、安全吗?

不能这样推断。MCP 没有统一收费表;服务套餐、托管、本地运行和模型调用分别可能有成本。官方维护身份能帮助核对来源,也不能替代服务授权和任务范围。服务器返回的 issue、网页或日志是资料,不能自行变成修改权限、泄漏凭据或执行额外操作的指令。

参考来源12

本文引用的外部页面,按正文出现顺序排列。最后更新于 2026年10月8日。

  1. 1.GitHub CLI 文档cli.github.com/manual/gh_pr_view
  2. 2.Context7 项目说明github.com/upstash/context7
  3. 3.Playwright MCP 项目说明github.com/microsoft/playwright-mcp
  4. 4.MCP 参考服务器仓库github.com/modelcontextprotocol/servers
  5. 5.Claude Code MCP 文档code.claude.com/docs/en/mcp
  6. 6.GitHub MCP Servergithub.com/github/github-mcp-server
  7. 7.Claude Code 接入指南github.com/github/github-mcp-server/blob/main/docs/installation-guides/install-claude.md
  8. 8.GitHub 远程服务器说明github.com/github/github-mcp-server/blob/main/docs/remote-server.md
  9. 9.Context7 的 Claude Code 文档context7.com/docs/clients/claude-code
  10. 10.客户端配置与认证context7.com/docs/resources/all-clients
  11. 11.Sentry MCP 官方说明mcp.sentry.dev
  12. 12.Claude Code MCP 快速入门code.claude.com/docs/en/mcp-quickstart
更多 Claude Code