Confluencia MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para Confluence, que permite a los asistentes de IA interactuar con el contenido de Confluence a través de una interfaz estandarizada.

ℹ️ Hay un servidor MCP separado para Jira

Características

Autenticarse en Confluence usando un token API personal
Recuperar y buscar páginas y espacios de Confluence
Crear y actualizar contenido de Confluence
Recuperar y agregar comentarios a las páginas
Recuperar y agregar archivos adjuntos a las páginas
Limpie y transforme el contenido de Confluence para el consumo de IA
Manejar la comunicación API, el manejo de errores y la transformación de datos
Limitación de velocidad básica para evitar el abuso de la API

Related MCP server: Atlassian Confluence MCP Server

Prerrequisitos

Bun (v1.0.0 o superior)
Cuenta de Confluence con acceso a la API

Instalación

# Clone the repository git clone https://github.com/cosmix/confluence-mcp.git cd confluence-mcp # Install dependencies bun install # Build the project bun run build

Configuración

Para utilizar este servidor MCP, debe configurar las siguientes variables de entorno:

CONFLUENCE_API_TOKEN=your_api_token CONFLUENCE_BASE_URL=your_confluence_instance_url # e.g., https://your-domain.atlassian.net/wiki CONFLUENCE_USER_EMAIL=your_email

Configuración de Claude Desktop/Cline

Añade esta configuración a tu archivo de configuración:

{ "mcpServers": { "confluence": { "command": "bun", "args": ["/absolute/path/to/confluence-mcp/dist/index.js"], "env": { "CONFLUENCE_API_TOKEN": "your_api_token", "CONFLUENCE_BASE_URL": "your_confluence_instance_url/wiki", "CONFLUENCE_USER_EMAIL": "your_email" } } } }

Desarrollo

# Run in development mode bun run dev # Run tests bun test

Herramientas disponibles

El servidor Confluence MCP expone las siguientes herramientas:

obtener_página

Recuperar una página de Confluence por ID. El formato se refiere al formato de retorno del contenido y puede ser text o markdown . El parámetro includeMarkup permite recuperar el marcado XHTML (Formato de Almacenamiento de Confluence) original, lo cual resulta útil para actualizar páginas conservando el formato.

{ "pageId": "123456", "format": "text", "includeMarkup": true }

páginas de búsqueda

Busque páginas de Confluence mediante CQL (lenguaje de consulta de Confluence). El formato se refiere al formato de retorno del contenido y puede ser text o markdown . El parámetro includeMarkup permite recuperar el marcado XHTML (Formato de almacenamiento de Confluence) original de cada página.

{ "query": "space = DEV and label = documentation", "limit": 10, "format": "text", "includeMarkup": true }

obtener_espacios

Enumere todos los espacios Confluence disponibles.

{ "limit": 50 }

crear_página

Crea una nueva página de Confluence. El parentId es opcional y se puede usar para crear una página secundaria dentro de una página existente.

{ "spaceKey": "DEV", "title": "New Page Title", "content": "Page content in Confluence Storage Format (XHTML)", "parentId": "123456" }

página de actualización

Actualizar una página de Confluence existente.

{ "pageId": "123456", "title": "Updated Page Title", "content": "Updated content in Confluence Storage Format (XHTML)", "version": 1 }

obtener_comentarios

Recuperar comentarios de una página específica de Confluence. El formato se refiere al formato de retorno del contenido y puede ser text o markdown .

{ "pageId": "123456", "limit": 25, "format": "text" }

añadir_comentario

Añade un comentario a una página de Confluence. El parentId es opcional para crear respuestas encadenadas.

{ "pageId": "123456", "content": "This is a new comment.", "parentId": "789012" }

obtener_archivos adjuntos

Recuperar archivos adjuntos para una página específica de Confluence.

{ "pageId": "123456", "limit": 25 }

agregar_adjunto

Añade un archivo adjunto a una página de Confluence. El fileContentBase64 debe ser la cadena codificada en base64 del contenido del archivo.

{ "pageId": "123456", "filename": "document.pdf", "fileContentBase64": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFI+P...", "comment": "Uploaded new version of the document" }