使用说明
MCP Atlassian - Integración con Jira y Confluence
Este proyecto me permitió conectar GitHub Copilot con Jira y Confluence usando el Model Context Protocol. La idea era simple: quería consultar mis tickets de Jira directamente desde VS Code, sin abrir el navegador.
¿Por qué hice esto?
Me cansé de:
- Salir de VS Code para buscar un ticket
- Abrir Confluence cada vez que necesitaba ver documentación
- Recordar la sintaxis de JQL
- Cambiar de contexto constantemente
Ahora hago todo desde el editor, preguntándole a Copilot en lenguaje natural.
Cómo funciona
GitHub Copilot Chat → MCP Server (Docker) → Jira/Confluence APIs
El servidor MCP traduce mis consultas en lenguaje natural a llamadas API de Atlassian.
Qué puedo hacer
Jira:
- Ver tickets asignados
- Buscar bugs/tareas
- Crear tickets
- Actualizar estados
- Agregar comentarios
Confluence:
- Buscar documentación
- Ver páginas
- Crear contenido
Cómo usarlo
1. Clonar
git clone https://github.com/felucchesi85/mcp-atlassian.git
cd mcp-atlassian
2. Configurar credenciales
Copiar y editar el .env:
cp .env.example .env
Agregar tus datos (obtener token en https://id.atlassian.com/manage-profile/security/api-tokens):
JIRA_URL=https://tu-dominio.atlassian.net
JIRA_USERNAME=tu-email@ejemplo.com
JIRA_API_TOKEN=tu-token
CONFLUENCE_URL=https://tu-dominio.atlassian.net/wiki
CONFLUENCE_USERNAME=tu-email@ejemplo.com
CONFLUENCE_API_TOKEN=tu-token
3. Levantar el servidor
docker run --rm -d --name mcp-atlassian -p 9000:9000 --env-file .env ghcr.io/sooperset/mcp-atlassian:latest --transport sse --port 9000 -v
O usar el script:
./mcp-manager.sh start
4. Usar desde VS Code
Abrí Copilot Chat y preguntá:
"¿Tengo tickets asignados?"
"Busca docs sobre API en Confluence"
"Crea un bug en JPA"
Comandos
./mcp-manager.sh start # Iniciar
./mcp-manager.sh stop # Detener
./mcp-manager.sh status # Ver estado
./mcp-manager.sh logs # Ver logs
Seguridad
El .env nunca se sube (está en .gitignore). Si tu token se compromete, revocalo en:
https://id.atlassian.com/manage-profile/security/api-tokens
Problemas comunes
No levanta: Verificá que Docker esté corriendo (docker ps)
No aparece en VS Code: Verificá que el servidor esté up (curl http://localhost:9000/healthz)
Error 401/403: Revisá el token y email en .env
Referencias
Fernando Lucchesi - @felucchesi85
