GitHub MCP 使用与排障
在 Agent 中操作仓库、Issue 和 PR，并定位权限、工具或本地运行问题。
This page has not been translated into English yet. The original Chinese version is shown below.
完成服务器配置后，可以从 IDE Chat 查询仓库、列出 PR，或在有权限时创建 Issue 等。MCP 提供操作能力，任务是否执行成功仍取决于工具配置、认证和 GitHub 资源权限。
使用步骤
- 打开 Copilot Chat 并选择 Agent。
- 打开工具选择器，展开 GitHub 服务器，确认目标工具已启用。
- 提交清楚的任务，说明仓库及要查询或修改的对象。
- 若界面要求额外权限或参数，按提示处理。
- 检查返回结果；写入任务确认对应 GitHub 对象是否已创建或更新。
VS Code 使用 Configure tools；Visual Studio 在工具列表中展开 GitHub；JetBrains、Xcode、Eclipse 也从 Chat 工具按钮查看。具体打开 Chat 的入口见聊天模式。
认证失败
确认 IDE 已登录正确 GitHub 账号，并且 MCP 的独立认证已经完成。使用 PAT 时，检查令牌是否有效、输入是否正确，以及 scope 和组织限制是否满足操作要求。
服务器对所有用户可用，不等于每个工具都免费开放；对应功能需要付费许可时，MCP 工具也继承这一前提。
工具未出现
检查当前处于正确的 Agent、服务器配置已加载、工具选择器已启用目标工具。某个工具集可能没有加入默认集合，特别是 Spaces 等远程能力，见工具集配置。
同时核对当前连接的是本地还是远程服务，以及操作目标是否属于正确 GitHub 主机。企业实例的配置见企业 MCP。
服务启动或运行失败
查看 MCP 输出日志。使用本地 Docker 形式时，确认 Docker 运行环境正常；远程形式则检查网络与认证。官方通用排障还建议在修改配置后尝试重启 MCP 服务器或 IDE。
企业代理与证书问题可按IDE 网络排障定位，不要用扩大 PAT 权限替代网络修复。
Push protection 阻止写入
GitHub MCP 的写入也可能触发 push protection。先阅读阻止原因，按 GitHub 的官方处理流程处置；官方说明符合条件时可提交理由申请绕过，但这不是一般工具授权的替代操作。