Jira MCP Server

Jira MCP Server

Servidor de Model Context Protocol (MCP) que conecta Jira con Claude.

Funciones

• Búsqueda de issues: Buscar issues de Jira usando JQL
• Consulta de issues: Ver información detallada de un issue específico
• Creación de issues: Crear nuevos issues de Jira
• Actualización de issues: Modificar issues existentes (título, descripción, estado, responsable)
• Añadir comentarios: Añadir comentarios a un issue
• Información de proyectos: Consultar información de proyectos

Instalación y configuración

1. Configuración de variables de entorno

Cree el archivo .env e introduzca la siguiente información:

JIRA_URL=https://your-domain.atlassian.net
JIRA_USERNAME=your-email@domain.com
JIRA_API_TOKEN=your-api-token
DEFAULT_PROJECT_KEY=PROJ

Nota: Los archivos de configuración se crean automáticamente en la carpeta config/.

2. Creación de token de API de Jira

1. Inicie sesión en Jira
2. Configuración de la cuenta > Seguridad > Crear token de API
3. Introduzca el token generado en JIRA_API_TOKEN del archivo .env

3. Instalación de dependencias

npm install

4. Configuración automática (recomendada)

Puede configurarlo fácilmente mediante la herramienta de configuración interactiva:

npm run setup

Este comando:

• Solicita la información de conexión de Jira
• Crea automáticamente el archivo config/.env
• Crea automáticamente el archivo config/claude_desktop_config.json
• Guía la configuración de Claude Desktop

5. Configuración manual (opcional)

Si desea configurarlo manualmente en lugar de usar la configuración automática, copie el archivo config/.env.example y renómbrelo como config/.env, luego modifique los valores.

6. Ejecución del servidor

npm start

Configuración de Claude Desktop

Para usar este servidor MCP en Claude Desktop, debe modificar el archivo de configuración.

Windows

Edite el archivo %APPDATA%\\Claude\\claude_desktop_config.json:

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["C:\\path\\to\\jira-mcp-server\\index.js"],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "your-email@domain.com",
        "JIRA_API_TOKEN": "your-api-token",
        "DEFAULT_PROJECT_KEY": "PROJ"
      }
    }
  }
}

macOS

Edite el archivo ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/jira-mcp-server/index.js"],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "your-email@domain.com", 
        "JIRA_API_TOKEN": "your-api-token",
        "DEFAULT_PROJECT_KEY": "PROJ"
      }
    }
  }
}

Ejemplos de uso

Puede usar los siguientes comandos en Claude:

Búsqueda de issues

"프로젝트 PROJ에서 상태가 Open인 이슈들을 찾아줘"

Creación de issues

"PROJ 프로젝트에 '새로운 기능 개발' 제목으로 Task 이슈를 생성해줘"

Actualización de issues

"PROJ-123 이슈의 상태를 'In Progress'로 변경해줘"

Añadir comentarios

"PROJ-123 이슈에 '작업을 시작했습니다' 댓글을 추가해줘"

Herramientas compatibles

1. search_issues: Buscar issues con JQL
2. get_issue: Consultar un issue específico
3. create_issue: Crear un nuevo issue
4. update_issue: Actualizar un issue
5. add_comment: Añadir un comentario
6. get_project_info: Consultar información del proyecto

Solución de problemas

Errores de autenticación

• Verifique que la URL de Jira sea correcta
• Verifique que el token de API sea válido
• Verifique que el correo electrónico del usuario sea correcto

Errores de permisos

• Verifique que el usuario tenga acceso al proyecto correspondiente
• Verifique que tenga permisos para crear/modificar issues

Licencia

MIT License