Atlassian

MCP Atlassian

Servidor Model Context Protocol (MCP) para productos de Atlassian (Confluence y Jira). Compatible con implementaciones Cloud y Server/Data Center.

https://github.com/user-attachments/assets/35303504-14c6-4ae4-913b-7c25ea511c3e

Confluence Demo

https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785

Inicio Rápido

1. Obtén tu Token de API

Ve a https://id.atlassian.com/manage-profile/security/api-tokens y crea un token.

Para Server/Data Center, usa un Personal Access Token en su lugar. Consulta Autenticación.

2. Configura tu IDE

Añade a tu configuración MCP de Claude Desktop o Cursor:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      }
    }
  }
}

Usuarios de Server/Data Center: Usa JIRA_PERSONAL_TOKEN en lugar de JIRA_USERNAME + JIRA_API_TOKEN. Consulta Autenticación para más detalles.

Autohand Code

Usa el mismo servidor uvx con tus credenciales de Atlassian:

autohand mcp add mcp-atlassian env \
  JIRA_URL=https://your-company.atlassian.net \
  JIRA_USERNAME=your.email@company.com \
  JIRA_API_TOKEN=your_api_token \
  CONFLUENCE_URL=https://your-company.atlassian.net/wiki \
  CONFLUENCE_USERNAME=your.email@company.com \
  CONFLUENCE_API_TOKEN=your_api_token \
  uvx mcp-atlassian

Añade --scope project después de add para mantener la configuración en el proyecto actual. Consulta Autohand Code para obtener detalles actuales de instalación y CLI.

3. Empieza a Usar

Pide a tu asistente de IA que:

• "Busca incidencias asignadas a mí en el proyecto PROJ"
• "Busca en Confluence documentos de onboarding"
• "Crea un ticket de error para el problema de inicio de sesión"
• "Actualiza el estado de PROJ-123 a Done"

Documentación

La documentación completa está disponible en mcp-atlassian.soomiles.com.

La documentación también está disponible en formato llms.txt, que los LLM pueden consumir fácilmente:

• llms.txt — mapa del sitio de documentación
• llms-full.txt — documentación completa

Tema	Descripción
Instalación	uvx, Docker, pip, desde el código fuente
Autenticación	Tokens de API, PAT, OAuth 2.0
Configuración	Configuración del IDE, variables de entorno
Transporte HTTP	SSE, streamable-http, multi-usuario
Referencia de Herramientas	Todas las herramientas de Jira y Confluence
Solución de Problemas	Problemas comunes y depuración

Compatibilidad

Producto	Implementación	Soporte
Confluence	Cloud	Totalmente compatible
Confluence	Server/Data Center	Compatible (v6.0+)
Jira	Cloud	Totalmente compatible
Jira	Server/Data Center	Compatible (v8.14+)

Herramientas Clave

Jira	Confluence
jira_search - Buscar con JQL	confluence_search - Buscar con CQL
jira_get_issue - Obtener detalles de la incidencia	confluence_get_page - Obtener contenido de la página
jira_create_issue - Crear incidencias	confluence_create_page - Crear páginas
jira_update_issue - Actualizar incidencias	confluence_update_page - Actualizar páginas
jira_transition_issue - Cambiar estado	confluence_add_comment - Añadir comentarios

98 herramientas en total — Consulta la Referencia de Herramientas para ver la lista completa.

Seguridad

Nunca compartas tokens de API. Mantén seguros los archivos .env. Consulta SECURITY.md.

Contribuciones

Consulta CONTRIBUTING.md para la configuración de desarrollo.

Licencia

MIT - Consulta LICENSE. No es un producto oficial de Atlassian.