Skip to main content
Glama
Jira MCP Server

Jira MCP Server

Servidor Jira MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la API REST de Jira mediante la biblioteca jira-python . Este servidor se integra con Claude Desktop y otros clientes MCP, lo que permite interactuar con Jira mediante comandos de lenguaje natural.

Características

  • Obtenga todos los proyectos de Jira accesibles

  • Obtener detalles de un problema específico de Jira

  • Problemas de búsqueda con JQL (lenguaje de consulta de Jira)

  • Crear nuevos problemas de Jira

  • Añadir comentarios a los problemas

  • Obtener transiciones disponibles para un problema

  • Cuestiones de transición hacia nuevos estatus

Related MCP server: JIRA MCP Tools

Instalación

Prerrequisitos

  • Python 3.9 o superior

  • Una instancia de Jira (nube, servidor o centro de datos)

  • uv (opcional pero recomendado para la gestión de dependencias)

Activar un entorno virtual (recomendado)

# Install a Virtual Environment (VENV) in the mcp server directory
python -m venv .
# Activate the virtual environment
source bin/activate

Uso de uv (recomendado)

# Install uv if you don't have it
pip install uv

# Install the Jira MCP server
uv pip install mcp-server-jira

Usando pip

pip install mcp-server-jira

Configuración

Variables de entorno

Configurar el servidor usando variables de entorno:

  • JIRA_SERVER_URL : URL de su servidor Jira

  • JIRA_AUTH_METHOD : Método de autenticación ('basic_auth' o 'token_auth')

  • JIRA_USERNAME : Nombre de usuario para la autenticación básica

  • JIRA_PASSWORD : Contraseña para autenticación básica

  • JIRA_TOKEN : Token de API o token de acceso personal

Expediente Medioambiental (Desarrollo Local)

También puede crear un archivo .env en el directorio raíz con su configuración:

JIRA_SERVER_URL=https://your-jira-instance.atlassian.net
JIRA_AUTH_METHOD=basic_auth
JIRA_USERNAME=your_email@example.com
JIRA_TOKEN=your_api_token

Uso

Línea de comandos

python -m mcp_server_jira

Estibador

docker build -t mcp-jira .
docker run --env-file .env -p 8080:8080 mcp-jira

Integración de escritorio de Claude

Para utilizar este servidor con Claude Desktop:

  1. Instale el servidor utilizando uno de los métodos anteriores

  2. En Claude Desktop:

    • Vaya a Configuración -> Desarrollador

    • Haga clic en Editar configuración

    • Abra la configuración json en el editor de su elección

    • Agregue el siguiente JSON: ( NOTE : Las variables de entorno utilizadas son para la autenticación de token y no funcionarán con otros métodos de autenticación)

{
  "mcpServers": {
    "jira": {
      "command": "<PATH TO UV> i.e. /Users/<MYUSERNAME>/.local/bin/uv",
      "args": [
          "--directory",
          "<PATH TO JIRA MCP>",
          "run",
          "mcp-server-jira"
      ],
      "env": {
          "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
          "JIRA_AUTH_METHOD": "token_auth",
          "JIRA_USERNAME": "<USERNAME>",
          "JIRA_TOKEN": "<TOKEN>"
      }
    }
  }
}
  1. Ahora puedes interactuar con Jira haciéndole a Claude preguntas como:

    • "Muéstrame todos mis proyectos en Jira"

    • Obtener detalles del problema PROYECTO-123

    • "Crear un nuevo error en el PROYECTO con el resumen 'Solucionar problema de inicio de sesión'"

    • "Buscar todos los errores abiertos que me han sido asignados"

Autenticación

El servidor admite múltiples métodos de autenticación:

Autenticación básica

Para Jira Server/Data Center con nombre de usuario y contraseña:

JIRA_SERVER_URL="https://jira.example.com"
JIRA_AUTH_METHOD="basic_auth"
JIRA_USERNAME="your_username"
JIRA_PASSWORD="your_password"

Token de API (Jira Cloud)

Para Jira Cloud usando un token de API:

JIRA_SERVER_URL="https://your-domain.atlassian.net"
JIRA_AUTH_METHOD="basic_auth"
JIRA_USERNAME="your_email@example.com"
JIRA_TOKEN="your_api_token"

Token de acceso personal (Jira Server/Data Center)

Para Jira Server/Data Center (8.14+) usando un PAT:

JIRA_SERVER_URL="https://jira.example.com"
JIRA_AUTH_METHOD="token_auth"
JIRA_TOKEN="your_personal_access_token"

Herramientas disponibles

  1. get_projects : Obtener todos los proyectos de Jira accesibles

  2. get_issue : obtener detalles de un problema específico de Jira por clave

  3. search_issues : busca problemas de Jira usando JQL

  4. create_issue : Crea un nuevo problema de Jira

  5. add_comment : Agregar un comentario a un problema de Jira

  6. get_transitions : Obtener las transiciones de flujo de trabajo disponibles para un problema de Jira

  7. transition_issue : Transición de un problema de Jira a un nuevo estado

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Available Tools

10 tools
add_jira_commentC

Add a comment to a Jira issue

Inputs: comment (required), issue_key (required).

create_jira_issueC

Create a new Jira issue. Common issue types include 'Bug', 'Task', 'Story', 'Epic' (capitalization handled automatically)

Inputs: description (required), issue_type (required), project (required), summary (required), +1 more.

create_jira_issuesC

Bulk create new Jira issues. IMPORTANT: For 'issue_type', use the exact case-sensitive types in your Jira instance (common: 'Bug', 'Task', 'Story', 'Epic')

Inputs: field_list (required), prefetch.

create_jira_projectC

Create a new Jira project

Inputs: key (required), assignee, avatarId, categoryId, +8 more.

get_jira_issueC

Get details for a specific Jira issue by key

Inputs: issue_key (required).

get_jira_project_issue_typesB

Get all available issue types for a specific Jira project

Inputs: project_key (required).

get_jira_projectsB

Get all accessible Jira projects

Inputs: no named parameters.

get_jira_transitionsC

Get available workflow transitions for a Jira issue

Inputs: issue_key (required).

search_jira_issuesC

Search for Jira issues using JQL (Jira Query Language)

Inputs: jql (required), max_results.

transition_jira_issueC

Transition a Jira issue to a new status

Inputs: issue_key (required), transition_id (required), comment, fields.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 10 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose targeting specific Jira resources and actions. The tools cover different operations like creation, retrieval, searching, and transitions without overlap, making it easy for an agent to select the right tool for each task.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with 'jira' as a prefix (e.g., create_jira_issue, get_jira_projects). The naming is uniform across all tools, using snake_case and clear action verbs, which enhances predictability and readability.

    Tool Count5/5

    With 10 tools, this server is well-scoped for Jira operations, covering core functionalities like issue management, project handling, and workflow transitions. Each tool serves a specific purpose without redundancy, making the count appropriate for the domain.

    Completeness4/5

    The tool set provides comprehensive coverage for key Jira workflows, including CRUD operations for issues and projects, searching, and transitions. A minor gap is the lack of tools for updating or deleting issues or projects, which agents might need to work around, but core operations are well-covered.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that enables interaction with JIRA APIs through Claude Desktop, allowing users to search, create, update, and manage JIRA issues using natural language commands.
      1
      -
    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI assistants like Claude to interact with Jira, allowing for project management tasks such as listing projects, searching issues, creating tickets, and managing sprints through natural language queries.
      7
      2
      TypeScript
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI assistants like Claude to interact with Jira Cloud instances, providing capabilities for issue management, project listing, and JQL search.
      1
      2
      MIT