MCP Atlassian
Integración comunitaria de sooperset para consultar y actualizar Jira y Confluence desde clientes compatibles con MCP.
Fuente: MCP Atlassian · fuente del proyecto · Oficial · Mantiene sooperset · Licencia MIT · Ver original en github.com
Ficha técnica
- Mantenedor
- sooperset (se abre en una pestaña nueva)
- Transporte
- Proceso del cliente mediante uvx en el ejemplo publicado
- Clientes compatibles
- Claude Desktop
- Cursor
- Instalación
uvx mcp-atlassian y credenciales según despliegue
Qué es y qué expone
Atlassian MCP es la integración comunitaria de sooperset para trabajar con Jira y Confluence desde un cliente compatible con MCP. El servidor reúne herramientas de consulta y de escritura sobre incidencias y documentación. El repositorio aclara que no se trata de un producto oficial de Atlassian; esa identificación importa al revisar soporte, mantenimiento y condiciones de uso.
La referencia contempla despliegues Cloud y Server/Data Center. Aunque el propósito sea el mismo, la autenticación y la compatibilidad deben comprobarse para el entorno concreto. Una configuración preparada para un despliegue no debe trasladarse a otro cambiando únicamente el nombre de la cuenta. El acceso conecta al agente con información y operaciones de trabajo reales, por lo que conviene delimitar su alcance antes de comenzar.
Qué problema resuelve
Una tarea de desarrollo suele depender de contexto repartido entre una incidencia y una página de documentación. Consultar ambos espacios manualmente puede introducir copias incompletas o referencias que se pierden en la conversación. El servidor permite que el cliente busque incidencias y páginas y recupere sus detalles durante el trabajo del agente.
La integración también puede crear incidencias o cambiar estados. Esas operaciones deben distinguirse de la lectura: localizar una tarea no implica autorización para actualizarla. Un flujo claro separa la recopilación de contexto, la propuesta y la escritura, de forma que el equipo pueda revisar qué información se utilizó y qué cambio se pretende realizar en sus herramientas.
Cómo funciona
El cliente inicia el servidor mediante la configuración publicada y aporta las variables del despliegue. Para Cloud, el README utiliza credenciales y tokens de API. En Server/Data Center indica un recorrido con token personal. Esa diferencia debe resolverse leyendo las instrucciones correspondientes, sin guardar secretos reales en una configuración que vaya a compartirse.
Una vez conectado, el agente puede utilizar herramientas de búsqueda y detalle. Las herramientas de escritura permiten realizar cambios concretos, como crear una incidencia o modificar un estado. El usuario debe comprobar los permisos de la cuenta utilizada y revisar el objeto de cada operación antes de ejecutarla, especialmente cuando el mismo cliente puede acceder a proyectos y espacios diferentes.
Herramientas publicadas
| Herramienta | Función |
|---|---|
| jira_search | búsqueda mediante JQL |
| jira_get_issue | detalle de una incidencia |
| jira_create_issue | creación de incidencias |
| jira_transition_issue | cambio de estado |
| confluence_search | búsqueda mediante CQL |
| confluence_get_page | lectura de una página |
Cómo empezar
Identifica qué despliegue utilizas y qué proyectos o espacios debe consultar el agente. Confirma el tipo de autenticación que corresponde.
Prepara la credencial de manera privada y lee el bloque de configuración del cliente elegido. El ejemplo conserva marcadores y no contiene tokens reales.
Conecta el servidor y empieza por buscar una incidencia o una página conocida. Contrasta el resultado con la interfaz del producto.
Antes de utilizar una herramienta de escritura, describe el objeto y el cambio previsto. Revisa después el resultado en el sistema de origen.
Ejemplo de aplicación
Ejemplo de KIRELEN: un equipo necesita preparar la corrección de una incidencia. Pide al agente recuperar el detalle y localizar la documentación relacionada. El contexto obtenido se utiliza para explicar el problema y proponer un alcance de trabajo. La lectura de esos datos no modifica el estado de la tarea ni crea automáticamente otra incidencia.
Si después corresponde registrar una nueva tarea, el equipo revisa el contenido y confirma el proyecto de destino antes de utilizar la herramienta de creación. La comprobación final se realiza en Jira. Del mismo modo, un cambio de estado debe responder al flujo real del equipo y no a una suposición del asistente sobre cuándo una tarea está terminada.
Este ejemplo organiza las capacidades publicadas sin describir una conexión ejecutada sobre datos privados. No se utilizaron credenciales ni se modificaron incidencias o páginas durante la revisión editorial.
Seguridad y límites
Protege los tokens y los archivos de entorno, como indica el proyecto. El contexto de incidencias y páginas puede contener información interna: revisa también qué cliente y proveedor de modelos recibirán los resultados. No introduzcas una credencial real en el bloque que compartes para pedir ayuda y retira los accesos que ya no sean necesarios.
La compatibilidad y la autenticación dependen del despliegue. Confirma ambas antes de atribuir una falta de acceso a un fallo del servidor. La presencia de herramientas de escritura exige especial atención al alcance de la cuenta y a la tarea autorizada; una integración funcional no constituye una aprobación general para cambiar contenido en todos los proyectos accesibles.
Configuración documentada
{
"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"
}
}
}
}Tecnologías y alcance del repositorio
| Dato | Alcance verificado |
|---|---|
| Lenguajes del repositorio | Python, Shell, Jinja, Dockerfile, Go Template |
| Fuente | Repositorio completo del proyecto |
Estado del proyecto y condiciones de uso
El repositorio de sooperset se revisó el 2026-10-26 y registra licencia MIT para el código. La documentación identifica expresamente el carácter no oficial del producto y enlaza sus instrucciones de autenticación y configuración. Esta ficha recoge el recorrido publicado sin instalar el servidor ni conectarlo a espacios de trabajo. La compatibilidad debe revisarse de nuevo al actualizar el despliegue o el paquete.
Al preparar una cuenta de prueba, distingue las operaciones que solo recuperan información de las que cambian el trabajo compartido. Una búsqueda puede confirmar que la conexión encuentra el proyecto correcto, mientras una creación o transición necesita comprobar también el contenido y el destino. Esa separación permite evaluar la integración antes de utilizar sus herramientas de escritura en un flujo habitual del equipo.
Enlaces oficiales
Fuentes consultadas
Repositorio
- MCP Atlassian · referencia del proyecto · sooperset
Secundarias
- Descubrimiento en Skills Agentes · Skills AgentesFuente secundaria



