MCP Atlassian

Servidor del Model Context Protocol (MCP) para productos de Atlassian (Confluence y Jira). Admite despliegues tanto en Cloud como en Server/Data Center.

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

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 token de acceso personal en su lugar. Consulta Autenticación.

2. Configura tu IDE

Añade lo siguiente a tu configuración de 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 información actualizada sobre la instalación y la CLI.

3. Empieza a usarlo

Pídele a tu asistente de IA lo siguiente:

• "Encuentra incidencias asignadas a mí en el proyecto PROJ"

• "Busca en Confluence documentos de incorporación"

• "Crea un ticket de error para el problema de inicio de sesión"

• "Actualiza el estado de PROJ-123 a Done"

Related MCP server: MCP Atlassian Server

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

Compatibilidad

Herramientas clave

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

Seguridad

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

Cómo contribuir

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

Licencia

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