Confluence MCP Server

Confluence MCP Server

Un servidor basado en FastMCP que proporciona una integración fluida con la API REST de Confluence, permitiendo el acceso programático a espacios, páginas y la funcionalidad de búsqueda de contenido de Confluence.

Características clave

• Gestión de espacios: Listar y filtrar espacios de Confluence
• Operaciones con páginas: Recuperar y gestionar contenido de páginas
• Funcionalidad de búsqueda: Ejecutar búsquedas con CQL (Confluence Query Language)
• Navegación por espacios: Listar todas las páginas dentro de espacios específicos
• Autenticación: Acceso seguro basado en token de API

Requisitos del sistema

• Python 3.8+
• pip (gestor de paquetes de Python)
• Instancia activa de Confluence con acceso a la API
• Token de API válido de Confluence

Instalación

Instalación mediante Smithery

Para instalar confluence-mcp-server para Claude Desktop automáticamente a través de Smithery:

npx -y @smithery/cli install @MahithChigurupati/confluence-mcp-server --client claude

Instalación manual

1. Clonar el repositorio

   git clone https://github.com/MahithChigurupati/Confluence-MCP-Server.git
   cd Confluence-MCP-Server
   

2. Configurar el entorno virtual (recomendado)

   python -m venv venv
   source venv/bin/activate  # On macOS/Linux
   # or
   .\venv\Scripts\activate  # On Windows
   

3. Instalar las dependencias

   pip install -r requirements.txt
   

Configuración

1. Crear el archivo de entorno

   cp .env.example .env
   

2. Configurar las variables de entorno

   CONFLUENCE_BASE_URL=https://your-instance.atlassian.net/wiki/rest/api
   USERNAME=your.email@company.com
   API_TOKEN=your-api-token-here
   

3. Obtener el token de API de Confluence

   1. Visite Tokens de API de Atlassian
   2. Haga clic en "Create API Token"
   3. Ingrese una etiqueta significativa (por ejemplo, "Acceso MCP Server")
   4. Copie el token generado inmediatamente (no se mostrará nuevamente)

Guía de uso

Iniciar el servidor

python confluence.py

Métodos de API disponibles

1. Listar espacios

response = await list_spaces(
    query="engineering",  # Optional: Filter spaces by name
    limit=25,            # Optional: Maximum number of spaces to return
    start=0             # Optional: Starting index for pagination
)

2. Obtener contenido de página

response = await get_page_content(
    page_id="123456",   # Required: Confluence page ID
    version=2           # Optional: Specific version number
)

3. Buscar contenido

response = await search_content(
    query="project plan",    # Required: Search query
    space_key="TEAM",       # Optional: Limit search to specific space
    limit=50,               # Optional: Maximum results
    start=0                 # Optional: Starting index
)

4. Listar páginas en un espacio

response = await list_pages_in_space(
    space_key="TEAM",       # Required: Space key
    limit=100,             # Optional: Maximum pages to return
    start=0               # Optional: Starting index
)

Integración con clientes MCP

Configuración de Claude Desktop

{
  "mcpServers": {
    "confluence": {
      "command": "python path",
      "args": ["/path/to/Confluence-MCP-Server/confluence.py"]
    }
  }
}

Ubicación: ~/.claude/claude_desktop_config.json (macOS/Linux) o %USERPROFILE%\.claude\config.json (Windows)

Configuración de Cursor

{
  "mcpServers": {
    "confluence": {
      "command": "python path",
      "args": ["/path/to/Confluence-MCP-Server/confluence.py"]
    }
  }
}

use which python para encontrar la ruta de Python

use pwd dentro del repositorio clonado para obtener la ruta. No olvide agregar confluence.py al final.

Ubicación: ~/.cursor/mcp.json (macOS/Linux) o %USERPROFILE%\.cursor\config.json (Windows)

Manejo de errores

Códigos de error comunes y sus significados:

• 401: Token de API o credenciales no válidos
• 403: Permisos insuficientes
• 404: Recurso no encontrado
• 429: Límite de velocidad excedido

Solución de problemas

1. Problemas de conexión

   • Verifique el formato de CONFLUENCE_BASE_URL
   • Compruebe la conectividad de red
   • Confirme la validez del token de API

2. Errores de autenticación

   • Asegúrese de que USERNAME coincida con el correo de la cuenta de Atlassian
   • Verifique que API_TOKEN esté copiado correctamente
   • Compruebe si hay caracteres especiales en el archivo .env

3. Errores de permisos

   • Confirme que el usuario tiene los permisos requeridos de Confluence
   • Verifique los derechos de acceso a espacios y páginas

Soporte

Para problemas y solicitudes de funcionalidades, cree un problema en el rastreador de problemas del repositorio.

Licencia

Licencia MIT. Consulte el archivo LICENSE para conocer los términos completos.