MCP Atlassian Server

Servidor Atlassian MCP (por phuc-nt)

Introducción

MCP Atlassian Server (de phuc-nt) es un servidor de Protocolo de contexto de modelo (MCP) que conecta agentes de IA como Cline, Claude Desktop o Cursor con Atlassian Jira y Confluence, lo que les permite consultar datos y realizar acciones a través de una interfaz estandarizada.

Nota: Este servidor está diseñado y optimizado principalmente para su uso con Cline, aunque sigue el estándar MCP y puede funcionar con otros clientes compatibles con MCP.

• Características principales:
  • Conecte agentes de IA a Atlassian Jira y Confluence
  • Admite recursos (solo lectura) y herramientas (acciones/mutaciones)
  • Fácil integración con Cline a través de MCP Marketplace
  • Diseño local para entornos de desarrollo personal
  • Integración optimizada con el asistente de inteligencia artificial de Cline

El porqué detrás de este proyecto

Como desarrollador que trabaja a diario con Jira y Confluence, dediqué mucho tiempo a navegar por estas herramientas. Si bien son potentes, anhelaba una forma más sencilla de interactuar con ellas sin tener que cambiar constantemente de contexto durante el trabajo intensivo.

La aparición de los Agentes de IA y el Protocolo de Contexto de Modelo (MCP) presentó la oportunidad perfecta. Inmediatamente vi el potencial de conectar Jira y Confluence (con planes para Slack, GitHub, Calendar y más) a mis flujos de trabajo de IA.

Este proyecto comenzó como un viaje de aprendizaje sobre MCP y agentes de IA, pero espero que evolucione hasta convertirse en algo realmente útil para las personas y organizaciones que interactúan a diario con las herramientas de Atlassian.

Arquitectura del sistema

Instalación y configuración

Para obtener instrucciones detalladas de instalación y configuración, consulte nuestra guía de instalación para asistentes de IA . Esta guía está especialmente diseñada para que los asistentes de IA/LLM, como Cline, puedan leer y configurar automáticamente el servidor Atlassian de MCP.

Nota para usuarios de Cline : La guía de instalación (llms-install.md) está optimizada para que la IA de Cline la comprenda y la ejecute. Simplemente pídale a Cline que instale MCP Atlassian Server (mediante phuc-nt) y podrá analizar las instrucciones y ayudarle a configurar todo paso a paso.

La guía incluye:

• Prerrequisitos y requisitos del sistema
• Configuración paso a paso para entornos Node.js
• Configuración del asistente de inteligencia artificial de Cline para conectarse con Atlassian
• Obtener y configurar tokens de API de Atlassian
• Recomendaciones de seguridad y mejores prácticas

Instalación mediante herrería

Para instalar Atlassian Integration Server para Claude Desktop automáticamente a través de Smithery :

Descripción general de las funciones

Para obtener documentación detallada de todos los recursos y herramientas, consulte Referencia de recursos y herramientas

Flujo de solicitud

Ejemplos de casos de uso

Intente hacerle estas preguntas a Cline después de la instalación:

1. Crear y administrar tareas
   • "Crear un nuevo problema en el proyecto DEMO sobre errores de inicio de sesión"
   • "Buscar todos los problemas que me fueron asignados en el sprint actual"
   • Transición del problema DEMO-43 al estado "Listo"
2. Resumen de información del proyecto
   • Resumir todos los problemas del proyecto DEMO
   • "¿A quién se le asignan problemas en el proyecto DEMO?"
   • "Enumerar problemas no asignados en el sprint actual"
3. Documentación con Confluence
   • Crear una página de Confluence titulada "Notas de la reunión"
   • Actualizar la página de Confluence "Documentación de la API" con nuevos ejemplos y etiquetas.
   • Añade la etiqueta "documentación" a la página sobre arquitectura.
   • Eliminar la etiqueta "borrador" de la página "Notas de la reunión".
   • "Añadir un comentario a la página de Confluence sobre la documentación de la API"
4. Análisis e informes
   • Comparar el número de problemas completados entre el sprint actual y el anterior.
   • "¿Quién tiene más problemas en el estado 'Por hacer'?"

Estas consultas funcionan mejor en el entorno Cline, que ha sido probado exhaustivamente con este servidor MCP.

Notas de uso

1. JQL simple : al buscar problemas, utilice JQL simple sin espacios ni caracteres especiales (por ejemplo, project=DEMO en lugar de project = DEMO AND key = DEMO-43 ).
2. Crear una página de Confluence : al crear una página de Confluence, utilice contenido HTML simple y no especifique parentId para evitar errores.
3. Actualizar página de Confluence : Al actualizar una página, incluya siempre el número de versión actual para evitar conflictos. También puede actualizar etiquetas (añadir o eliminar) y debe usar un formato de almacenamiento válido para el contenido.
4. Crear problema : al crear nuevos problemas, proporcione únicamente los campos mínimos requeridos (clave de proyecto, resumen) para obtener el mejor resultado.
5. Derechos de acceso : asegúrese de que la cuenta de Atlassian configurada tenga acceso a los proyectos y espacios con los que desea interactuar.

Nota de seguridad

• Su token API hereda todos los permisos del usuario que lo creó
• Nunca compartas tu token con alguien que no sea de confianza
• Tenga cuidado al solicitar a los LLM que analicen los archivos de configuración que contienen su token
• Consulte las pautas de seguridad detalladas en llms-install.md

Contribuir y apoyar

• Contribuya abriendo solicitudes de extracción o problemas en GitHub.
• Únase a la comunidad MCP/Cline para obtener apoyo adicional.

¡MCP Atlassian Server (de phuc-nt) está listo para su instalación con un solo clic desde Cline Marketplace!
Consulte las instrucciones detalladas en llms-install.md

Si bien el servidor utiliza el estándar abierto MCP, está diseñado y probado principalmente para usuarios de Cline.