GitHub MCP Server 如何在 Claude Code 中配置远程服务器并验证连接【免费下载链接】github-mcp-serverGitHubs official MCP Server项目地址: https://gitcode.com/GitHub_Trending/gi/github-mcp-server要让 Claude Code CLI 直接调用 GitHub 的能力查 Issue、读仓库、提 Pull Request 等可以把它接入托管的远程 GitHub MCP Server。这条路径不需要本地 Docker也不需要运行本地二进制在系统终端里执行一条claude mcp add-json命令完成注册重启 Claude Code 后用claude mcp list验证连接是否建立。下面按 install-claude.md 给出的步骤走一遍完整流程。适用前提文档明确列出已安装 Claude Code CLI已有一个 GitHub Personal Access TokenPAT远程服务器走 Streamable HTTP文档注明远程服务器要求客户端支持 Streamable HTTP需要检查你的 Claude 版本文档推荐在项目目录内打开 Claude Code这样配置的作用范围更清晰。准备 PAT可选的 .env 存储方式为避免把 token 硬编码进命令文档给出一种常见做法把 token 存到项目根目录的.env文件里GITHUB_PATyour_token_here其中your_token_here替换为你的真实 token。然后把它和.mcp.json加入.gitignoreecho -e .env\n.mcp.json .gitignore这条命令会向当前项目的.gitignore追加两行不改动已有内容。如果不用.env直接把 token 写进下面的命令也可以。添加远程服务器配置在系统终端不是Claude Code CLI 内部执行以下命令YOUR_GITHUB_PAT替换为你的真实 tokenclaude mcp add-json github {type:http,url:https://api.githubcopilot.com/mcp,headers:{Authorization:Bearer YOUR_GITHUB_PAT}}这个add-json格式适用于Claude Code 2.1.1 及以上版本。2.1.0 及更早版本使用文末的旧版命令格式。可选用环境变量避免 token 出现在 shell 历史里前提是先按上一节建好.env。Linux/macOSexport GITHUB_PAT$(grep ^GITHUB_PAT .env | cut -d -f2-) claude mcp add-json github {type:http,url:https://api.githubcopilot.com/mcp,headers:{Authorization:Bearer $GITHUB_PAT}}Windows PowerShell$githubPatLine Get-Content .env | Select-String ^\s*GITHUB_PAT\s* | Select-Object -First 1 $env:GITHUB_PAT ($githubPatLine.Line -split , 2)[1].Trim().Trim().Trim() claude mcp add-json github {type:http,url:https://api.githubcopilot.com/mcp,headers:{Authorization:Bearer $env:GITHUB_PAT}}文档同时提醒claude mcp add-json在添加 HTTP 服务器时可能返回Invalid input。遇到这个报错改用下面的claude mcp add --transport http旧版格式即可其余步骤不变。可选用 --scope 决定配置存放位置在命令末尾追加--scope参数local默认仅对你自己、仅在当前项目可用旧版中叫projectproject写入项目的.mcp.json与项目内所有人共享user对你自己的所有项目可用旧版中叫global。例如claude mcp add-json github ... --scope user可以让该服务器在全部项目中可用。重启并验证连接执行完添加命令后重启 Claude Code然后运行claude mcp list claude mcp get githubclaude mcp list用于确认 GitHub 服务器是否已出现在配置列表中claude mcp get github查看该服务器的详情。在 Claude Code 会话内还可以用/mcp命令查看 MCP 服务器状态和日志。Claude Code 2.1.0 及更早版本旧版命令格式2.1.0 或更早版本使用如下格式终端中执行YOUR_GITHUB_PAT替换为真实 tokenclaude mcp add --transport http github https://api.githubcopilot.com/mcp -H Authorization: Bearer YOUR_GITHUB_PAT配合环境变量从.env读取claude mcp add --transport http github https://api.githubcopilot.com/mcp -H Authorization: Bearer $(grep GITHUB_PAT .env | cut -d -f2)Windows PowerShell 下如果报missing required argument name把服务器名github放到claude mcp add紧跟的位置$pat YOUR_GITHUB_PAT claude mcp add github --transport http https://api.githubcopilot.com/mcp/ -H Authorization: Bearer $pat执行后同样重启 Claude Code再用claude mcp list和claude mcp get github验证。连接不正常时按现象排查安装文档把常见问题按现象分了三组可对照检查认证失败Authentication Failed确认 PAT 带有reposcope确认 token 没有过期。远程服务器连接问题Remote Server核对 URL 是否为https://api.githubcopilot.com/mcp远程服务器要求 Streamable HTTP 支持检查 Claude 版本是否满足。服务器未启动 / 工具不显示Server Not Starting / Tools Not Showing运行claude mcp list查看当前已配置的 MCP 服务器检查配置中的 JSON 语法是否正确如果 PAT 是通过环境变量传入的确认变量被正确读取重启 Claude Code 并检查/mcp命令的输出仍不工作时运行claude mcp remove github删除该服务器换一种方式重新走一遍配置流程确认你是在正在工作的那个项目目录内运行 Claude Code保证 MCP 配置的作用范围正确查看日志Claude Code 用/mcp命令。另外server-configuration.md 的故障表指出如果在X-MCP-Tools头里传了非法的工具名服务器会启动失败需要核对工具名拼写是否与文档一致。可选连接建立后收窄工具范围远程服务器支持按 URL 路径和请求头选择工具集详见 remote-server.md。常用手段URL 路径/x/{toolset}启用单个工具集例如https://api.githubcopilot.com/mcp/x/issues路径末尾加/readonly限定为只读工具X-MCP-Toolsets头启用多个工具集逗号分隔如repos,issues未知或无效的工具集会被静默忽略不影响服务器启动X-MCP-Tools头精确到单个工具注意无效的工具名会抛错并阻止服务器启动X-MCP-Readonly: true只启用读工具。文档给出的头部配置示例JSON 形态与claude mcp add-json的第二个参数相同可将其作为参数内容传入{ type: http, url: https://api.githubcopilot.com/mcp/, headers: { X-MCP-Toolsets: repos,issues, X-MCP-Readonly: true, X-MCP-Lockdown: false } }两点与验证直接相关的限制默认工具集为context、issues、pull_requests、repos、users见 server-configuration.md对 classic PATghp_前缀服务器会按 token 的 scope 在启动时过滤工具你只会看到有权限使用的工具——如果看到工具比预期少先检查 PAT 的 scope而不是怀疑配置错误。完整的工具集与 URL 对照表、以及仅在远程服务器可用的工具如create_pull_request_with_copilot见 remote-server.md。【免费下载链接】github-mcp-serverGitHubs official MCP Server项目地址: https://gitcode.com/GitHub_Trending/gi/github-mcp-server创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考