jira-mcp
Servidor JIRA MCP
Un servidor MCP que permite que los Modelos de Lenguaje Grandes (LLM) interactúen con JIRA mediante herramientas y contexto estandarizados. Este servidor ofrece funciones para buscar incidencias mediante JQL y recuperar información detallada sobre ellas.
Características
Búsqueda JQL : Ejecute consultas JQL complejas con soporte de paginación
Detalles del problema : recupera información detallada sobre problemas específicos de JIRA
Related MCP server: JIRA MCP Server
Prerrequisitos
npminstaladoUna instancia de JIRA con acceso a API
Token de API de JIRA o token de acceso personal
Correo electrónico del usuario de JIRA asociado con el token de API
Obtención de credenciales de API de JIRA
Inicie sesión en su cuenta de Atlassian en https://id.atlassian.com
Vaya a Configuración de seguridad
En Tokens de API, seleccione "Crear token de API".
Dale a tu token un nombre significativo (por ejemplo, "Servidor MCP")
Copia el token generado: ¡no podrás volver a verlo!
Utilice este token como su
JIRA_API_KEYUtilice la dirección de correo electrónico asociada a su cuenta Atlassian como
JIRA_USER_EMAIL
Uso
Integración con Claude Desktop
Agregue la configuración del servidor al archivo de configuración de Claude Desktop:
macOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"jira": {
"command": "npx",
"args": ["-y", "jira-mcp"],
"env": {
"JIRA_INSTANCE_URL": "https://your-instance.atlassian.net",
"JIRA_USER_EMAIL": "your-email@company.com",
"JIRA_API_KEY": "your-api-token"
}
}
}
}Reinicie Claude Desktop para cargar la nueva configuración.
Herramientas disponibles
1. Búsqueda JQL ( jql_search )
Ejecuta una consulta de búsqueda JQL con parámetros personalizables.
Parámetros :
jql(obligatorio): cadena de consulta JQLnextPageToken: Token para paginaciónmaxResults: Número máximo de resultados a devolverfields: Matriz de nombres de campos a incluirexpand: Información adicional para incluir
Ejemplo :
{
"jql": "project = 'MyProject' AND status = 'In Progress'",
"maxResults": 10,
"fields": ["summary", "status", "assignee"]
}2. Obtener problema ( get_issue )
Recupera información detallada sobre un problema específico.
Parámetros :
issueIdOrKey(obligatorio): ID del problema o clavefields: Matriz de nombres de campos a incluirexpand: Información adicional para incluirproperties: Matriz de propiedades a incluirfailFast: si se debe fallar rápidamente ante errores
Ejemplo :
{
"issueIdOrKey": "PROJ-123",
"fields": ["summary", "description", "status"],
"expand": "renderedFields,names"
}Desarrollo
Configuración
Configure las variables de entorno antes de ejecutar el servidor. Cree un archivo .env en el directorio raíz:
JIRA_INSTANCE_URL=https://your-instance.atlassian.net
JIRA_USER_EMAIL=your-email@company.com
JIRA_API_KEY=your-api-tokenReemplace los valores con:
La URL real de su instancia de JIRA
La dirección de correo electrónico asociada a su cuenta de JIRA
Su token de API de JIRA (se puede generar en la configuración de la cuenta de Atlassian)
Instalación
Instalación mediante herrería
Para instalar JIRA para Claude Desktop automáticamente a través de Smithery :
npx -y @smithery/cli install jira-mcp --client claudeInstalación manual
Clonar este repositorio:
git clone <repository-url>
cd jira-mcpInstalar dependencias:
npm installEjecutando con MCP Inspector
Para pruebas y desarrollo, puede utilizar el Inspector MCP:
npm run inspectAgregar nuevas herramientas
Para agregar nuevas herramientas, modifique el controlador ListToolsRequestSchema en index.js :
server.setRequestHandler(ListToolsRequestSchema, async () => {
return {
tools: [
// Existing tools...
{
name: "your_new_tool",
description: "Description of your new tool",
inputSchema: {
// Define input schema...
}
}
]
};
});Luego implemente la herramienta en el controlador CallToolRequestSchema .
Licencia
Instituto Tecnológico de Massachusetts (MIT)
Contribuyendo
¡Agradecemos sus contribuciones! No dude en enviar un PR.
Available Tools
2 toolsget_issueC
Retrieve details about an issue by its ID or key.
Inputs: issueIdOrKey (required), fields, expand, properties, +1 more.
jql_searchC
Perform enhanced JQL search in Jira
Inputs: jql (required), nextPageToken, maxResults, fields, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: get_issue retrieves a single issue by ID/key, while jql_search performs broader queries using JQL. There is no overlap or ambiguity between them, as they serve different use cases (specific lookup vs. flexible search).
Both tools follow a consistent snake_case naming pattern with clear verb_noun structure: get_issue and jql_search. The naming is predictable and readable, with no deviations or mixed conventions.
With only 2 tools, this server feels severely under-scoped for a Jira integration. A typical Jira MCP would need more operations like create_issue, update_issue, or list_projects to cover basic workflows. The current set is too thin for meaningful agent interaction.
The tool surface is significantly incomplete for Jira's domain. While get_issue and jql_search provide read/search capabilities, there are major gaps in CRUD operations (no create, update, or delete) and missing lifecycle management (e.g., transitions, comments). This will cause agent failures in common scenarios.
Related MCP Connectors
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
List, view, create, edit, delete, link, comment on, and see the history of Laraue Boards issues.
Search and read Zammad tickets, customers and organizations; add notes, replies and ticket updates.
Search tickets, people, organizations and KB articles in Deskpro, and create tickets and replies.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI models to search Jira issues using JQL and retrieve issue details through the Jira 9.12.14 API.MIT
- AlicenseAqualityDmaintenanceEnables interaction with Jira issues via JQL search, epic management, comments, attachments, and issue CRUD, with support for both Cloud and Server/Data Center instances.931 npmMIT
- AlicenseNot gradedqualityCmaintenanceProvides JIRA issue search, retrieval, and update functionalities via MCP.71 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables querying Jira issues using JQL and creating new issues programmatically via natural language.708 npmMIT