Elevance MCP Atlassian - Paquete independiente

Servidor Model Context Protocol para la integración de Jira y Confluence con asistentes de IA.

Qué ofrece

72 herramientas en total:

• 48 herramientas de Jira (búsqueda, creación, actualización, transiciones, comentarios, etc.)

• 24 herramientas de Confluence (búsqueda, páginas, comentarios, adjuntos, etc.)

Related MCP server: Jira Cloud MCP Server

Configuración rápida (5 minutos)

1. Obtén tu token de acceso personal (PAT)

Jira y Confluence:

1. Inicia sesión en https://jira.elevancehealth.com

2. Haz clic en el icono de perfil → Perfil

3. Ve a "Tokens de acceso personal"

4. Haz clic en "Crear token"

   • Nombre: MCP Atlassian Integration

   • Caducidad: 1 año

5. COPIA EL TOKEN (¡solo se muestra una vez!)

2. Configura el entorno

# Copy template
copy .env.template .env

# Edit .env and paste your PAT tokens
notepad .env

Reemplaza YOUR_JIRA_PAT_TOKEN_HERE y YOUR_CONFLUENCE_PAT_TOKEN_HERE con tu token real.

3. Instala las dependencias

# Option A: Using pip
pip install -r requirements.txt

# Option B: Install as package
pip install -e .

4. Configura tu IDE

Para Claude Desktop:

Edita %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "elevance-atlassian": {
      "command": "python",
      "args": ["-m", "mcp_atlassian"],
      "cwd": "C:\\path\\to\\elevance-mcp-atlassian-standalone",
      "env": {
        "JIRA_URL": "https://jira.elevancehealth.com",
        "JIRA_PERSONAL_TOKEN": "YOUR_PAT_HERE",
        "CONFLUENCE_URL": "https://confluence.elevancehealth.com/",
        "CONFLUENCE_PERSONAL_TOKEN": "YOUR_PAT_HERE"
      }
    }
  }
}

Para Windsurf:

Añádelo a tu configuración de MCP o usa el enfoque del archivo .env (recomendado).

Para Cursor:

Añádelo a la configuración de MCP en los ajustes, con un formato similar al de Claude Desktop.

5. Prueba la conexión

python validate_setup.py

Deberías ver todas las comprobaciones superadas con símbolos ✅.

6. ¡Empieza a usarlo!

Reinicia tu IDE y pregunta a tu asistente de IA:

• "Encuentra mis incidencias de Jira asignadas"

• "Busca en Confluence la documentación de incorporación"

• "Crea un error en el proyecto XYZ"

• "Actualiza el estado de PROJ-123 a En curso"

• "Muéstrame las incidencias del sprint actual"

• "Obtén el contenido de la página del espacio DEV de Confluence"

Herramientas disponibles

Herramientas de Jira (48)

Búsqueda y descubrimiento:

• jira_search - Busca incidencias con JQL

• jira_search_fields - Encuentra las definiciones de campos personalizados

• jira_get_all_projects - Lista los proyectos accesibles

• jira_get_project_issues - Obtén todas las incidencias del proyecto

Gestión de incidencias:

• jira_get_issue - Obtén los detalles de la incidencia

• jira_create_issue - Crea una nueva incidencia

• jira_update_issue - Actualiza una incidencia existente

• jira_delete_issue - Elimina una incidencia

• jira_batch_create_issues - Crea varias incidencias

Estado y flujo de trabajo:

• jira_transition_issue - Cambia el estado de la incidencia

• jira_get_transitions - Obtén las transiciones disponibles

Comentarios:

• jira_add_comment - Añade un comentario a la incidencia

• jira_edit_comment - Edita un comentario existente

Enlaces:

• jira_create_issue_link - Enlaza dos incidencias

• jira_remove_issue_link - Elimina un enlace

• jira_create_remote_issue_link - Crea un enlace web

• jira_link_to_epic - Enlaza la incidencia a una épica

• jira_get_link_types - Obtén los tipos de enlace disponibles

Adjuntos:

• jira_download_attachments - Descarga los adjuntos de la incidencia

• jira_get_issue_images - Obtén las imágenes como contenido en línea

Observadores:

• jira_add_watcher - Añade un observador a la incidencia

• jira_remove_watcher - Elimina un observador

• jira_get_issue_watchers - Lista los observadores

Registro de tiempo:

• jira_add_worklog - Registra el trabajo en la incidencia

• jira_get_worklog - Obtén las entradas del registro de trabajo

Ágil/Sprints:

• jira_get_agile_boards - Lista los tableros

• jira_get_board_issues - Obtén las incidencias del tablero

• jira_get_sprints_from_board - Lista los sprints

• jira_get_sprint_issues - Obtén las incidencias del sprint

• jira_create_sprint - Crea un nuevo sprint

• jira_update_sprint - Actualiza el sprint

• jira_add_issues_to_sprint - Añade incidencias al sprint

Versiones:

• jira_get_project_versions - Lista las versiones

• jira_create_version - Crea una nueva versión

• jira_batch_create_versions - Crea varias versiones

Componentes:

• jira_get_project_components - Lista los componentes del proyecto

Analíticas:

• jira_get_issue_dates - Obtén información de fechas

• jira_get_issue_sla - Calcula las métricas de SLA

• jira_batch_get_changelogs - Obtén el historial de cambios

Información de desarrollo:

• jira_get_issue_development_info - Obtén PRs, commits y ramas

• jira_get_issues_development_info - Información de desarrollo por lotes

Avanzado:

• jira_get_user_profile - Obtén la información del usuario

• jira_get_field_options - Obtén las opciones de campos personalizados

• jira_get_issue_proforma_forms - Obtén los formularios ProForma

