让codex能操作confluence和jira

前言

新的公司使用jira来管理工单，用confluence管理项目开发过程中的文件。为了更加方便的工作，经过一番搜索后得到了一个方案，能通过一个mcp （本质上是confluence / jira的api封装）给codex赋能公司的知识库和工单系统。

以上为复杂说法，简单的说就是让codex / claudecode / opencode 等工具具备操作confluence和jira的能力。

本笔记适用于codex，cc和opencode让ai帮忙转换一下应该也是能用的。

起步

首先你需要获取到jira和confluence的pat（personal access token）。

获取JIRA的令牌

登陆 -> 点击右上角头像 -> 用户信息 -> 个人访问令牌 -> 创建令牌

随后过期日期按照贵司的安全要求来，将弹出的密钥保存好，一会会用。

获取confluence的令牌

confluence会复杂一点。

登陆 -> 右上角头像 -> 设置 -> 个人访问令牌。

剩下的和jira一样。记得保管好弹出的密钥。

挂档

然后我们需要配置MCP Server进codex的配置文件，笔者用的mac。

首先打开codex的配置文件

nano ~/.codex/config.toml

在合适的位置插入这一段：

[mcp_servers.mcp-atlassian]
command = "uvx"
args = ["mcp-atlassian"]
enabled = true

[mcp_servers.mcp-atlassian.env]
JIRA_URL = "<替换成贵司jira地址>"
JIRA_PERSONAL_TOKEN = "<生成出来的jira token>"
CONFLUENCE_URL = "<替换成贵司confluence地址>"
CONFLUENCE_PERSONAL_TOKEN = "<生成出来的confluence token>"

当然，如果你只需要 jira / confluence中的一项也是没问题的，另外一半删掉就行。