Codex Jira Stories MCP

Lokaler MCP-Server, der es der Codex-CLI ermöglicht, Jira Cloud abzufragen und bereits überprüfte Stories zu veröffentlichen. Er ist dafür gedacht, mit der lokalen Skill jira-stories zu arbeiten: Die Skill verfasst die Story; dieser Server fragt das Projekt ab und erstellt oder aktualisiert das Issue.

Sicherheit des Ablaufs

• Die Anmeldedaten liegen nicht im Repository: Sie werden aus JIRA_BASE_URL, JIRA_EMAIL und JIRA_API_TOKEN gelesen.

• Die Schreibwerkzeuge erfordern confirmPublish: true.

• Es gibt kein Löschwerkzeug.

• Verwende vor dem Veröffentlichen jira_preview_issue und prüfe das Ergebnis.

Related MCP server: JIRA MCP Server

Vorbereitung

1. Kopiere .env.example an einen sicheren Ort und exportiere die Variablen im Terminal. Erstelle keine .env-Datei mit Anmeldedaten und nimm sie nicht unter Versionskontrolle.

2. Stelle sicher, dass das Konto im gewünschten Jira-Projekt über die Berechtigungen Browse projects und Create issues verfügt.

3. Registriere den Server in der 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

Öffne anschließend eine neue Codex-Sitzung und führe /mcp aus, um zu bestätigen, dass jira-stories aktiv ist.

Verfügbare Werkzeuge

Beispiel für eine Konversation

Verfasse eine funktionale Story, um den Export von PDF-Berichten zu ermöglichen. Rufe die verfügbaren Jira-Projekte ab, erstelle eine Vorschau für das Projekt AGR und veröffentliche erst, nachdem ich sie genehmigt habe.

Um eine genehmigte Vorschau zu veröffentlichen, bitte den Codex ausdrücklich darum, jira_create_issue mit confirmPublish: true zu verwenden. Die Beschreibung wird von Klartext oder einfachem Markdown in das von Jira Cloud akzeptierte Dokumentformat konvertiert.

Lokale Überprüfung

npm test

Aktuelle Einschränkungen

Diese erste Version unterstützt Jira Cloud per API-Token. Für Umgebungen mit obligatorischem SSO oder Anforderungen an delegierte Autorisierung besteht der nächste Schritt darin, die Authentifizierung im MCP-Server durch OAuth 2.0 zu ersetzen, wobei dieselben Werkzeuge erhalten bleiben.