![Codex 桌面应用界面（已接入禅道 MCP；D405 起为设计稿导出件）：顶部标题栏为侧栏开关、前进 / 后退与 File / Edit / View / Window / Help 应用菜单，右端为「Codex」题注；左侧栏为「New chat」「Search」「Skills」三条导航、「Chats」分组（含筛选与新建会话图标）、项目行「禅道项目」、五个会话（当前会话「接入禅道 MCP」高亮 + 3m；其余为「支付中台需求梳理 4h」「Bug #4821 跟进 4d」「第 38 周项目周报 5d」「迭代 10 执行情况 6d」）、「Show more」与底部「Settings」；右侧主区标题行为「接入禅道 MCP」+ 更多，右端为终端 / 复制 / 面板三个图标；主区为灰底终端块（右端用户头像），内含配置命令「codex mcp add zentao --url http://127.0.0.1:9090/zentao/mcp --bearer-token-env-var ZENTAO_TOKEN」、注释「# 等价于在 ~/.codex/config.toml 中写入：」与 config.toml 段落「[mcp_servers.zentao]」「url = “http://127.0.0.1:9090/zentao/mcp”」「bearer_token_env_var = “ZENTAO_TOKEN”」；其下「3 previous messages ›」、结论文本「配置本身没问题，但还有两个前置条件未满足。」、「当前状态」四条（codex mcp list 中 zentao 已存在、~/.codex/config.toml 已写入 [mcp_servers.zentao]、ZENTAO_TOKEN 环境变量未设置、探测 http://127.0.0.1:9090/zentao/mcp 无法连接）与「需要你确认/操作」两条（启动本地禅道 MCP 服务使监听 127.0.0.1:9090、设置 token）；底部输入卡为「Ask for follow-up changes」与工具行（＋ full access、模型 acustom / 推理档位 medium、圆形发送键）](https://static.zentao.net/web/data/source/zentao/default/wide/codex-banner.svg)
一次接入，长期可用
「MCP 接入」与「技能接入」任选其一：MCP 先取 API V2 Token 再注册 MCP 服务，技能先安装技能包再完成鉴权。
1. 调用禅道 API V2 接口获取 Token
curl -X POST "http://您的禅道域名/api.php/v2/users/login" \
-H "Content-Type: application/json" \
-d '{"account":"用户名","password":"密码"}'2. 在 Codex 中注册禅道 MCP 服务
codex mcp add zentao --url http://127.0.0.1:9090/zentao/mcp --bearer-token-env-var ZENTAO_TOKEN
# 等价于在 ~/.codex/config.toml 中写入：
[mcp_servers.zentao]
url = "http://127.0.0.1:9090/zentao/mcp"
bearer_token_env_var = "ZENTAO_TOKEN"1. 安装 skills：把禅道技能包放进 Codex 的 skills 目录
git clone https://github.com/easysoft/zentao-skills ~/.codex/skills/zentao2. 完成鉴权配置
获取禅道 token url：你的禅道 url 地址
账号：你的禅道账号
密码：你的禅道密码接上以后能做什么
读项目、看进度、动手做、交回团队，都在对话里完成；涉及变更由人确认，验收仍按禅道流程走。
AI 懂项目
开工前，AI 根据任务通过 API 读取禅道里的需求、任务与项目上下文，作为这次开发的依据；不用再从聊天记录里翻背景。
AI 跟进度
AI 通过 API 调取禅道里的任务、Bug 和迭代状态，把进度、风险和逾期任务汇总；写代码的间隙就知道了下一步。
AI 去执行
一段工作结束后，AI 把结果通过禅道 API 写回 —— 建需求、开任务、提 Bug、改状态、加备注，落到对应工作项，改动留记录。
AI 进团队
AI 把结论通过禅道 API 写成工作项或项目文档，指派、评审、验收按禅道原有流程走，团队在同一处看到。
起于禅道，落回禅道
第三方客户端止于读数据、做操作；完整工序和团队协作在禅道中。
在 Codex 里能做
要回禅道里做项目、迭代、需求、任务、Bug、用例、反馈、工单
需求、任务、Bug 在项目里逐级流转，状态与记录留在禅道
进度、逾期、Bug 集中度、周报
需求、设计、研发、测试、发布按禅道里的工序推进
新建需求、任务、Bug，改状态、加备注、关工作项、写项目文档
指派、评审、验收在禅道里走完
常见问题
接入 Codex 需要准备什么？
一个能访问的禅道地址和一个有权限的禅道账号；MCP 服务与技能包任选其一，配好地址与鉴权即可。
禅道的数据安全吗？会不会被带出去？
数据访问沿用禅道账号权限，AI 只能读取你有权限的项目和数据；写回也走禅道 API，改动留在禅道记录里。
支持私有部署的禅道吗？
支持。只要 Codex 所在网络能访问到禅道地址即可，账号与鉴权方式与公有云一致。
AI 会直接改动禅道里的数据吗？
读数据随时可用；新建需求、任务、Bug 或改状态这类写操作，由人在对话里确认后通过禅道 API 执行。
感谢您的！为确保您能充分发挥禅道的价值，我们为您准备了以下专属服务：
精品资料包立即获取《软件研发质量管理体系建设白皮书》、《PMO实践白皮书》《IPD资料》等行业最佳实践资料。
1V1产品演示为您量身定制线上演示，深度讲解核心功能与适用场景。
免费试用增强功能获取正式试用授权，解锁全部功能，带领团队亲身体验。
专属顾问答疑支持在使用中遇到的任何问题，您的专属顾问将及时为您解答。
添加您的专属顾问获取服务
扫码添加领专属服务
