EasyXAI 文档
连接器GitHub

在 EasyXAI 中使用

为 GitHub MCP 配置账号,在智能体中读取仓库、Issue 和 PR,并维护 OAuth 或 PAT 连接。

先完成 OAuth 授权PAT 连接。两种凭据都从 GitHub 应用的账号连接入口管理。

1. 确认 MCP 能力与账号

进入资源库 → 扩展 → 应用中心 → GitHub → 应用能力,检查当前环境提供的 MCP 能力是否启用。

EasyXAI GitHub 应用能力显示 github-oauth MCP 与个人账号连接状态

图 1:测试环境的能力名为 github-oauth,处于启用、尚未连接账号的状态。其他环境以实际列表为准;名称不是要求用户只能选择 OAuth 的凭据类型说明。

状态处理方式
每人用自己的账号 · 你还没有连接使用 OAuth 或 PAT 连接本人账号
每人用自己的账号 · 已有连接确认选中的是目标 GitHub 账号及凭据
共用账号管理员指定共享连接,运行使用该连接的权限
能力停用由管理员启用需要使用的 MCP
还没有可用的能力管理员确认平台能力配置;账号连接不会自动创建 MCP

平台已提供的 GitHub MCP 使用连接器凭据进行访问。普通成员无需另行安装本地 MCP 服务、填写 Docker 命令或把 Token 发给智能体。

完成 OAuth 或 PAT 连接后,返回“应用能力”,在需要使用的 MCP 旁选择账号,等待「绑定成功」。 即使只有一条有效连接也不能省略;多项能力需要分别配置,账号验证正常不会自动完成所有能力绑定。

GitHub 官方托管 MCP 支持访问令牌认证;其工具集和只读入口由管理员按需要配置,具体工具以当前环境实际提供的列表为准。参考 GitHub 远程 MCP 文档

2. 给智能体添加 GitHub

  1. 打开有编辑权限的智能体,进入资源页签。
  2. 连接的应用中点击添加,选择 GitHub。
  3. 按页面提示保存或发布配置,再运行任务。

应用需要在当前工作空间已安装且启用。仅在其他工作空间完成安装,或只在“我的连接”中保存凭据,都不能替代当前智能体的应用配置。

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 可能影响其他成员。更多说明见常见问题