Skip to main content
Glama

Servidor MCP de Jira

Un servidor del Protocolo de Contexto de Modelo (MCP) que lleva el contexto de los tickets de Jira directamente a Claude Code. Obtén información completa del ticket, incluyendo descripciones, comentarios, archivos adjuntos y diseños de Figma vinculados sin salir de tu entorno de desarrollo.

Descripción general

Al trabajar en tareas de desarrollo, cambiar el contexto entre Jira y tu editor de código interrumpe el flujo y hace perder tiempo. Este servidor MCP lo soluciona mediante:

  • Obtención de contexto completo del ticket - Obtén descripciones, comentarios, estado y metadatos al instante.

  • Descarga de archivos adjuntos - Los archivos adjuntos de imagen se descargan y muestran en línea.

  • Obtención automática de diseños de Figma - Las URLs de Figma vinculadas se detectan automáticamente y se exportan como imágenes.

  • Habilitación de consultas naturales - Busca tickets con JQL directamente desde Claude Code.

Related MCP server: JIRA MCP Server

Características

Característica

Descripción

Detalles completos del ticket

Resumen, descripción, estado, prioridad, asignado, informador, sprint, padre

Comentarios

Todos los comentarios con autor y marca de tiempo

Archivos adjuntos

Descarga automática de imágenes adjuntas (PNG, JPG, GIF, WebP)

Problemas vinculados

Ver tickets relacionados y sus relaciones

Integración con Figma

Detección y exportación automática de diseños de Figma vinculados en los tickets

Búsqueda JQL

Busca en toda tu instancia de Jira con consultas potentes

Instalación

Requisitos previos

  • Node.js 18+

  • CLI de Claude Code

  • Cuenta de Jira Cloud con acceso a la API

Paso 1: Añadir a Claude Code

claude mcp add --transport stdio jira -- npx -y @rui.branco/jira-mcp

Paso 2: Obtén tu token de API de Jira

  1. Ve a Tokens de API de Atlassian

  2. Haz clic en "Create API token"

  3. Introduce una etiqueta (p. ej., "Claude Code MCP")

  4. Haz clic en "Create"

  5. Copia el token (no podrás volver a verlo)

Paso 3: Configurar credenciales

Ejecuta la configuración con tus credenciales:

npx @rui.branco/jira-mcp setup "your@email.com" "YOUR_API_TOKEN" "https://company.atlassian.net"

Parámetro

Descripción

Ejemplo

Email

Tu correo electrónico de la cuenta de Atlassian

john@company.com

API Token

El token que creaste en el Paso 2

ATATT3xFfGF0...

Base URL

La URL de tu instancia de Jira

https://company.atlassian.net

O ejecútalo de forma interactiva (solicitará cada valor):

npx @rui.branco/jira-mcp setup

Paso 4: Verificar

Reinicia Claude Code y ejecuta /mcp para verificar que el servidor está conectado.

Alternativa: Instalación manual

Si prefieres instalarlo manualmente:

git clone https://github.com/rui-branco/jira-mcp.git ~/.config/jira-mcp
cd ~/.config/jira-mcp && npm install
node setup.js

Luego añádelo a Claude Code:

claude mcp add --transport stdio jira -- node $HOME/.config/jira-mcp/index.js

Uso

Obtener un ticket

> Get ticket PROJ-123

# Returns full ticket with description, comments, attachments, and Figma designs

Buscar tickets

> Search for my open tickets

# Uses JQL: assignee = currentUser() AND status != Done

Añadir comentarios con menciones

Usa la sintaxis @Nombre Apellido para mencionar usuarios en los comentarios:

> Add a comment to PROJ-123: "@John Doe Please review this implementation"

# The mention is automatically resolved and the user gets notified

Ejemplo de salida

# PROJ-123: Implement user authentication

Status: In Progress | Type: Story | Priority: High
Assignee: John Doe | Reporter: Jane Smith

## Description
Implement OAuth2 authentication flow...

## Comments (2)
### Jane Smith - Jan 15, 2025
Please ensure we support Google SSO...

