Codex Jira Stories MCP

本地 MCP 服务器，允许 Codex CLI 查询 Jira Cloud 并发布已审阅的故事。它旨在与本地技能 jira-stories 配合：该技能负责撰写故事；此服务器负责查询项目并创建或更新 issue。

流程安全

• 凭据不会存储在仓库中：它们从 JIRA_BASE_URL、JIRA_EMAIL 和 JIRA_API_TOKEN 读取。

• 写入工具需要 confirmPublish: true。

• 没有删除工具。

• 发布前，请使用 jira_preview_issue 并检查结果。

Related MCP server: JIRA MCP Server

准备

1. 将 .env.example 复制到安全的位置，并在终端中导出这些变量。不要创建或版本化包含凭据的 .env 文件。

2. 确认账户在所需的 Jira 项目中拥有 Browse projects 和 Create issues 权限。

3. 在 Codex CLI 中注册服务器：

codex mcp add jira-stories \
  --env JIRA_BASE_URL="$JIRA_BASE_URL" \
  --env JIRA_EMAIL="$JIRA_EMAIL" \
  --env JIRA_API_TOKEN="$JIRA_API_TOKEN" \
  -- node /Users/emenezes/projetos/codex-jira-stories-mcp/src/server.mjs

然后，打开一个新的 Codex 会话并执行 /mcp，以确认 jira-stories 已激活。

可用工具

对话示例

撰写一个功能故事，以允许导出 PDF 报告。查询可用的 Jira 项目，为 AGR 项目生成预览，并且只在我批准后才发布。

要发布已批准的预览，请明确要求 Codex 使用 jira_create_issue 并传递 confirmPublish: true。描述会从纯文本或基础 Markdown 转换为 Jira Cloud 接受的文档格式。

本地验证

npm test

当前限制

此第一版通过 API token 支持 Jira Cloud。对于强制 SSO 或需要委派授权的环境，下一步是在 MCP 服务器上改用 OAuth 2.0 认证，同时保留相同的工具。