jira-context-mcp

jira-context-mcp es un servidor MCP orientado a producción que obtiene contexto estructurado de incidencias de Jira a partir de una URL de Jira. Está diseñado para agentes de programación como Codex y Claude Code, de modo que puedan comprender rápidamente la intención y el contexto de implementación de una incidencia.

Qué hace este servidor

• Expone una herramienta MCP: get_jira_issue_from_url

• Valida que la URL de entrada pertenezca a tu JIRA_BASE_URL

• Extrae una clave de incidencia de Jira de múltiples formatos de URL de Jira

• Llama a la API REST de Jira Cloud:

  • GET /rest/api/3/issue/{issueIdOrKey}?expand=names,renderedFields

• Convierte el texto enriquecido de Jira (Atlassian Document Format) a texto plano

• Devuelve un contexto de incidencia estructurado, conciso y fácil de leer para los agentes

Related MCP server: JIRA MCP Server

Tipos de incidencias de Jira compatibles

Este servidor es agnóstico respecto al tipo de incidencia. Funciona para cualquier tipo de incidencia de Jira, incluyendo:

• Bug

• Solicitud de funcionalidad

• Tarea

• Historia

• Épica

• Requisito

• Mejora

• Ticket de soporte

• Tipos de incidencia personalizados

Variables de entorno requeridas

• JIRA_EMAIL: Correo electrónico de la cuenta de Jira

• JIRA_API_TOKEN: Token de API de Jira

• JIRA_BASE_URL: URL del inquilino de Jira Cloud (ejemplo: https://your-domain.atlassian.net)

Comandos de configuración rápida

Codex (sin instalación global)

codex mcp add jira \
  --env JIRA_EMAIL=you@example.com \
  --env JIRA_API_TOKEN=your-token \
  --env JIRA_BASE_URL=https://your-domain.atlassian.net \
  -- npx -y github:TastyHeadphones/jira-context-mcp

Claude Code (sin instalación global)

claude mcp add jira \
  -e JIRA_EMAIL=you@example.com \
  -e JIRA_API_TOKEN=your-token \
  -e JIRA_BASE_URL=https://your-domain.atlassian.net \
  -- npx -y github:TastyHeadphones/jira-context-mcp

Opcional: instalar globalmente primero

npm install -g github:TastyHeadphones/jira-context-mcp

Luego añadir con el binario local:

codex mcp add jira \
  --env JIRA_EMAIL=you@example.com \
  --env JIRA_API_TOKEN=your-token \
  --env JIRA_BASE_URL=https://your-domain.atlassian.net \
  -- jira-context-mcp

claude mcp add jira \
  -e JIRA_EMAIL=you@example.com \
  -e JIRA_API_TOKEN=your-token \
  -e JIRA_BASE_URL=https://your-domain.atlassian.net \
  -- jira-context-mcp

Herramienta

get_jira_issue_from_url

Entrada:

{
  "url": "string"
}

Ejemplos de URL compatibles:

• ${JIRA_BASE_URL}/browse/ABC-123

• ${JIRA_BASE_URL}/jira/software/projects/ABC/boards/1/backlog?selectedIssue=ABC-123

• Cualquier URL de Jira bajo JIRA_BASE_URL que contenga una clave de incidencia como ABC-123

Los datos estructurados devueltos incluyen:

• issueKey, issueUrl, summary

• description (texto plano cuando sea posible)

• issueType, status, statusCategory, priority

• assignee, reporter

• labels, components

• fixVersions, affectedVersions

• created, updated, dueDate

• parent, epic

• subtasks, linkedIssues

• attachments (solo metadatos)

• comments (los 10 más recientes)

• acceptanceCriteria (extracción basada en el mejor esfuerzo desde la descripción/campos personalizados)

• customFields (no vacíos, normalizados, legibles por humanos)

Crear un token de API de Jira

1. Abre la configuración de tokens de API de Atlassian.

2. Haz clic en Create API token.

3. Ponle un nombre al token y cópialo.

4. Usa ese valor para JIRA_API_TOKEN.

Ejecutar localmente

1. Instalar dependencias:

npm install

2. Establecer variables de entorno (por ejemplo, mediante .env en tu shell/sesión).

3. Compilar:

npm run build

4. Iniciar:

npm start

Modo de desarrollo:

npm run dev

Ejemplos de configuración de MCP

Usa esta entrada de servidor en la configuración de tu cliente MCP:

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/absolute/path/to/jira-context-mcp/dist/index.js"],
      "env": {
        "JIRA_EMAIL": "you@example.com",
        "JIRA_API_TOKEN": "your-token",
        "JIRA_BASE_URL": "https://your-domain.atlassian.net"
      }
    }
  }
}

Ejemplo de configuración de MCP para Claude Code

Usa el mismo bloque JSON anterior en tu archivo de configuración del servidor MCP de Claude Code.

Ejemplo de configuración de MCP para Codex

Usa el mismo bloque JSON anterior en tu archivo de configuración del servidor MCP de Codex.

Ejemplo de llamada a la herramienta

{
  "name": "get_jira_issue_from_url",
  "arguments": {
    "url": "https://your-domain.atlassian.net/browse/ABC-123"
  }
}

Ejemplo de salida

{
  "issueKey": "ABC-123",
  "issueUrl": "https://your-domain.atlassian.net/browse/ABC-123",
  "summary": "Prevent duplicate webhook retries",
  "description": "As a platform engineer, I need retry deduplication ...",
  "acceptanceCriteria": "- Duplicate deliveries are ignored\n- Metrics include dropped duplicates",
  "issueType": "Story",
  "status": "In Progress",
  "statusCategory": "In Progress",
  "priority": "High",
  "assignee": {
    "accountId": "5b10ac8d82e05b22cc7d4ef5",
    "displayName": "Alex Example",
    "emailAddress": null,
    "active": true
  },
  "labels": ["webhook", "idempotency"],
  "components": ["API"],
  "fixVersions": ["2026.05"],
  "affectedVersions": ["2026.04"],
  "subtasks": [],
  "linkedIssues": [],
  "attachments": [],
  "comments": [],
  "customFields": []
}

Notas de seguridad

• Mantén JIRA_API_TOKEN en secreto. Nunca lo subas al control de versiones.

• Utiliza un acceso a Jira con privilegios mínimos para la cuenta vinculada al token.

• Este servidor solo obtiene datos de incidencias y metadatos de archivos adjuntos; no descarga los archivos adjuntos.

• La validación de URL rechaza las URL que se encuentren fuera de tu JIRA_BASE_URL configurada.