• jira_get_proforma_form_details - Obtén los detalles del formulario

• jira_update_proforma_form_answers - Actualiza las respuestas del formulario

Service Desk (solo Server/DC):

• jira_get_service_desk_for_project - Obtén el service desk

• jira_get_service_desk_queues - Lista las colas

• jira_get_queue_issues - Obtén las incidencias de la cola

Herramientas de Confluence (24)

Búsqueda:

• confluence_search - Busca contenido con CQL

• confluence_search_user - Busca usuarios

Páginas:

• confluence_get_page - Obtén el contenido de la página

• confluence_create_page - Crea una nueva página

• confluence_update_page - Actualiza la página

• confluence_delete_page - Elimina la página

• confluence_move_page - Mueve la página

• confluence_get_page_children - Obtén las páginas hijas

• confluence_get_page_history - Obtén la versión de la página

• confluence_get_page_diff - Compara las versiones

Comentarios:

• confluence_add_comment - Añade un comentario

• confluence_reply_to_comment - Responde a un comentario

• confluence_get_comments - Obtén los comentarios de la página

Adjuntos:

• confluence_get_attachments - Lista los adjuntos

• confluence_upload_attachment - Sube un archivo

• confluence_upload_attachments - Sube varios archivos

• confluence_download_attachment - Descarga un archivo

• confluence_download_content_attachments - Descarga todos los adjuntos

• confluence_delete_attachment - Elimina un adjunto

Imágenes:

• confluence_get_page_images - Obtén las imágenes como contenido en línea

Etiquetas:

• confluence_get_labels - Obtén las etiquetas del contenido

• confluence_add_label - Añade una etiqueta

Analíticas:

• confluence_get_page_views - Obtén las estadísticas de vistas

Solución de problemas

Error "Module not found"

pip install -e .

"Authentication failed"

• Verifica que el token PAT sea válido y no haya caducado

• Comprueba que el token no haya sido revocado

• Asegúrate de que la URL sea correcta (https://jira.elevancehealth.com)

• Intenta regenerar el token

Errores de certificado SSL

Añade al archivo .env:

JIRA_SSL_VERIFY=false
CONFLUENCE_SSL_VERIFY=false

Fallo en la prueba de conexión

# Test if Python can import the module
python -c "import mcp_atlassian; print('OK')"

# Check MCP version
python -m mcp_atlassian --version

"No such file or directory" al ejecutar la validación

Asegúrate de estar en el directorio correcto:

cd C:\path\to\elevance-mcp-atlassian-standalone
python validate_setup.py

Las herramientas no aparecen en el IDE

1. Verifica que la configuración del IDE tenga las rutas correctas

2. Reinicia el IDE por completo

3. Revisa los registros del IDE para ver errores de conexión MCP

4. Asegúrate de que TOOLSETS=all esté en .env o en la configuración del IDE

Buenas prácticas de seguridad

• ✅ Mantén tu archivo .env privado

• ✅ No compartas nunca los tokens PAT

• ✅ Rota los tokens cada 6-12 meses

• ✅ No subas .env al control de versiones

• ✅ Usa nombres de token robustos para el seguimiento

• ✅ Revoca los tokens cuando ya no sean necesarios

Configuración avanzada

Filtrar por proyectos específicos

En .env:

JIRA_PROJECTS_FILTER=PROJ1,PROJ2,PROJ3
CONFLUENCE_SPACES_FILTER=SPACE1,SPACE2,SPACE3

Habilitar registro detallado

En .env:

MCP_VERBOSE=true
MCP_VERY_VERBOSE=true  # Debug level

Modo de solo lectura (pruebas)

En .env:

READ_ONLY_MODE=true

Esto impide cualquier operación de escritura (crear, actualizar, eliminar).

Conjuntos de herramientas personalizados

En .env:

# Only core tools
TOOLSETS=default

# Specific toolsets
TOOLSETS=default,jira_agile,jira_analytics

# Specific tools only
ENABLED_TOOLS=jira_search,jira_get_issue,confluence_search

Requisitos del sistema

• Python: 3.10 o superior

• Sistema operativo: Windows, macOS o Linux

• Red: Acceso a jira.elevancehealth.com

• IDE: Claude Desktop, Cursor o Windsurf con soporte MCP

Contenido del paquete

elevance-mcp-atlassian-standalone/
├── src/mcp_atlassian/       # Complete MCP implementation
│   ├── jira/                # 48 Jira tools
│   ├── confluence/          # 24 Confluence tools
│   ├── models/              # Data models
│   ├── servers/             # MCP server logic
│   └── utils/               # Utilities
├── .env.template            # Configuration template
├── requirements.txt         # Python dependencies
├── pyproject.toml          # Package metadata
├── validate_setup.py       # Setup validation script
├── README.md               # This file
├── SETUP-GUIDE.md          # Detailed setup instructions
└── LICENSE                 # MIT License

Soporte

Para problemas o preguntas, contacta con:

• Desarrollador: Mohamed Wasim

• Correo electrónico: Mohamed.Wasim@carelon.com

Próximos pasos

1. ✅ Completa la configuración con los pasos anteriores

2. ✅ Ejecuta la validación: python validate_setup.py

3. ✅ Configura tu IDE

4. ✅ Reinicia el IDE

5. ✅ Empieza a usar el asistente de IA con Jira/Confluence

Recursos adicionales

• SETUP-GUIDE.md - Guía detallada paso a paso con descripciones de las capturas de pantalla

• Documentación original - https://mcp-atlassian.soomiles.com

Licencia

Licencia MIT - uso interno para Elevance Health/Carelon

Versión: 1.0
Última actualización: marzo de 2026
Mantenido por: Carelon Global Solutions