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 Tools

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

Clonar el repositorio:

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

Instalar dependencias:
```
npm install
```

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

Construir el proyecto:
```
npm run build
```
Iniciar el servidor:
```
npm start
```

Configuración de Claude Desktop

Para utilizar este servidor MCP con Claude Desktop:

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

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.

Reinicie Claude Desktop para aplicar los cambios.

Jira MCP Server