MCP Atlassian Server

Servidor Atlassian MCP (por phuc-nt)

Novedades de la versión 2.1.1 🚀

• Se refactorizó toda la base de código para estandarizar la estructura de recursos/herramientas, se eliminó por completo el recurso de metadatos de contenido y se fusionaron los metadatos con el recurso de página.
• Nueva guía para desarrolladores: ahora cualquiera puede ampliar y mantener fácilmente la base de código.
• Compatibilidad garantizada con el último SDK de MCP, seguridad mejorada, escalabilidad y capacidad de mantenimiento.
• Se actualizó docs/introduction/resources-and-tools.md para eliminar todas las referencias a content-metadata.

👉 Consulte el REGISTRO DE CAMBIOS completo para obtener más detalles.

Novedades de la versión 2.0.1 🎉

¡MCP Atlassian Server v2.0.1 trae una importante expansión de características y capacidades!

• API actualizadas : ahora se utilizan las últimas API de Atlassian (Jira API v3, Confluence API v2)
• Funciones ampliadas : se aumentó de 21 a 48 funciones, incluidas capacidades avanzadas de Jira y Confluence
• Gestión mejorada de tableros y sprints : soporte completo para flujos de trabajo Agile/Scrum
• Funciones avanzadas de Confluence : gestión de versiones de página, gestión de archivos adjuntos y gestión de comentarios
• Registro de recursos mejorado : se solucionaron problemas de registro de recursos duplicados para una experiencia más estable.
• Actualización de la documentación : Nueva serie de documentación completa que explica la arquitectura de MCP y el desarrollo de recursos y herramientas.

Para obtener detalles completos sobre todos los cambios, mejoras y correcciones, consulte el REGISTRO DE CAMBIOS .

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

MCP Atlassian Server permite a los asistentes de IA (como Cline, Claude Desktop, Cursor...) acceder y administrar Jira y Confluence con un conjunto completo de funciones, agrupadas para mayor claridad:

Jira

• Gestión de problemas
  • Ver, buscar y filtrar problemas
  • Crear, actualizar, realizar la transición y asignar problemas
  • Agregar problemas al backlog o sprint, clasificar los problemas
• Gestión de proyectos
  • Ver la lista de proyectos, los detalles del proyecto y los roles del proyecto
• Gestión del tablero y del sprint
  • Ver tableros, configuración de tableros, problemas y sprints en tableros
  • Crear, iniciar y cerrar sprints
• Gestión de filtros
  • Ver, crear, actualizar y eliminar filtros
• Gestión de paneles y gadgets
  • Ver paneles y gadgets
  • Crear y actualizar paneles de control
  • Agregar o eliminar gadgets en los paneles
• Gestión de usuarios
  • Ver detalles de usuario, usuarios asignables y usuarios por rol de proyecto

Confluencia

• Gestión del espacio
  • Ver la lista de espacios, los detalles del espacio y las páginas de un espacio
• Gestión de páginas
  • Ver, buscar y obtener detalles de páginas, páginas secundarias, antecesores, archivos adjuntos e historial de versiones
  • Crear, actualizar, renombrar y eliminar páginas
• Gestión de comentarios
  • Ver, agregar, actualizar y eliminar comentarios en las páginas

Para obtener un desglose técnico completo de todas las funciones, recursos y herramientas, consulte: docs/introduction/resources-and-tools.md

Flujo de solicitud

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.