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": "<p>Page content in Confluence Storage Format (XHTML)</p>",
  "parentId": "123456"
}

página de actualización

Actualizar una página de Confluence existente.

{
  "pageId": "123456",
  "title": "Updated Page Title",
  "content": "<p>Updated content in Confluence Storage Format (XHTML)</p>",
  "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": "<p>This is a new comment.</p>",
  "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"
}