ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

GitHub MCP Server 如何在 VS Code 中安装远程服务器并完成 OAuth 登录?

GitHub MCP Server 如何在 VS Code 中安装远程服务器并完成 OAuth 登录? GitHub MCP Server 如何在 VS Code 中安装远程服务器并完成 OAuth 登录【免费下载链接】github-mcp-serverGitHubs official MCP Server项目地址: https://gitcode.com/GitHub_Trending/gi/github-mcp-server当你想让 GitHub Copilot 在 VS Code 的 Agent 模式中直接读取仓库、操作 Issues 和 Pull Request但又不想在本地运行 Docker 容器时正确做法是接入 GitHub 官方托管的远程 GitHub MCP ServerRemote GitHub MCP Server。它由 GitHub 托管无需本地安装运行时URL 为https://api.githubcopilot.com/mcp/。在 VS Code 1.101 及以上版本中远程服务器支持完整的 OAuth 认证你不需要预先创建 Personal Access TokenPAT首次使用时走浏览器授权流程即可。本文适用于 GitHub Copilot in VS Code。前提条件来自项目 README一个支持远程 MCP 服务器的 MCP host即 VS Code 1.101 或更高版本这是远程 MCP 与 OAuth 支持的最低要求组织用户注意如果你的组织分配了 Copilot 席位管理员需要为 VS Code 中的 MCP 访问启用相关策略否则服务器无法连接详见 docs/policies-and-governance.md。方式一一键安装按钮README 的 Remote GitHub MCP Server 一节提供了 Install in VS Code 徽章按钮。点击后会引导你完成安装流程服务器配置等价于{ type: http, url: https://api.githubcopilot.com/mcp/ }完成该流程后在 Copilot Chat 输入框旁切换 Agent mode代理模式远程服务器即会启动OAuth 登录在首次使用时触发。方式二手动配置 mcp.json不点按钮时选择 OAuth 版本的 JSON 块加入你的 MCP host 配置README.md 的 Install in VS Code 一节给出了这一表格{ servers: { github: { type: http, url: https://api.githubcopilot.com/mcp/ } } }两个要点type: http表示这是一个远程 HTTP 服务器而不是本地 stdio 进程配置里没有任何 token 字段这正是 OAuth 路径与 PAT 路径的区别——PAT 路径需要额外的headers和inputs配置见下文可选分支。如果希望工作区共享同一份配置可以把不带外层mcp键的同类配置放到工作区的.vscode/mcp.json文件中README 明确说明这样做的目的是让其他接受相同格式的应用也能复用。完成 OAuth 登录并验证连接安装配置生效后在 GitHub Copilot Chat 窗口切换到Agent mode位于 Copilot Chat 文本输入框旁。触发 OAuth 流程首次使用涉及 GitHub 的操作时VS Code 会发起授权用你的 GitHub 账号完成登录。远程服务器走的是标准 OAuth 2.0 授权码流程见 docs/policies-and-governance.md你无需自己注册 OAuth App——那是 VS Code 这一 host 侧完成的事。登录行为上的一个关键细节远程服务器 OAuth 采用scope challengescope 挑战机制见 docs/scope-filtering.md。与 PAT 模式缺权限就隐藏工具不同OAuth 模式下所有工具都可见当你调用某个需要额外 scope 的工具例如创建 Issue 需要repo而当前 token 还没有该 scope 时服务器会返回一个 OAuth scope challenge由 MCP 客户端提示你授权该 scope授权后操作即可完成。也就是说权限是按需逐步授予的而不是安装时一次性给全。验证是否装好Agent mode 下的 Copilot Chat 可以正常发起对话并调用 github 服务器上的工具按 docs/installation-guides/install-other-copilot-ides.md 的 Usage 一节的通用验证步骤配置变更后完整重启 IDE打开 Agent mode然后直接问一句List recent issues in this repository。如果 Copilot 能返回真实的仓库数据说明连接与认证都已生效。可选分支用 PAT 代替 OAuth如果你的环境例如组织策略、SSO 场景下 OAuth 不可用README 提供了 VS Code 1.101 的 PAT 配置块。${input:github_mcp_pat}是 VS Code 的输入引用保存时 VS Code 会提示你输入 token{ servers: { github: { type: http, url: https://api.githubcopilot.com/mcp/, headers: { Authorization: Bearer ${input:github_mcp_pat} } } }, inputs: [ { type: promptString, id: github_mcp_pat, description: GitHub Personal Access Token, password: true } ] }注意PAT 的 scope 在创建时就固定了。classic PATghp_前缀会触发本地服务器的 scope 过滤逻辑工具可见性与 token scope 直接相关缺 scope 的工具不会出现在列表里。OAuth 与 PAT 的完整差异对比见 docs/scope-filtering.md。限制与常见问题版本远程 MCP 与 OAuth 支持要求 VS Code 1.101更低版本的 VS Code 不在支持范围内。策略拦截组织侧的 MCP servers in Copilot 策略被禁用时远程和本地两种模式、所有认证方式都会被完全阻断远程 OAuth 连接还受临时的 Editor Preview Features 策略影响该策略正在向统一策略迁移。遇到连不上、无报错时先让管理员核对 docs/policies-and-governance.md 中的 Control Mechanisms 一节。不要混淆两套 OAuth 文档docs/oauth-login.md 描述的是本地 stdio 服务器的 OAuth 登录内置 OAuth App、loopback 回调端口、Docker 固定 8085 回调端口等远程服务器与它走的是不同的认证路径。本文的远程 VS Code 场景不涉及GITHUB_OAUTH_CALLBACK_PORT、--oauth-client-id等配置。GitHub Enterprise远程服务器目前只在 GitHub Enterprise CloudGHEC可用GitHub Enterprise Server 不支持远程托管docs/policies-and-governance.md。ghe.com 域名用户可用https://copilot-api.子域.ghe.com/mcp形式的 URL用 OAuth 连接 GitHub Enterprise 时还需要在 VS Code 设置里把 Copilot 指向你的 Enterprise 实例README 的 GitHub Enterprise Cloud with data residency (ghe.com) 一节。下一步如果工具太多、想收窄上下文可以给远程服务器加X-MCP-Toolsets、X-MCP-Readonly等请求头或在 URL 后追加/x/{toolset}、/readonly等路径修饰符完整模式列表见 docs/remote-server.md 的 URL Path Parameters 与 Optional Headers 两节。【免费下载链接】github-mcp-serverGitHubs official MCP Server项目地址: https://gitcode.com/GitHub_Trending/gi/github-mcp-server创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表