Servidor Jira MCP

Habla con Jira en lenguaje natural para obtener información y modificar tu proyecto. Úsalo con Claude Desktop junto con un README personalizado que crearás con la información del proyecto para poder delegar tareas de gestión de proyectos (por ejemplo, si tienes una lista de mi equipo y sus especialidades, asigna cualquier problema nuevo a la persona más relevante).

Construido utilizando el Protocolo de Contexto de Modelo .

El servidor permite:

• Creación y configuración de proyectos

• Gestión de problemas y subtareas

• Vinculación de problemas y dependencias

• Flujos de trabajo de problemas automatizados

Configuración

Variables de entorno requeridas:

• JIRA_HOST : nombre de host de su instancia de Jira

• JIRA_EMAIL : El correo electrónico de su cuenta de Jira

• JIRA_API_TOKEN : Token de API de https://id.atlassian.com/manage-profile/security/api-tokens

Related MCP server: Jira MCP Server

Herramientas disponibles

1. Gestión de usuarios

// Get user's account ID by email
{
  email: "user@example.com";
}

2. Gestión del tipo de problema

// List all available issue types
// Returns: id, name, description, subtask status
// No parameters required

3. Tipos de enlaces de problemas

// List all available issue link types
// Returns: id, name, inward/outward descriptions
// No parameters required

4. Gestión de problemas

Recuperación de problemas

// Get all issues in a project
{
  projectKey: "PROJECT"
}

// Get issues with JQL filtering
{
  projectKey: "PROJECT",
  jql: "status = 'In Progress' AND assignee = currentUser()"
}

// Get issues assigned to user
{
  projectKey: "PROJECT",
  jql: "assignee = 'user@example.com' ORDER BY created DESC"
}

Creando problemas

// Create a standard issue
{
  projectKey: "PROJECT",
  summary: "Issue title",
  issueType: "Task",  // or "Story", "Bug", etc.
  description: "Detailed description",
  assignee: "accountId",  // from get_user tool
  labels: ["frontend", "urgent"],
  components: ["ui", "api"],
  priority: "High"
}

// Create a subtask
{
  parent: "PROJECT-123",
  projectKey: "PROJECT",
  summary: "Subtask title",
  issueType: "Subtask",
  description: "Subtask details",
  assignee: "accountId"
}

Problemas de actualización

// Update issue fields
{
  issueKey: "PROJECT-123",
  summary: "Updated title",
  description: "New description",
  assignee: "accountId",
  status: "In Progress",
  priority: "High"
}

Dependencias de problemas

// Create issue link
{
  linkType: "Blocks",  // from list_link_types
  inwardIssueKey: "PROJECT-124",  // blocked issue
  outwardIssueKey: "PROJECT-123"  // blocking issue
}

Eliminar problemas

// Delete single issue
{
  issueKey: "PROJECT-123"
}

// Delete issue with subtasks
{
  issueKey: "PROJECT-123",
  deleteSubtasks: true
}

// Delete multiple issues
{
  issueKeys: ["PROJECT-123", "PROJECT-124"]
}

Formato de campo

Campo de descripción

El campo de descripción admite formato estilo Markdown:

• Utilice líneas en blanco entre párrafos

• Utilice "- " para viñetas

• Utilice "1. " para listas numeradas

• Utilice encabezados que terminen con ":" (seguido de una línea en blanco)

Ejemplo:

Task Overview:

This task involves implementing new features:
- Feature A implementation
- Feature B testing

Steps:
1. Design component
2. Implement logic
3. Add tests

Acceptance Criteria:
- All tests passing
- Documentation updated

Manejo de errores

El servidor proporciona mensajes de error detallados para:

• Claves de emisión no válidas

• Faltan campos obligatorios

• Problemas de permisos

• Límites de velocidad de la API

Instrucciones de configuración

1. Clonar el repositorio:

   git clone https://github.com/George5562/Jira-MCP-Server.git
   cd Jira-MCP-Server

2. Instalar dependencias:

   npm install

3. Configurar variables de entorno: Cree un archivo .env en el directorio raíz:

   JIRA_HOST=your-instance.atlassian.net
   JIRA_EMAIL=your-email@example.com
   JIRA_API_TOKEN=your-api-token

4. Construir el proyecto:

   npm run build

5. Iniciar el servidor:

   npm start

Configuración de Claude Desktop

Para utilizar este servidor MCP con Claude Desktop:

1. Localice el archivo de configuración de Claude Desktop:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Ventanas: %APPDATA%/Claude/claude_desktop_config.json

   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Agregue el servidor Jira MCP a su configuración:

   {
     "mcp_servers": [
       {
         "name": "jira-server",
         "command": "npm start",
         "cwd": "/path/to/jira-server",
         "env": {
           "JIRA_HOST": "your-instance.atlassian.net",
           "JIRA_EMAIL": "your-email@example.com",
           "JIRA_API_TOKEN": "your-api-token"
         }
       }
     ]
   }

   Reemplace /path/to/jira-server con la ruta absoluta a su repositorio clonado.

3. Reinicie Claude Desktop para aplicar los cambios.

Referencias

• Protocolo de contexto modelo

• Documentación de la API REST de Jira

• Ejemplos de API REST de Jira