Atlassian MCP Server

¿Qué es el servidor Atlassian MCP?

El servidor Atlassian MCP es un servidor del Protocolo de Contexto de Modelo (MCP). Está diseñado para integrar productos de Atlassian (Confluence y Jira, tanto en la nube como en servidor/data center) con asistentes potentes en IA y herramientas para desarrolladores. Exponiendo las capacidades de Jira y Confluence como funciones ejecutables ("herramientas") a través de la interfaz MCP. Permite a LLMs y agentes automatizar, buscar e interactuar con el contenido de Atlassian de manera programática. Actúa como un puente seguro entre tu instancia de Atlassian y las aplicaciones host del MCP.

Cómo configurar el servidor Atlassian MCP

1. Configuración de autenticación: Elige tu método de autenticación preferido, según el tipo de despliegue:
   • Para Jira/Confluence Cloud: Usa Token de API (recomendado) u OAuth 2.0.
   • Para servidor/data center: Usa Token de Acceso Personal (PAT).
2. Variables de entorno: Prepara las variables de entorno para tus URLs de Atlassian, tokens y otras opciones (como filtros de proyecto/espacio, modo solo lectura y registro).
3. Instalación: Descarga la imagen de Docker (ghcr.io/sooperset/mcp-atlassian:latest) en tu entorno local o servidor.
4. Configuración en IDE o asistente:
   • Pasa directamente las variables de entorno a través de la configuración del servidor MCP de tu IDE (por ejemplo, en claude_desktop_config.json o la configuración de MCP de Cursor).
   • Alternativamente, crea un archivo de entorno y usa la opción --env-file de Docker.
5. Configuración del transporte: El servidor puede ejecutarse como un proceso usando stdio, o como un servicio HTTP persistente (usando SSE o transportes HTTP transmitibles) para implementaciones multiusuario o en red.
6. Soporte de proxy: Configura proxies HTTP(S)/SOCKS según sea necesario usando las variables de entorno correspondientes.
7. Control de herramientas: Usa ENABLED_TOOLS para restringir o permitir el acceso a operaciones específicas, y READ_ONLY_MODE para mayor seguridad.

Cómo usar el servidor Atlassian MCP

1. Iniciar el servidor: Lanza el servidor con tu configuración a través de Docker. Especifica opcionalmente herramientas habilitadas, registro o tipo de transporte.
2. Conectar a través de IDE o asistente de IA: Añade el servidor en funcionamiento como un servidor MCP en la configuración de tu IDE/asistente proporcionando el comando apropiado o el endpoint HTTP.
3. Invocar herramientas: Usa lenguaje natural o flujos personalizados para pedir ayuda a tu asistente con acciones de Jira y Confluence (por ejemplo, buscar, crear, actualizar, resumir).
4. Control de acceso: Filtra las herramientas disponibles, habilita/deshabilita operaciones de escritura y elige autenticación por usuario o en toda la servidor según sea necesario.
5. Monitorear y depurar: Visualiza logs, usa herramientas de depuración y monitorea interacciones para asegurar un funcionamiento fluido.

Características clave

• Compatible con Jira y Confluence (Cloud y Server/DC) en una única integración.
• Herramientas ejecutables: Expone APIs de Atlassian como herramientas invocables a través de MCP para usar por LLMs y agentes.
• Integración fluida con IDE/asistente: Configurable en Claude Desktop, Cursor y plataformas similares.
• Soporte multi-autenticación: Soporta OAuth 2.0, tokens de API y PATs. Permite autenticación tanto para un usuario como para varios usuarios.
• Despliegue seguro en infraestructuras: Mantiene credenciales y datos dentro de tu entorno.
• Filtrado de herramientas y modos solo lectura: Control fino sobre acciones y permisos disponibles.
• Soporte de proxy y logging: Listo para empresas con opciones personalizadas de proxy, registro y depuración detallada.
• Transporte HTTP escalable: Puede funcionar como un servicio HTTP persistente para usos compartidos o automatizados.

Casos de uso

• Búsqueda impulsada por IA: Encuentra y resume rápidamente documentación de proyectos y problemas utilizando consultas en lenguaje natural.
• Actualizaciones automáticas de Jira: Crea, actualiza, transiciona y comenta sobre problemas de Jira basado en notas de reuniones o comandos de chat.
• Generación de documentos: Crea y actualiza páginas de Confluence o tickets de Jira directamente desde tu asistente de IA o IDE.
• Informes y filtrado: Automatiza la obtención y resumen de errores urgentes, actualizaciones de estado y métricas de proyectos.
• Flujos de trabajo multiusuario: Habilita el acceso a acciones de Atlassian en toda la organización, respetando los permisos de cada usuario utilizando tokens por usuario.

Preguntas frecuentes

P: ¿Qué métodos de autenticación están soportados?
R: El servidor soporta Tokens de API de Atlassian (Cloud), Tokens de Acceso Personal (Server/DC) y OAuth 2.0 (Cloud, para escenarios avanzados y soporte multiusuario).

P: ¿Puedo restringir qué acciones proporciona el servidor MCP a mi asistente?
R: Sí, puedes especificar las herramientas habilitadas mediante la variable de entorno ENABLED_TOOLS o la opción de línea de comandos, y poner READ_ONLY_MODE para deshabilitar todas las operaciones de escritura.

P: ¿Cómo manejo problemas de certificados SSL en mi despliegue de Server/Data Center?
R: Establece CONFLUENCE_SSL_VERIFY=false o JIRA_SSL_VERIFY=false en tu configuración si tu instancia de Atlassian utiliza certificados autofirmados.

P: ¿Es posible ejecutar el servidor para múltiples usuarios con sus propias credenciales?
R: Sí, usa el transporte HTTP (SSE o HTTP transmitible) y cada cliente debe proporcionar tokens específicos del usuario (OAuth para Cloud o PAT para Server/DC).

P: ¿Qué pasa si mi asistente no puede conectarse a Jira o Confluence?
R: Verifica las credenciales de autenticación, la configuración de red/proxy, la precisión de la URL y los permisos de usuario en tu instancia de Atlassian.