MCP Atlassian

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

Perfil de fork progresivo

Este fork mantiene la superficie directa de MCP de Atlassian del upstream y añade un perfil progresivo local controlado por MCP_PROFILE=progressive. En modo progresivo, el servidor expone solo envoltorios de descubrimiento/esquema/ejecución como jira_discover, jira_capability_schema, jira_execute_read y jira_execute_write_guarded en lugar de la superficie completa de herramientas directas.

El upstream sooperset/mcp-atlassian no incluye actualmente esta capa progresiva, por lo que las actualizaciones del upstream deben reconciliarse de forma selectiva. No fusiones el upstream a ciegas o el paquete/pruebas progresivas podrían eliminarse. Consulta FORK_WORKFLOW.md.

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

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

Related MCP server: MCP Atlassian

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 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 detalles actuales de instalación y CLI.

3. Empieza a usarlo

Pide a tu asistente de IA que:

• "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"

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 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.