在 EasyXAI 中使用
为 GitHub MCP 配置账号,在智能体中读取仓库、Issue 和 PR,并维护 OAuth 或 PAT 连接。
先完成 OAuth 授权或 PAT 连接。两种凭据都从 GitHub 应用的账号连接入口管理。
1. 确认 MCP 能力与账号
进入资源库 → 扩展 → 应用中心 → GitHub → 应用能力,检查当前环境提供的 MCP 能力是否启用。

图 1:测试环境的能力名为 github-oauth,处于启用、尚未连接账号的状态。其他环境以实际列表为准;名称不是要求用户只能选择 OAuth 的凭据类型说明。
| 状态 | 处理方式 |
|---|---|
| 每人用自己的账号 · 你还没有连接 | 使用 OAuth 或 PAT 连接本人账号 |
| 每人用自己的账号 · 已有连接 | 确认选中的是目标 GitHub 账号及凭据 |
| 共用账号 | 管理员指定共享连接,运行使用该连接的权限 |
| 能力停用 | 由管理员启用需要使用的 MCP |
| 还没有可用的能力 | 管理员确认平台能力配置;账号连接不会自动创建 MCP |
平台已提供的 GitHub MCP 使用连接器凭据进行访问。普通成员无需另行安装本地 MCP 服务、填写 Docker 命令或把 Token 发给智能体。
完成 OAuth 或 PAT 连接后,返回“应用能力”,在需要使用的 MCP 旁选择账号,等待「绑定成功」。 即使只有一条有效连接也不能省略;多项能力需要分别配置,账号验证正常不会自动完成所有能力绑定。
GitHub 官方托管 MCP 支持访问令牌认证;其工具集和只读入口由管理员按需要配置,具体工具以当前环境实际提供的列表为准。参考 GitHub 远程 MCP 文档。
2. 给智能体添加 GitHub
- 打开有编辑权限的智能体,进入资源页签。
- 在连接的应用中点击添加,选择 GitHub。
- 按页面提示保存或发布配置,再运行任务。
应用需要在当前工作空间已安装且启用。仅在其他工作空间完成安装,或只在“我的连接”中保存凭据,都不能替代当前智能体的应用配置。
3. 从只读任务开始
给出完整 GitHub 链接,避免同名仓库和编号造成歧义。
总结 Issue
请使用 GitHub 应用读取这条 Issue:<完整 GitHub Issue 链接>。
总结问题、当前状态与最近讨论,并给出来源链接。
本次只读取,不发表评论或修改状态。分析 PR
请使用 GitHub 应用读取这条 PR:<完整 GitHub PR 链接>。
列出涉及文件、主要改动和需要关注的地方。
仅在当前对话中给出结果,不提交 review 或评论。阅读代码
请读取 <完整 GitHub 仓库链接> 的 <分支名> 分支中 <文件路径>,
说明入口逻辑和依赖关系,并附上对应文件链接。| 检查项 | 成功依据 |
|---|---|
| 账号 | “我的连接”验证正常,身份符合预期 |
| 应用 | GitHub 已添加到智能体,所需 MCP 能力启用 |
| 运行 | 运行记录中实际执行了 GitHub 工具且请求成功 |
| 内容 | 对应指定仓库、编号或分支;私有资源也能正确读取 |
模型生成回答不能代替工具调用成功的证据。若没有工具调用,先检查应用和 MCP 配置;若有调用但返回 403、404,按权限排查处理。
4. 需要写入时
创建 Issue、发表评论、提交 review 或修改代码,需要同时满足:工具可用、凭据具备相关写权限、运行账号本身有权执行,以及任务明确指定要修改的对象和内容。
如果管理员配置的是只读 MCP 工具集,即使 Token 有写权限,也不会因此提供写入工具。反过来,提供写工具也不会让只读 Token 自动获得写权限。
资源库支持范围
当前 GitHub 不在“导入 → 外部数据源”的支持列表中。 连接 GitHub 不会自动导入仓库文件、持续同步 Issue 或建立向量索引。读取 GitHub 内容请通过上述应用能力完成。
凭据维护
| 情况 | 操作 |
|---|---|
| PAT 到期或撤销 | 生成合适的新 PAT,从已有连接的“重新连接”入口更新 |
| OAuth 授权失效或刷新令牌过期 | 从已有连接重新完成 GitHub 授权 |
| 新增私有仓库 | PAT 检查所选仓库;OAuth 检查 GitHub App 安装范围 |
| GitHub App 提升权限 | 按 GitHub 提示由安装方批准更新,必要时成员重新授权,再验证目标工具 |
| 团队共用账号变化 | 管理员更换共享连接并验证依赖能力 |
| 停止使用 | 先确认依赖,再删除 EasyXAI 连接;需要撤销第三方权限时,还需在 GitHub 撤销 Token 或应用授权 |
删除 EasyXAI 连接与卸载 GitHub App 是不同操作;卸载共享 App 可能影响其他成员。更多说明见常见问题。