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/activateUso de uv (recomendado)
# Install uv if you don't have it
pip install uv
# Install the Jira MCP server
uv pip install mcp-server-jiraUsando pip
pip install mcp-server-jiraConfiguración
Variables de entorno
Configurar el servidor usando variables de entorno:
JIRA_SERVER_URL: URL de su servidor JiraJIRA_AUTH_METHOD: Método de autenticación ('basic_auth' o 'token_auth')JIRA_USERNAME: Nombre de usuario para la autenticación básicaJIRA_PASSWORD: Contraseña para autenticación básicaJIRA_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_tokenUso
Línea de comandos
python -m mcp_server_jiraEstibador
docker build -t mcp-jira .
docker run --env-file .env -p 8080:8080 mcp-jiraIntegració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 accesiblesget_issue: obtener detalles de un problema específico de Jira por clavesearch_issues: busca problemas de Jira usando JQLcreate_issue: Crea un nuevo problema de Jiraadd_comment: Agregar un comentario a un problema de Jiraget_transitions: Obtener las transiciones de flujo de trabajo disponibles para un problema de Jiratransition_issue: Transición de un problema de Jira a un nuevo estado
Licencia
Instituto Tecnológico de Massachusetts (MIT)
Available Tools
10 toolsadd_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
Scored across 10 tools
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.
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.
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.
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
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Related MCP Servers
- FlicenseDqualityDmaintenanceA Model Context Protocol server that enables integration with JIRA, allowing users to interact with JIRA tasks and issues through Claude AI assistant.33-
- FlicenseNot gradedqualityDmaintenanceA 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-
- AlicenseAqualityDmaintenanceA 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.72TypeScriptMIT
- AlicenseCqualityDmaintenanceA 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.12MIT