## Attachments (1)
- mockup.png (image/png, 245KB)
  [Image displayed inline]

## Figma Designs (1)
### Auth Flow Design - Login Screen
- Exported 3 image(s):
  - Login Form: ~/.config/figma-mcp/exports/...
  - Error States: ~/.config/figma-mcp/exports/...
  - Success State: ~/.config/figma-mcp/exports/...

Integración con Figma

Este MCP detecta automáticamente las URLs de Figma en las descripciones y comentarios de los tickets. Cuando figma-mcp está configurado:

  • Los enlaces de Figma se obtienen automáticamente.

  • Los marcos grandes se dividen en secciones para una mejor legibilidad.

  • Las imágenes se exportan a escala 2x para mayor claridad.

  • Todas las imágenes se muestran en línea en Claude Code.

Para habilitar la integración con Figma:

  1. Instala y configura figma-mcp

  2. Reinicia Claude Code

  3. Los enlaces de Figma se obtendrán automáticamente cuando obtengas un ticket

Referencia de la API

Herramientas

Herramienta

Descripción

Parámetros

jira_get_myself

Obtener el accountId e información del usuario autenticado actual (usar para asignar tickets)

ninguno

jira_get_ticket

Obtener un ticket por clave con descripción, comentarios, archivos adjuntos y diseños de Figma

issueKey (requerido), downloadImages, fetchFigma

jira_search

Buscar tickets usando JQL

jql (requerido), maxResults

jira_add_comment

Añadir un comentario a un ticket (soporta @menciones)

issueKey (requerido), comment (requerido)

jira_reply_comment

Responder a un comentario específico con cita y mención

issueKey (requerido), commentId (requerido), reply (requerido)

jira_edit_comment

Editar un comentario existente (soporta @menciones)

issueKey (requerido), commentId (requerido), comment (requerido)

jira_delete_comment

Eliminar un comentario (irreversible)

issueKey (requerido), commentId (requerido)

jira_transition

Cambiar el estado del ticket por nombre o ID (gestiona automáticamente los pasos intermedios)

issueKey (requerido), targetStatus o transitionId

jira_update_ticket

Actualizar campos del ticket (resumen, descripción, asignado, prioridad, etiquetas)

issueKey (requerido), más parámetros de campo opcionales

Herramientas de Confluence

Este MCP también expone Confluence mediante las mismas credenciales de Atlassian. En Atlassian Cloud, el token de API que configuraste para Jira también funciona para Confluence, y la URL base de Confluence se deriva como <jiraBaseUrl>/wikino se requiere configuración adicional. Simplemente usa las herramientas confluence_* a continuación contra cualquier instancia configurada.

Para implementaciones de Servidor / Data Center donde Confluence reside en un host diferente, establece confluenceBaseUrl explícitamente en la instancia almacenada en config.json.

Herramienta

Descripción

Parámetros

confluence_get_spaces

Listar espacios globales (key, name, id)

instance

confluence_get_space

Obtener un solo espacio con descripción y página de inicio

spaceKey (requerido), instance

confluence_create_space

Crear un nuevo espacio global

spaceKey (requerido), name (requerido), description, instance

confluence_update_space

Actualizar el nombre y/o descripción de un espacio

spaceKey (requerido), name, description, instance

confluence_delete_space

Eliminar un espacio (asíncrono en Cloud)

spaceKey (requerido), instance

confluence_search

Búsqueda de texto CQL (text ~ "<query>" AND type = <type>)

query (requerido), spaceKey, type, limit, instance

confluence_get_recent_pages

Páginas modificadas en los últimos N días

sinceDays (predeterminado 30), spaceKey, limit, instance

confluence_get_space_root_pages

Páginas de nivel superior en un espacio con childTypes.page

spaceKey (requerido), limit, instance

confluence_get_page_children

Páginas hijas directas de una página

pageId (requerido), limit, instance

confluence_get_page

Página completa con body.view, body.storage y (por defecto) v2 body.atlas_doc_format fusionado

pageId (requerido), includeAdf, instance

confluence_get_comments

