Codex Jira Stories MCP

Codex CLI が Jira Cloud を参照し、レビュー済みのストーリーを公開できるようにするローカル MCP サーバーです。ローカルのスキル jira-stories と連携して動作することを想定しています。スキルがストーリーを執筆し、このサーバーがプロジェクトを参照して課題を作成または更新します。

フローのセキュリティ

• 認証情報はリポジトリに保存されません。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 トークン経由で Jira Cloud に対応しています。SSO が必須の環境や、委任された認可の要件がある環境では、次のステップとして、同じツールを維持したまま MCP サーバーの認証を OAuth 2.0 に切り替えます。