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 :

{
	"confluence": {
		"environments": {
			"ATLASSIAN_SITE_NAME": "<YOUR_SITE_NAME>",
			"ATLASSIAN_USER_EMAIL": "<YOUR_ATLASSIAN_EMAIL>",
			"ATLASSIAN_API_TOKEN": "<YOUR_COPIED_API_TOKEN>"
		}
	}
}

• <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

export ATLASSIAN_SITE_NAME="<YOUR_SITE_NAME>"
export ATLASSIAN_USER_EMAIL="<YOUR_EMAIL>"
export ATLASSIAN_API_TOKEN="<YOUR_API_TOKEN>"

Paso 3: Instalar y ejecutar

Inicio rápido con npx

npx -y @aashari/mcp-server-atlassian-confluence ls-spaces

Instalación global

npm install -g @aashari/mcp-server-atlassian-confluence
mcp-atlassian-confluence ls-spaces

Paso 4: Conéctese al Asistente de IA

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

{
	"mcpServers": {
		"confluence": {
			"command": "npx",
			"args": ["-y", "@aashari/mcp-server-atlassian-confluence"]
		}
	}
}

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:

{ "type": "global", "status": "current", "limit": 10 }

conf_get_space

Obtener detalles del espacio:

{ "spaceKey": "DEV" }

conf_ls_pages

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

{
	"spaceKeys": ["DEV"],
	"title": "API Documentation",
	"status": ["current"],
	"sort": "-modified-date"
}

Listar páginas de varios espacios:

{
	"spaceKeys": ["DEV", "HR", "MARKETING"],
	"limit": 15,
	"sort": "-modified-date"
}

conf_get_page

Obtener contenido de la página:

{ "pageId": "12345678" }

conf_ls_page_comments

Comentarios de la página de lista:

{ "pageId": "12345678" }

conf_search

Búsqueda simple:

{
	"query": "release notes Q1",
	"spaceKey": "PRODUCT",
	"contentType": "page",
	"limit": 5
}

Búsqueda avanzada de CQL:

{ "cql": "space = DEV AND label = api AND created >= '2023-01-01'" }

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:

mcp-atlassian-confluence ls-spaces --type global --status current --limit 10

Obtener espacio

mcp-atlassian-confluence get-space --space-key DEV

Lista de páginas

Mediante múltiples teclas de espacio:

mcp-atlassian-confluence ls-pages --space-keys DEV HR MARKETING --limit 15 --sort "-modified-date"

Con filtro de título:

mcp-atlassian-confluence ls-pages --space-keys DEV --title "API Documentation" --status current

Obtener página

mcp-atlassian-confluence get-page --page-id 12345678

Comentarios de la página de lista

mcp-atlassian-confluence ls-page-comments --page-id 12345678

Buscar

Búsqueda simple:

mcp-atlassian-confluence search --query "security best practices" --space-key DOCS --type page --limit 5

Búsqueda CQL:

mcp-atlassian-confluence search --cql "label = official-docs AND creator = currentUser()"

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

# Confluence Spaces

Showing **5** global spaces (current)

| Key | Name | Description |
|---|---|---|
| [DEV](#) | Development | Engineering and development documentation |
| [HR](#) | Human Resources | Employee policies and procedures |
| [MARKETING](#) | Marketing | Brand guidelines and campaign materials |
| [PRODUCT](#) | Product | Product specifications and roadmaps |
| [SALES](#) | Sales | Sales processes and resources |

*Retrieved from mycompany.atlassian.net on 2025-05-19 14:22 UTC*

Use `cursor: "next-page-token-123"` to see more spaces.

Respuesta al contenido de la página

# API Authentication Guide

**Space:** [DEV](#) (Development)
**Created by:** Jane Smith on 2025-04-01
**Last updated:** John Doe on 2025-05-15
**Labels:** api, security, authentication

## Overview

This document outlines the authentication approaches supported by our API platform.

## Authentication Methods

### OAuth 2.0

We support the following OAuth 2.0 flows:

1. **Authorization Code Flow** - For web applications
2. **Client Credentials Flow** - For server-to-server
3. **Implicit Flow** - For legacy clients only

### API Keys

Static API keys are supported but discouraged for production use due to security limitations:

| Key Type | Use Case | Expiration |
|---|---|---|
| Development | Testing | 30 days |
| Production | Live systems | 90 days |

## Implementation Examples

  import requests

  def get_oauth_token():
      return requests.post(
          'https://api.example.com/oauth/token',
          data={
              'client_id': 'YOUR_CLIENT_ID',
              'client_secret': 'YOUR_CLIENT_SECRET',
              'grant_type': 'client_credentials'
          }
      ).json()['access_token']

*Retrieved from mycompany.atlassian.net on 2025-05-19 14:25 UTC*

Desarrollo

# Clone repository
git clone https://github.com/aashari/mcp-server-atlassian-confluence.git
cd mcp-server-atlassian-confluence

# Install dependencies
npm install

# Run in development mode
npm run dev:server

# Run tests
npm test

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