Jira MCP Server (compatible con el plan gratuito)

Un pequeño servidor MCP que permite a un cliente MCP (Claude Desktop, o cualquier cliente MCP) leer, crear, actualizar, comentar y transicionar incidencias de Jira. Construido y probado contra el plan gratuito de Jira Cloud: no se necesita una suscripción de pago de Jira.

Herramientas que expone

1. Obtén un sitio gratuito de Jira Cloud

1. Ve a https://www.atlassian.com/software/jira y regístrate (gratis, hasta 10 usuarios, proyectos ilimitados).

2. Crea un proyecto y anota su clave de proyecto (p. ej. PROJ), que se muestra junto al nombre del proyecto.

3. Crea un token de API en https://id.atlassian.com/manage-profile/security/api-tokens.

2. Instala las dependencias

cd jira-mcp-server
python3 -m venv venv
source venv/bin/activate        # on Windows: venv\Scripts\activate
pip install -r requirements.txt

3. Configura las credenciales

Copia .env.example a .env y completa tus valores, o simplemente expórtalos en tu shell:

export JIRA_BASE_URL=https://yourcompany.atlassian.net
export JIRA_EMAIL=you@example.com
export JIRA_API_TOKEN=your-api-token-here

4. Pruébalo directamente (no necesitas Claude Desktop)

Edita PROJECT_KEY / ISSUE_KEY al principio de test_client.py para que coincidan con tu proyecto de Jira, y luego:

python test_client.py

Esto inicia jira_server.py como un subproceso a través de stdio (de la misma manera que lo haría un cliente MCP real), lista las herramientas disponibles y ejercita get_issue, search_issues y create_issue contra tu sitio de Jira en vivo.

5. Conéctalo a Claude Desktop (opcional)

Añade esto a tu configuración de MCP de Claude Desktop (claude_desktop_config.json — Ajustes → Desarrollador → Editar configuración):

{
  "mcpServers": {
    "jira": {
      "command": "/absolute/path/to/jira-mcp-server/venv/bin/python",
      "args": ["/absolute/path/to/jira-mcp-server/jira_server.py"],
      "env": {
        "JIRA_BASE_URL": "https://yourcompany.atlassian.net",
        "JIRA_EMAIL": "you@example.com",
        "JIRA_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Reinicia Claude Desktop y pregúntale algo como "¿cuál es el estado de PROJ-1?" — debería llamar a la herramienta get_issue.

Notas / advertencias

• La API v3 de Jira almacena descripciones y comentarios en Atlassian Document Format (ADF), no en texto plano. El servidor se encarga de la conversión en ambas direcciones.

• El issue_type de create_issue debe coincidir exactamente con un tipo configurado en ese proyecto (comúnmente Task, Bug, Story, Epic) — revisa los tipos de incidencia de tu proyecto si recibes un error de "issuetype".

• El plan gratuito te limita a 100 ejecuciones de automatización al mes y 2 GB de almacenamiento — irrelevante para este tipo de pruebas manuales/API, pero conviene saberlo.

• Este servidor utiliza transporte stdio, lo que significa que solo se ejecuta localmente, lanzado por el cliente MCP que hable con él — no es un servicio web público, que es la forma más sencilla y común de probar MCP.