remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Connects to Atlassian's platform to access Confluence data, requiring Atlassian site credentials (site name, email, API token) for authentication and data retrieval.
Enables access to Atlassian Confluence spaces, pages, and content with tools for searching content using CQL, listing spaces, getting space details, listing pages within spaces, and retrieving full page content.
Servidor MCP de Atlassian Confluence
Este proyecto proporciona un servidor de Protocolo de Contexto de Modelo (MCP) que actúa como puente entre los asistentes de IA (como Claude de Anthropic, Cursor AI u otros clientes compatibles con MCP) y su instancia de Atlassian Confluence. Permite que la IA acceda e interactúe de forma segura con sus espacios y páginas de Confluence en tiempo real.
Descripción general
¿Qué es MCP?
El Protocolo de Contexto de Modelo (MCP) es un estándar abierto que permite a los sistemas de IA conectarse de forma segura y contextual con herramientas y fuentes de datos externas.
Este servidor implementa MCP específicamente para Confluence Cloud, conectando sus datos de Confluence con asistentes de IA.
¿Por qué utilizar este servidor?
- Filosofía de entrada mínima, salida máxima : Identificadores simples como
spaceKeyypageIdson todo lo que necesita. Cada herramienta devuelve información completa sin necesidad de indicadores adicionales. - Acceso completo a la base de conocimientos : proporcione a su asistente de IA visibilidad completa de su documentación, wikis y contenido de la base de conocimientos en tiempo real.
- Formato de contenido enriquecido : todo el contenido de la página se convierte automáticamente del formato de documento Atlassian a Markdown con encabezados, tablas, listas y otros elementos de formato adecuados.
- Autenticación local segura : Las credenciales nunca se almacenan en el servidor. El servidor se ejecuta localmente, por lo que sus tokens nunca salen de su equipo y solo puede solicitar los permisos que necesita.
- Respuestas intuitivas de Markdown : todas las respuestas utilizan Markdown bien estructurado para facilitar la lectura con formato consistente y enlaces de navegación.
Empezando
Prerrequisitos
- Node.js (>=18.x): Descargar
- Cuenta Atlassian con acceso a Confluence Cloud
Paso 1: Obtenga su token de API de Atlassian
- Vaya a la página de administración de tokens de API de Atlassian: https://id.atlassian.com/manage-profile/security/api-tokens
- Haga clic en Crear token de API .
- Asígnele una etiqueta descriptiva (por ejemplo,
mcp-confluence-access). - Haga clic en Crear .
- Copia el token de API generado inmediatamente. No podrás volver a verlo.
Paso 2: Configurar credenciales
Método A: Archivo de configuración MCP (recomendado)
Crear o editar ~/.mcp/configs.json :
<YOUR_SITE_NAME>: el nombre de su sitio Confluence (por ejemplo,mycompanyparamycompany.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.
Método B: Variables de entorno
Pase las credenciales directamente al ejecutar el servidor:
Paso 3: Conecta tu asistente de IA
Configure su cliente compatible con MCP para iniciar este servidor.
Claude / Configuración del cursor:
Esta configuración inicia el servidor automáticamente en tiempo de ejecución.
Herramientas
Esta sección describe las herramientas MCP disponibles al usar este servidor con un asistente de IA. Tenga en cuenta que las herramientas MCP usan snake_case para los nombres de las herramientas y camelCase para los parámetros.
list_spaces
Enumere los espacios Confluence disponibles con filtrado opcional.
o:
"Muéstrame todos los espacios de Confluence".
get_space
Obtenga detalles completos de un espacio específico, incluida la información de la página de inicio.
"Cuéntame sobre el espacio DEV en Confluence".
list_pages
Enumere páginas dentro de uno o más espacios con filtrado opcional.
o:
"Muéstrame las páginas actuales en el espacio 123456."
get_page
Obtenga contenido completo y metadatos para una página específica.
"Obtener el contenido de la página 12345678 de Confluence."
search
Busque contenido de Confluence utilizando CQL (Confluence Query Language).
o:
"Busca en Confluence páginas sobre planes de proyectos".
Interfaz de línea de comandos (CLI)
La CLI utiliza kebab-case para comandos (por ejemplo, list-spaces ) y opciones (por ejemplo, --space-key ).
Uso rápido con npx
Instalar globalmente
Luego ejecuta directamente:
Descubra más opciones de CLI
Utilice --help para ver las banderas y el uso de todos los comandos disponibles:
O obtenga ayuda detallada para un comando específico:
Licencia
You must be authenticated.
Un servidor de protocolo de contexto de modelo que permite a los asistentes de IA como Claude acceder y buscar contenido de Atlassian Confluence, lo que permite la integración con la base de conocimiento de su organización.