1. 为什么要在 AtomCode 里打通 AtomGit Issue 通道AtomCode 是 AtomGit 生态里的一款 AI 编程助手它跟普通聊天式助手最大的区别是支持 MCPModel Context Protocol和 Skill 两套扩展机制。MCP 负责能做什么——把外部平台的 API 包装成 AI 可调用的工具Skill 负责该怎么做——用一份 Markdown 说明书告诉 AI 遇到某类任务时的标准流程。把这两者组合起来你就能在编辑器对话窗口里直接说一句帮我在 my-org/my-repo 提个 IssueAI 自动调用 AtomGit 接口完成创建全程不用切浏览器。这套玩法适合谁我总结了三类人一是日常要写大量 bug 报告、需求单的开发者手动填标题、正文、标签、负责人太碎二是团队里负责工单流转的人希望 AI 按统一模板生成 Issue 内容三是想把本地编码助手和代码托管平台工单系统联动起来、做工作流自动化的同学。AtomGit 官方发布的 MCP Server 提供了 274 个工具覆盖仓库、Issue、PR、分支、标签、文件等操作Issue 只是其中一块但它是最高频的入口。不过很多人卡在第一步MCP 配置写在哪、Token 怎么给、Skill 目录放哪、改完为什么不生效。更麻烦的是如果你同时用多个 AI 工具Claude Code、Cline、Codex 等每个工具的 Key 和 endpoint 都要单独配一遍管理成本很高。这篇就按全局安装的思路把 AtomCode 的 MCP Skill 一次配好同时用 TaoToken 统一 Key 和 API 通道让所有工具共用一套凭证。下面从环境准备开始一步步给到可复制的配置片段和验证动作。2. 前置准备AtomGit Token 与 TaoToken 统一 Key 获取2.1 获取 AtomGit Token所有 AtomGit OpenAPI 请求都需要 Bearer Token 认证Token 在 atomgit.com 和 gitcode.com 通用共享同一套后端。访问https://atomgit.com/setting/token-classic或从 AtomGit 头像菜单 → 设置 → 个人访问令牌进入。创建新 Token 时填写名称比如atomcode-mcp选择过期时间勾选以下权限权限作用api完整 API 访问权限issuesIssue 读写权限read_user读取用户信息read_repository读取仓库信息生成后立即复制 Token 字符串关闭页面后将不再显示。把它保存到安全位置下一步会用到。注意Token 相当于你的密码不要提交到 Git 仓库、不要分享给他人。建议使用环境变量而非硬编码在配置文件中。2.2 获取 TaoToken 统一 Key如果你只用 AtomCode 一个工具直接用 AtomGit Token 就够了。但实际开发中往往同时开着 Claude Code、Cline、Codex 等多个助手每个都要单独配 Key 和 endpoint改一次要动好几个文件。TaoToken 的思路是提供一个统一的 API 通道所有工具共用一套 Key 和 Base URL切换模型或工具时只改一处。获取方式访问 TaoToken 控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentconsole注册后在 API Keys 页面创建一个新 Key。这个 Key 会作为所有下游工具的凭证。TaoToken 的 API 入口是https://taotoken.net/api注意API 地址不加 UTM 参数直接填这个即可。在 AtomCode 的 MCP 配置里如果 MCP Server 本身需要调用大模型能力比如某些 Skill 会触发模型推理就把 Base URL 指向这个地址Key 填 TaoToken 的 Key。提示AtomGit Token 和 TaoToken Key 是两个不同用途的凭证。前者用于访问 AtomGit 平台 API创建 Issue 等后者用于访问大模型 API。配置时不要混淆。2.3 环境检查在开始配置前确认本地环境满足以下条件# 检查 Node.js 版本MCP Server 需要 18 node -v # 检查 npx 是否可用 npx -v # 检查 AtomCode 是否已安装 atomcode --version如果 Node.js 版本低于 18去 nodejs.org 下载 LTS 版本安装。npx 通常随 npm 一起安装如果缺失运行npm install -g npx补上。3. 全局安装 MCP Server 与 Skill 配置片段3.1 全局 MCP 配置AtomCode 的 MCP 配置支持项目级.mcp.json和全局级~/.atomcode/mcp.json。为了让所有项目都能使用 AtomGit 提 Issue我们采用全局安装。编辑~/.atomcode/mcp.json写入以下内容{ mcpServers: { atomgit: { command: npx, args: [-y, atomgit.com/atomgit-mcp-server], env: { ATOMGIT_TOKEN: __ATOMGIT_TOKEN__, TAOTOKEN_BASE_URL: https://taotoken.net/api, TAOTOKEN_API_KEY: __TAOTOKEN_API_KEY__ } } } }把__ATOMGIT_TOKEN__替换成 2.1 步获取的 Token__TAOTOKEN_API_KEY__替换成 2.2 步获取的 TaoToken Key。如果你不需要 TaoToken 通道可以删掉后两行 env。也可以用命令行一键添加atomcode mcp add atomgit npx -y atomgit.com/atomgit-mcp-server --global关于 MCP Server 包atomgit.com/atomgit-mcp-server是 AtomGit 官方发布的 npm 包提供 274 个工具覆盖仓库、Issue、PR、分支、标签、文件等操作。安全模式下危险操作delete/remove/archive/transfer默认不暴露。3.2 配置环境变量将 Token 配置到环境变量中推荐写入 shell 配置文件如~/.zshrc或~/.bashrc# ~/.zshrc export ATOMGIT_TOKEN你的token export TAOTOKEN_API_KEY你的taotoken_key export TAOTOKEN_BASE_URLhttps://taotoken.net/api然后使其生效source ~/.zshrc提示如果不想在全局环境变量中暴露 Token也可以在 MCP 配置的 env 字段中直接填写但注意~/.atomcode/mcp.json不应公开分享。3.3 全局安装 SkillSkill 是 AtomCode 的可复用技能包告诉 AI遇到这类任务应该怎么做。我们创建一个专门的atomgit-issueSkill 来管理 Issue 提交流程。创建目录和文件mkdir -p ~/.atomcode/skills/atomgit-issue在~/.atomcode/skills/atomgit-issue/SKILL.md中写入--- name: atomgit-issue description: Create and manage issues on AtomGit (atomgit.com) / GitCode repositories. Use when filing bug reports, feature requests, or tracking tasks. --- # AtomGit Issue 管理 通过 AtomGit MCP Server 创建和管理 AtomGit/GitCode 平台上的 Issue。 ## 前置条件 1. **AtomGit Token** — 已配置在 ATOMGIT_TOKEN 环境变量中 - 生成地址https://atomgit.com/setting/token-classic - 所需权限api, issues 2. **AtomGit MCP Server** — 已通过 ~/.atomcode/mcp.json 全局注册 ## 工作流程 ### 1. 创建 Issue 使用 mcp__atomgit__create_issue 工具创建 Issue | 参数 | 必填 | 说明 | |------|------|------| | owner | 是 | 仓库所有者用户名或组织名 | | repo | 是 | 仓库名称 | | title | 是 | Issue 标题 | | body | 是 | Issue 内容Markdown 格式 | | assignees | 否 | 负责人列表 | | labels | 否 | 标签列表 | | milestone | 否 | 里程碑编号 | ### 2. 查询 Issue 使用 mcp__atomgit__list_issues 或 mcp__atomgit__get_issue 查看 Issue 列表或详情。 ### 3. 评论 Issue 使用 mcp__atomgit__create_issue_comment 为 Issue 添加评论。提示AtomCode 启动时会自动扫描~/.atomcode/skills/目录下的所有 SKILL.md 文件。Skill 支持三种调用方式斜杠命令输入/atomgit-issue手动触发、Dollar 菜单输入$atomgit-issue带参数调用、AI 自动调用对话涉及 Issue 相关内容时AtomCode 自动匹配并执行。3.4 三件套对照表无论你用 AtomCode、Cline 还是 Codex接入任何 MCP 或模型通道都离不开三件套Base URL、Key、Model ID。对照如下组件值用途Base URLhttps://taotoken.net/apiTaoToken 统一 API 入口KeyTaoToken 控制台创建的 Key身份认证Model ID按需选择如 claude-sonnet-4-5指定调用的模型AtomGit MCP 的配置则是另一套ATOMGIT_TOKEN用于访问 AtomGit 平台commandargs指定 MCP Server 启动方式。4. 验证请求创建 Issue 并回读确认4.1 重启 AtomCodeMCP 配置在 AtomCode 启动时加载因此需要重启才能生效# 完全退出 AtomCode确保进程已终止 # 然后重新启动 atomcode启动日志中会看到 MCP 连接信息。4.2 验证 MCP 连接状态在 AtomCode 中输入/mcp查看已连接的 MCP 服务列表。如果看到atomgit出现在列表中说明连接成功。4.3 验证 Skill 加载输入/skills查看所有已加载的 Skillatomgit-issue应出现在列表中。4.4 创建 Issue 验证配置完成后你就可以在对话中直接让 AtomCode 提 Issue 了你帮我在 my-org/my-repo 提一个 Bug Issue标题是登录页面在移动端布局错乱 内容描述一下在 iOS Safari 上输入框被键盘遮挡的问题 AtomCode好的我来创建 Issue。 → 调用 mcp__atomgit__create_issue(ownermy-org, repomy-repo, title登录页面在移动端布局错乱, body...) → Issue 已创建链接https://atomgit.com/my-org/my-repo/issues/424.5 回读验证创建后立即回读确认通道双向可用你看看 my-org/my-repo 有哪些未关闭的 Issue AtomCode→ 调用 mcp__atomgit__list_issues(ownermy-org, repomy-repo, stateopen) → 当前有 3 个未关闭的 Issue 1. #42 登录页面在移动端布局错乱 2. #41 添加暗黑模式支持 3. #39 优化首页加载速度如果创建成功且能回读列表说明 MCP 通道完全打通。这一步很关键——很多人只验证创建不验证回读结果遇到权限不足或仓库不存在的问题时无法定位。5. 常见报错排查401、local proxy failed、reading choices5.1 MCP 连接失败如果/mcp中看不到atomgit服务可能的原因Node.js 未安装— MCP Server 需要 Node.js 18去 nodejs.org 下载安装。环境变量未设置— 确认ATOMGIT_TOKEN已正确设置且重启了终端echo $ATOMGIT_TOKENnpx 找不到包— 尝试手动运行看报错信息npx atomgit.com/atomgit-mcp-serverJSON 格式错误— 检查~/.atomcode/mcp.json的 JSON 语法可以用python -m json.tool ~/.atomcode/mcp.json验证。5.2 401 Unauthorized这是最常见的报错通常有三种原因Token 无效或过期— 去https://atomgit.com/setting/token-classic重新生成确认复制完整没有多余空格。权限不足— 至少需要api和issues权限。如果还需要操作 PR、仓库等请追加对应权限。Token 未正确传递— 检查~/.atomcode/mcp.json中env.ATOMGIT_TOKEN是否填对或环境变量是否生效。注意MCP 配置中的 env 优先级高于 shell 环境变量。5.3 local proxy failed这个报错通常出现在 MCP Server 启动阶段表示本地代理或网络请求失败。排查方向Base URL 配置错误— 如果用了 TaoToken 通道确认TAOTOKEN_BASE_URL填的是https://taotoken.net/api不要多加路径或斜杠。网络不通— 在终端手动 curl 测试curl -I https://taotoken.net/api端口占用— 某些 MCP Server 会启动本地端口如果被占用会报 proxy failed。检查是否有其他进程占用。5.4 reading choices 报错这个报错一般出现在模型返回格式异常时表示解析响应中的choices字段失败。常见原因Model ID 填错— 确认你填的 Model ID 是 TaoToken 支持的模型名不要填成 OpenAI 或 Anthropic 的原始名称。响应被截断— 如果 Issue 正文特别长可能触发 token 上限导致响应不完整。把正文拆短或换用支持更长上下文的模型。API Key 无效— 虽然报的是 reading choices但根因可能是 Key 无效导致返回了错误结构。先用/mcp确认连接状态再检查 Key。5.5 OAuth 相关报错如果看到 OAuth 相关的错误说明某些工具尝试走 OAuth 流程但未配置。AtomGit MCP 默认用 Token 认证不需要 OAuth。如果报错检查是否误配了auth字段删掉即可。5.6 项目级配置 vs 全局配置全局配置对当前用户所有项目生效。如果只想在某个特定项目中使用可以将mcp.json和.atomcode/skills/放在项目根目录下。项目级配置会覆盖全局配置中同名的 MCP Server。排查时如果发现配置改了不生效先确认改的是全局还是项目级——项目级优先级更高容易覆盖掉你的全局设置。6. 把通道用起来从单次提 Issue 到工作流自动化配置打通只是起点。真正提升效率的是把这套通道嵌入日常工作流。我自己的做法是在 AtomCode 里维护几个常用 Skill除了atomgit-issue还有atomgit-pr提 PR、atomgit-review代码审查。每次遇到 bug直接在对话里描述现象AI 按 Skill 里的模板生成结构化 Issue 正文自动带上复现步骤、环境信息、预期行为等字段比手填快很多。如果你团队有统一的 Issue 模板把它写进 SKILL.md 的 body 示例里AI 生成时会自动遵循。比如要求每个 bug 报告必须包含复现步骤 / 实际结果 / 预期结果 / 环境四段就在 Skill 里写清楚后续所有 Issue 都按这个格式走。TaoToken 统一 Key 的价值在多工具场景下更明显。我同时用 AtomCode 和 Claude Code两个工具都指向https://taotoken.net/api共用一套 Key。换模型时只改 TaoToken 控制台的配置两个工具同时生效不用逐个改配置文件。如果你也在用多个 AI 编码助手建议把 Key 和 endpoint 统一到一处管理。最后给一个实用技巧MCP 配置改完后如果/mcp里状态显示已连接但调用工具报错先看 AtomCode 的日志输出通常在~/.atomcode/logs/下日志里会打印具体的请求 URL 和响应状态码比在对话里猜要快得多。Token 权限问题、仓库路径写错、网络超时日志里都能直接看到。需要进一步操作的话可以访问 TaoToken 的 API Keys 页面管理凭证https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi-keys或查阅接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc了解各工具的详细配置方式。如果你主要做长期编码和 Agent 任务Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding-plan会更合适只是想先验证模型对话效果可以直接在模型对话页https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentchat试一下。