Servidor MCP de Atlassian Confluence

Un servidor de Protocolo de Contexto de Modelo (MCP) Node.js/TypeScript para Atlassian Confluence Cloud. Permite que los sistemas de IA (p. ej., LLM como Claude o Cursor AI) interactúen de forma segura con sus espacios, páginas y contenido de Confluence en tiempo real.

¿Por qué utilizar este servidor?

• Entrada mínima, salida máxima : los identificadores simples proporcionan detalles completos sin necesidad de indicadores adicionales.

• Acceso completo a la base de conocimientos : brinde a los asistentes de IA visibilidad sobre la documentación, las wikis y el contenido de la base de conocimientos.

• Formato de contenido enriquecido : conversión automática del formato de documento Atlassian a Markdown legible.

• Autenticación local segura : ejecútela localmente con sus credenciales y nunca almacene tokens en servidores remotos.

• Respuestas intuitivas de Markdown : formato de Markdown consistente y bien estructurado para todas las salidas.

Related MCP server: Confluence MCP

¿Qué es MCP?

El Protocolo de Contexto de Modelo (MCP) es un estándar abierto para conectar de forma segura sistemas de IA a herramientas y fuentes de datos externas. Este servidor implementa MCP para Confluence Cloud, lo que permite que los asistentes de IA interactúen con el contenido de Confluence mediante programación.

Prerrequisitos

• Node.js (>=18.x): Descargar

• Cuenta Atlassian con acceso a Confluence Cloud

Configuración

Paso 1: Obtenga su token de API de Atlassian

1. Vaya a la página de administración de tokens de API de Atlassian: https://id.atlassian.com/manage-profile/security/api-tokens

2. Haga clic en Crear token de API .

3. Asígnele una etiqueta descriptiva (por ejemplo, mcp-confluence-access ).

4. Haga clic en Crear .

5. Copia el token de API generado inmediatamente. No podrás volver a verlo.

Paso 2: Configurar credenciales

Opción A: Archivo de configuración MCP (recomendado)

Editar o crear ~/.mcp/configs.json :

• <YOUR_SITE_NAME> : el nombre de su sitio Confluence (por ejemplo, mycompany para mycompany.atlassian.net ).

• <YOUR_ATLASSIAN_EMAIL> : El correo electrónico de su cuenta de Atlassian.

• <YOUR_COPIED_API_TOKEN> : El token de API del paso 1.

Opción B: Variables de entorno

Paso 3: Instalar y ejecutar

Inicio rápido con npx

Instalación global

Paso 4: Conéctese al Asistente de IA

Configure su cliente compatible con MCP (por ejemplo, Claude, Cursor AI):

Herramientas MCP

Las herramientas MCP utilizan nombres snake_case , parámetros camelCase y devuelven respuestas con formato Markdown.

• conf_ls_spaces : Enumera los espacios de Confluence accesibles ( type : str opt, status : str opt, limit : num opt, cursor : str opt). Uso: Ver los espacios disponibles.

• conf_get_space : Obtiene información detallada del espacio ( spaceKey : str req). Uso: Accede al contenido y los metadatos del espacio.

• conf_ls_pages : Lista páginas con filtros ( spaceIds : str[] opt, spaceKeys : str[] opt, title : str opt, status : str[] opt, sort : str opt, limit : num opt, cursor : str opt). Uso: Busca páginas que coincidan con los criterios.

• conf_get_page : Obtiene el contenido completo de la página ( pageId : str req). Uso: Visualiza el contenido completo de la página en formato Markdown.

• conf_ls_page_comments : Lista los comentarios de una página ( pageId : str req). Uso: Leer las discusiones de la página.

• conf_search : busca contenido de Confluence ( cql : str opt, query : str opt, title : str opt, spaceKey : str opt, labels : str[] opt, contentType : str opt, limit : num opt, cursor : str opt). Uso: busca contenido específico.

conf_ls_spaces

Lista de espacios globales:

conf_get_space

Obtener detalles del espacio:

conf_ls_pages

Lista de páginas por espacio y título:

Listar páginas de varios espacios:

conf_get_page

Obtener contenido de la página:

conf_ls_page_comments

Comentarios de la página de lista:

conf_search

Búsqueda simple:

Búsqueda avanzada de CQL:

Comandos CLI

Los comandos CLI usan kebab-case . Ejecute --help para obtener más información (p. ej., mcp-atlassian-confluence ls-spaces --help ).

• ls-spaces : enumera los espacios ( --type , --status , --limit , --cursor ). Ejemplo: mcp-atlassian-confluence ls-spaces --type global .

• get-space : Obtiene detalles del espacio ( --space-key ). Ejemplo: mcp-atlassian-confluence get-space --space-key DEV .

• ls-pages : Enumera páginas ( --space-keys , --title , --status , --sort , --limit , --cursor ). Ejemplo: mcp-atlassian-confluence ls-pages --space-keys DEV .

• get-page : Obtiene el contenido de la página ( --page-id ). Ejemplo: mcp-atlassian-confluence get-page --page-id 12345678 .

• ls-page-comments : Lista los comentarios ( --page-id ). Ejemplo: mcp-atlassian-confluence ls-page-comments --page-id 12345678 .

• búsqueda : Busca contenido ( --cql , --query , --space-key , --label , --type , --limit , --cursor ). Ejemplo: mcp-atlassian-confluence search --query "security" .

Espacios de lista

Lista de espacios globales:

Obtener espacio

Lista de páginas

Mediante múltiples teclas de espacio:

Con filtro de título:

Obtener página

Comentarios de la página de lista

Buscar

Búsqueda simple:

Búsqueda CQL:

Formato de respuesta

Todas las respuestas están en formato Markdown, incluidas:

• Título : Tipo y nombre del contenido.

• Contenido : Contenido de página completa, resultados de búsqueda o lista de elementos.

• Metadatos : Creador, fecha, etiquetas y otra información relevante.

• Paginación : Información de navegación para resultados paginados.

• Enlaces : Referencias a recursos relacionados cuando corresponda.

Respuesta de la lista espacial

Respuesta al contenido de la página

Desarrollo

Contribuyendo

¡Agradecemos sus contribuciones! Por favor:

1. Bifurcar el repositorio.

2. Crea una rama de características ( git checkout -b feature/xyz ).

3. Confirmar cambios ( git commit -m "Add xyz feature" ).

4. Empujar a la rama ( git push origin feature/xyz ).

5. Abrir una solicitud de extracción.

Consulte CONTRIBUTING.md para obtener más detalles.

Licencia

Licencia ISC