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 Server

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:

Instale el servidor utilizando uno de los métodos anteriores
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>" } } } }

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

get_projects : Obtener todos los proyectos de Jira accesibles
get_issue : obtener detalles de un problema específico de Jira por clave
search_issues : busca problemas de Jira usando JQL
create_issue : Crea un nuevo problema de Jira
add_comment : Agregar un comentario a un problema de Jira
get_transitions : Obtener las transiciones de flujo de trabajo disponibles para un problema de Jira
transition_issue : Transición de un problema de Jira a un nuevo estado