Servidor Jira MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para la integración con Jira. Este servidor permite que asistentes de IA como Claude interactúen con Jira mediante MCP.

Autor: Samuel Rizzo

Características

• Listar todos los proyectos de Jira
• Obtenga información detallada del problema
• Buscar problemas por proyecto y asignado
• Lista de los miembros del proyecto
• Verificar la membresía del proyecto del usuario y los problemas asignados
• Crear nuevos problemas con campos personalizados
• Listar y consultar sprints con opciones de filtrado

Instalación

Configuración

Configuración del servidor MCP

Agregue la siguiente configuración a su archivo de configuración de cursor/windsurf mcp:

Configuración del acceso a la API

1. Generar un token de API de Jira:
   • Vaya a la configuración de la cuenta de Atlassian
   • Haga clic en "Crear token de API".
   • Dale un nombre y haz clic en "Crear"
   • Copia el token (lo necesitarás para la autenticación)
2. Anote la URL de su host Jira (por ejemplo, your-domain.atlassian.net ) y la dirección de correo electrónico asociada con su cuenta Atlassian.
3. Agregue estas credenciales a la configuración de su servidor MCP.

Herramientas disponibles

1. Lista de proyectos ( mcp_jira_list_projects )

Enumera todos los proyectos de Jira a los que el usuario autenticado tiene acceso.

Parámetros:

• jiraHost : tu dominio Jira (p. ej., 'tu-dominio.atlassian.net')
• email : Su correo electrónico de Jira
• apiToken : Su token de API de Jira

2. Obtener detalles del problema ( mcp_jira_get_issue )

Recupera información detallada sobre un problema específico de Jira.

Parámetros:

• issueKey : la clave del problema de Jira (por ejemplo, 'PROJECT-123')
• jiraHost : Su dominio Jira
• email : Su correo electrónico de Jira
• apiToken : Su token de API de Jira

3. Problemas de búsqueda ( mcp_jira_search_issues )

Busca problemas en un proyecto específico, opcionalmente filtrados por asignado.

Parámetros:

• projectKey : La clave del proyecto Jira
• assigneeName : (opcional) Filtrar problemas por nombre del cesionario
• jiraHost : Su dominio Jira
• email : Su correo electrónico de Jira
• apiToken : Su token de API de Jira

4. Lista de miembros del proyecto ( mcp_jira_list_project_members )

Enumera todos los miembros de un proyecto Jira específico.

Parámetros:

• projectKey : La clave del proyecto Jira
• jiraHost : Su dominio Jira
• email : Su correo electrónico de Jira
• apiToken : Su token de API de Jira

5. Comprobar problemas de usuario ( mcp_jira_check_user_issues )

Comprueba si un usuario es miembro de un proyecto y enumera sus problemas asignados.

Parámetros:

• projectKey : La clave del proyecto Jira
• userName : El nombre para mostrar del usuario a comprobar
• jiraHost : Su dominio Jira
• email : Su correo electrónico de Jira
• apiToken : Su token de API de Jira

6. Crear problema ( mcp_jira_create_issue )

Crea un nuevo problema en un proyecto Jira con detalles específicos.

Parámetros:

• projectKey : La clave del proyecto Jira
• summary : El título/resumen del problema
• description : Descripción detallada del problema.
• issueType : (opcional) Tipo de problema (por ejemplo, 'Tarea', 'Error', 'Historia'), el valor predeterminado es 'Tarea'
• assigneeName : (opcional) El nombre para mostrar de la persona a la que se le asignará el problema
• reporterName : (opcional) El nombre para mostrar de la persona que informa el problema
• sprintId : (opcional) ID del sprint al que se agregará el problema
• jiraHost : Su dominio Jira
• email : Su correo electrónico de Jira
• apiToken : Su token de API de Jira

7. Lista de sprints ( mcp_jira_list_sprints )

Enumera los sprints actuales en Jira con opciones de filtrado.

Parámetros:

• boardId : (opcional) ID del tablero de Jira para filtrar sprints por un tablero específico
• projectKey : (opcional) Clave del proyecto para encontrar sprints asociados con el proyecto
• state : (opcional) Estado del sprint para filtrar por (activo, futuro, cerrado o todos), el valor predeterminado es 'activo'
• jiraHost : Su dominio Jira
• email : Su correo electrónico de Jira
• apiToken : Su token de API de Jira

Ejemplos de uso

A continuación se muestran algunos ejemplos de consultas que puedes utilizar con Claude:

Desarrollo continuo

Este proyecto se encuentra en desarrollo activo. Se añaden nuevas herramientas y funciones periódicamente para ampliar la integración con Jira. Las próximas actualizaciones incluirán:

• Herramientas adicionales de gestión de problemas
• Gestión de sprints y tableros
• Opciones avanzadas de búsqueda y filtrado
• Manejo de campos personalizados
• Transiciones de flujo de trabajo
• ¡Y más!

Manténgase atento mirando o marcando con una estrella el repositorio para obtener actualizaciones.

Contribuyendo

Este es un proyecto de código abierto y se agradecen las contribuciones. Para contribuir:

1. Bifurcar el repositorio
2. Crea tu rama de funciones
3. Realiza tus cambios
4. Enviar una solicitud de extracción

Código abierto

Este código es completamente de código abierto. Puedes:

• Copiar
• Modificar
• Distribuir
• Uso comercial
• Uso privado

¡Sin restricciones! ¡Haz lo que quieras con el código!

Licencia

Instituto Tecnológico de Massachusetts (MIT)