jira-mcp: gestiona tu backlog y sprints de Jira directamente desde el chat de IA
← Volver al blog

jira-mcp: gestiona tu backlog y sprints de Jira directamente desde el chat de IA

Publicado el
5 min de lectura
--- vistas
jira-mcp — Jira para tu asistente de IA

Paso más tiempo del que me gustaría traduciendo entre un asistente de IA y Jira: sugiere un plan, y yo voy y lo pego en los tickets a mano. El modelo tiene el contexto; simplemente no puede tocar el tablero. Así que construí jira-mcp: un servidor Model Context Protocol, escrito en Go, que permite a Claude, Cursor y cualquier cliente MCP buscar issues, ejecutar sprints, y crear y editar work items — directamente desde el chat.

La propuesta es simple: Jira para tu asistente de IA, sin nada nuevo que autenticar.

Qué puedes hacer

  • 🔍 Habla con tu backlog — busca con JQL completo, visualiza issues, lista el trabajo del sprint, todo en lenguaje natural.
  • ✏️ Crea y edita sin salir del chat — abre tickets, edita campos, transiciona estados, asigna responsables, deja comentarios.
  • 🏃 Consciente de los sprints — visualiza sprints, lista sus work items, crea nuevos sprints en un tablero.
  • 🧰 Cero autenticación extra — se apoya en el Atlassian CLI (acli) en el que ya inicias sesión; nada nuevo que configurar.
  • Binario estático único — Go puro, se ejecuta sobre stdio, encaja en cualquier cliente MCP en segundos.

Ese cuarto punto es la decisión de diseño de la que estoy más contento. En lugar de pedirte que generes un token de API, lo guardes y lo rotes, el servidor se apoya en acli — el CLI oficial de Atlassian. Inicias sesión una vez con la herramienta que Atlassian ya distribuye; jira-mcp hereda la sesión. Ningún secreto en el repositorio, ninguno en tu configuración MCP.

La caja de herramientas

Dieciséis herramientas cubren el ciclo completo — lectura, escritura, sprints y navegación de proyectos/tableros:

HerramientaParámetrosDescripción
jira_auth_statusComprueba el estado de autenticación de acli
jira_searchjql, fields?, limit?Busca work items con JQL
jira_viewkey, fields?Muestra los detalles completos de un work item
jira_createsummary, project, type, description?, assignee?, labels?, parent?Crea un nuevo work item
jira_editkey, summary?, description?, assignee?, labels?, type?Edita uno o más work items
jira_transitionkey, statusTransiciona work items a un nuevo estado
jira_assignkey, assigneeAsigna work items a un usuario
jira_comment_addkey, bodyAñade un comentario a un work item
jira_comment_listkey, limit?, order?, paginate?, start_date?Lista los comentarios de un work item
jira_sprint_viewidMuestra los detalles de un sprint por ID
jira_sprint_list_workitemssprint, board, jql?, limit?, fields?Lista los work items de un sprint
jira_sprint_createname, board, start?, end?, goal?Crea un nuevo sprint
jira_project_listlimit?, recent?Lista los proyectos visibles
jira_project_viewkeyMuestra los detalles de un proyecto
jira_board_searchname?, project?, type?, limit?Busca tableros
jira_board_list_sprintsid, state?, limit?Lista los sprints de un tablero

Como jira_search acepta JQL en bruto, el modelo puede responder preguntas como "¿qué tengo asignado y todavía abierto en este sprint?" componiendo él mismo la consulta — y luego pasar los resultados a jira_transition o jira_comment_add sin que toques la interfaz.

Configuración

Requisitos previos

Instala y autentica el Atlassian CLI:

acli jira auth login

Instalación

El servidor es un único binario de Go:

go install github.com/artschekoff/jira-mcp/cmd/jira-mcp@latest
# or
git clone https://github.com/artschekoff/jira-mcp.git && cd jira-mcp && make install

Conéctalo a tu cliente MCP

Añade una entrada de servidor en la configuración MCP de tu cliente — sin env, sin token, porque acli ya mantiene la sesión:

{
  "mcpServers": {
    "jira": {
      "command": "jira-mcp"
    }
  }
}

Verifica que funciona:

acli jira auth status

Reinicia el cliente y tu asistente podrá empezar a trabajar en el tablero.

Por qué apoyarse en el CLI en lugar de la API REST

Podría haberlo conectado directamente a la API REST de Jira — y heredado gestión de tokens, scopes, renovación, y una superficie mucho mayor que asegurar. En cambio, se apoya en acli, que Atlassian mantiene y que ya maneja la autenticación de la forma en que tu organización lo espera (SSO, MFA, todo). El servidor simplemente traduce las llamadas a herramientas MCP en invocaciones del CLI y analiza la salida de vuelta en datos limpios y estructurados sobre los que el modelo puede razonar.

Es el mismo principio detrás de mis otros servidores MCP — envolver una herramienta madura y de confianza, exponer exactamente las operaciones que un agente necesita, y mantener las credenciales fuera del repositorio y fuera de la transcripción por completo.

El proyecto está abierto en GitHub: github.com/artschekoff/jira-mcp — Go puro, se ejecuta sobre stdio. Issues y pull requests bienvenidos.

Disponible para colaboración por contrato

Estoy disponible para colaborar por contrato. Si tiene una idea de proyecto interesante, reserve una llamada por Calendly.

Agenda una llamada de 30 min