Codex Jira Stories MCP

Servidor MCP local que permite al Codex CLI consultar Jira Cloud y publicar historias ya revisadas. Está pensado para trabajar con la skill local jira-stories: la skill redacta la historia; este servidor consulta el proyecto y crea o actualiza la issue.

Seguridad del flujo

• Las credenciales no quedan en el repositorio: se leen de JIRA_BASE_URL, JIRA_EMAIL y JIRA_API_TOKEN.

• Las herramientas de escritura exigen confirmPublish: true.

• No existe herramienta de exclusión.

• Antes de publicar, usa jira_preview_issue y revisa el resultado.

Related MCP server: JIRA MCP Server

Preparación

1. Copia .env.example a un lugar seguro y exporta las variables en la terminal. No crees ni versiones un archivo .env con credenciales.

2. Confirma que la cuenta tiene los permisos Browse projects y Create issues en el proyecto Jira deseado.

3. Registra el servidor en el 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

A continuación, abre una nueva sesión de Codex y ejecuta /mcp para confirmar que jira-stories está activo.

Herramientas disponibles

Ejemplo de conversación

Redacta una historia funcional para permitir la exportación de informes PDF. Consulta los proyectos Jira disponibles, genera una vista previa para el proyecto AGR y solo publica después de que yo lo apruebe.

Para publicar una vista previa aprobada, pide explícitamente a Codex que use jira_create_issue con confirmPublish: true. La descripción se convierte de texto plano o Markdown básico al formato de documento aceptado por Jira Cloud.

Verificación local

npm test

Limitaciones actuales

Esta primera versión da soporte a Jira Cloud mediante API token. Para entornos con SSO obligatorio o requisito de autorización delegada, el siguiente paso es sustituir la autenticación por OAuth 2.0 en el servidor MCP, preservando las mismas herramientas.