Jira MCP Server
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-mcpPaso 2: Obtén tu token de API de Jira
Haz clic en "Create API token"
Introduce una etiqueta (p. ej., "Claude Code MCP")
Haz clic en "Create"
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 |
Tu correo electrónico de la cuenta de Atlassian |
| |
API Token | El token que creaste en el Paso 2 |
|
Base URL | La URL de tu instancia de Jira |
|
O ejecútalo de forma interactiva (solicitará cada valor):
npx @rui.branco/jira-mcp setupPaso 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.jsLuego añádelo a Claude Code:
claude mcp add --transport stdio jira -- node $HOME/.config/jira-mcp/index.jsUso
Obtener un ticket
> Get ticket PROJ-123
# Returns full ticket with description, comments, attachments, and Figma designsBuscar tickets
> Search for my open tickets
# Uses JQL: assignee = currentUser() AND status != DoneAñ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 notifiedEjemplo 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:
Instala y configura figma-mcp
Reinicia Claude Code
Los enlaces de Figma se obtendrán automáticamente cuando obtengas un ticket
Referencia de la API
Herramientas
Herramienta | Descripción | Parámetros |
| Obtener el accountId e información del usuario autenticado actual (usar para asignar tickets) | ninguno |
| Obtener un ticket por clave con descripción, comentarios, archivos adjuntos y diseños de Figma |
|
| Buscar tickets usando JQL |
|
| Añadir un comentario a un ticket (soporta @menciones) |
|
| Responder a un comentario específico con cita y mención |
|
| Editar un comentario existente (soporta @menciones) |
|
| Eliminar un comentario (irreversible) |
|
| Cambiar el estado del ticket por nombre o ID (gestiona automáticamente los pasos intermedios) |
|
| Actualizar campos del ticket (resumen, descripción, asignado, prioridad, etiquetas) |
|
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>/wiki — no 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 |
| Listar espacios globales ( |
|
| Obtener un solo espacio con descripción y página de inicio |
|
| Crear un nuevo espacio global |
|
| Actualizar el nombre y/o descripción de un espacio |
|
| Eliminar un espacio (asíncrono en Cloud) |
|
| Búsqueda de texto CQL ( |
|
| Páginas modificadas en los últimos N días |
|
| Páginas de nivel superior en un espacio con |
|
| Páginas hijas directas de una página |
|
| Página completa con |
|
| Listar comentarios en una página |
|
| Añadir un comentario al pie de página (texto plano envuelto en XHTML de almacenamiento por defecto) |
|
| Actualizar título/cuerpo; aumenta la versión automáticamente si no se proporciona |
|
| Crear una página con padre opcional |
|
| Eliminar una página |
|
| Listar etiquetas en una página |
|
| Añadir una etiqueta a una página |
|
| Eliminar una etiqueta de una página |
|
| Listar archivos adjuntos en una página |
|
| Subir un archivo desde el disco o contenido base64 |
|
| Descargar un archivo adjunto por nombre de archivo al directorio local de adjuntos |
|
¿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 |
| Demasiadas solicitudes a Figma, espera unos minutos |
| Comprueba el token de Figma o los permisos del archivo |
| Instala y configura figma-mcp |
Seguridad
Los tokens de API se almacenan localmente en
~/.config/jira-mcp/config.jsonLos archivos de configuración se excluyen de git mediante
.gitignoreLos 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
figma-mcp - Servidor MCP de Figma para Claude Code
Protocolo de Contexto de Modelo - Especificación MCP
This server cannot be installed
Maintenance
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
- AlicenseCqualityDmaintenanceConnects Jira with Claude, enabling users to search issues, view issue details, update issues, add comments, and retrieve project information through natural language commands.1981MIT
- AlicenseNot gradedqualityDmaintenanceEnables 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
- AlicenseNot gradedqualityDmaintenanceConnects 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,79972ISC
- AlicenseNot gradedqualityAmaintenanceProvides 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
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
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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