Skip to main content
Glama

Servidor JIRA MCP

insignia de herrería

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

  • npm instalado

  • Una 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

  1. Inicie sesión en su cuenta de Atlassian en https://id.atlassian.com

  2. Vaya a Configuración de seguridad

  3. En Tokens de API, seleccione "Crear token de API".

  4. Dale a tu token un nombre significativo (por ejemplo, "Servidor MCP")

  5. Copia el token generado: ¡no podrás volver a verlo!

  6. Utilice este token como su JIRA_API_KEY

  7. Utilice la dirección de correo electrónico asociada a su cuenta Atlassian como JIRA_USER_EMAIL

Uso

Integración con Claude Desktop

  1. 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"
      }
    }
  }
}
  1. 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 JQL

  • nextPageToken : Token para paginación

  • maxResults : Número máximo de resultados a devolver

  • fields : Matriz de nombres de campos a incluir

  • expand : 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 clave

  • fields : Matriz de nombres de campos a incluir

  • expand : Información adicional para incluir

  • properties : Matriz de propiedades a incluir

  • failFast : 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-token

Reemplace 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 claude

Instalación manual

  1. Clonar este repositorio:

git clone <repository-url>
cd jira-mcp
  1. Instalar dependencias:

npm install

Ejecutando con MCP Inspector

Para pruebas y desarrollo, puede utilizar el Inspector MCP:

npm run inspect

Agregar 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 tools
get_issueC

Retrieve details about an issue by its ID or key.

Inputs: issueIdOrKey (required), fields, expand, properties, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 2 tools

    Disambiguation5/5

    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).

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness2/5

    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

    Related MCP Servers