Listar comentarios en una página

pageId (requerido), limit, instance

confluence_add_comment

Añadir un comentario al pie de página (texto plano envuelto en XHTML de almacenamiento por defecto)

pageId (requerido), body (requerido), format (text/storage), instance

confluence_update_page

Actualizar título/cuerpo; aumenta la versión automáticamente si no se proporciona

pageId (requerido), title, body (storage XHTML), version, instance

confluence_create_page

Crear una página con padre opcional

spaceKey, title, body (storage XHTML) (todos requeridos), parentId, instance

confluence_delete_page

Eliminar una página

pageId (requerido), instance

confluence_get_labels

Listar etiquetas en una página

pageId (requerido), instance

confluence_add_label

Añadir una etiqueta a una página

pageId (requerido), label (requerido), instance

confluence_remove_label

Eliminar una etiqueta de una página

pageId (requerido), label (requerido), instance

confluence_list_attachments

Listar archivos adjuntos en una página

pageId (requerido), limit, instance

confluence_upload_attachment

Subir un archivo desde el disco o contenido base64

pageId (requerido), filePath o fileContent+fileName, comment, instance

confluence_download_attachment

Descargar un archivo adjunto por nombre de archivo al directorio local de adjuntos

pageId (requerido), filename (requerido), instance

¿Por qué ADF para confluence_get_page? La expansión v1 body.atlas_doc_format no es fiable en las páginas modernas de Cloud: los colores de fondo de las celdas de las tablas y algunos tipos de nodos más nuevos solo sobreviven en el endpoint v2 /api/v2/pages/<id>?body-format=atlas_doc_format. Por lo tanto, confluence_get_page realiza ambas solicitudes en paralelo y fusiona el cuerpo ADF v2 en la respuesta v1, para que los llamadores obtengan body.view, body.storage y body.atlas_doc_format de una sola vez.

Configuración

Configuración almacenada en ~/.config/jira-mcp/config.json:

{
  "email": "your@email.com",
  "token": "YOUR_API_TOKEN",
  "baseUrl": "https://company.atlassian.net"
}

Manejo de errores

El servidor proporciona mensajes de error claros:

Error

Significado

Figma API rate limit exceeded

Demasiadas solicitudes a Figma, espera unos minutos

Figma access denied

Comprueba el token de Figma o los permisos del archivo

Figma not configured

Instala y configura figma-mcp

Seguridad

  • Los tokens de API se almacenan localmente en ~/.config/jira-mcp/config.json

  • Los archivos de configuración se excluyen de git mediante .gitignore

  • Los tokens nunca se registran ni se transmiten excepto a las APIs de Jira/Figma

  • Los archivos adjuntos se descargan en ~/.config/jira-mcp/attachments/

Licencia

MIT

Relacionado

A
license - permissive license
Not graded
quality - not tested
A
maintenance

Maintenance

Maintainers
Response time
7moRelease cycle
2Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    C
    quality
    D
    maintenance
    Connects Jira with Claude, enabling users to search issues, view issue details, update issues, add comments, and retrieve project information through natural language commands.
    1
    98
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables Claude AI to interact with JIRA for project management and issue tracking, supporting JQL queries, comprehensive issue details retrieval with subtasks and linked issues, and release planning analysis.
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Connects AI assistants like Claude to Jira projects, enabling natural language queries and operations for issue management, project tracking, comments, and workflows through the Jira REST API.
    14,799
    72
    ISC
  • A
    license
    Not graded
    quality
    A
    maintenance
    Provides Jira Cloud integration for AI agents, enabling them to search issues with JQL, retrieve detailed issue information, and create new tickets. It supports multiple Jira configurations and provides tools for managing attachments and comments through natural language.
    MIT

View all related MCP servers

Related MCP Connectors

  • Connect to Atlassian Jira, Confluence, and Compass to search, create, and manage your work.

  • Connect your team's living knowledge base — docs, data, issues, CRM — to Claude and ChatGPT.

  • Connect Claude to Fathom meeting recordings, transcripts, and summaries

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/rui-branco/jira-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server