Confluence

Proporciona acceso seguro al contenido y espacios de Atlassian Confluence mediante su API REST.

Documentación

Servidor MCP de Confluence

Un servidor de Model Context Protocol (MCP) que proporciona acceso seguro a Atlassian Confluence a través de su API REST.

Uso con Claude Code

Para usar este servidor MCP con Claude Code, agrégalo a tu archivo de configuración de MCP:

Opción 1: Usando claude mcp add-json (recomendado)

La forma más fácil de agregar este servidor es usando el comando claude mcp add-json:

# First, build the server
npm run build

# Then add it using claude mcp add-json
claude mcp add-json confluence

Cuando se te solicite, pega la siguiente configuración JSON:

{
  "command": "node",
  "args": ["/path/to/confluence_mcp/dist/index.js"],
  "env": {
    "CONFLUENCE_BASE_URL": "https://your-domain.atlassian.net",
    "CONFLUENCE_USERNAME": "your-email@domain.com",
    "CONFLUENCE_API_TOKEN": "your-api-token",
    "ALLOWED_SPACES": "SPACE1,SPACE2,SPACE3"
  }
}

Opción 2: Configuración manual

Alternativamente, puedes editar manualmente tu archivo de configuración de MCP (~/.config/claude-code/mcp_servers_config.json):

{
  "mcpServers": {
    "confluence": {
      "command": "node",
      "args": ["/path/to/confluence_mcp/dist/index.js"],
      "env": {
        "CONFLUENCE_BASE_URL": "https://your-domain.atlassian.net",
        "CONFLUENCE_USERNAME": "your-email@domain.com",
        "CONFLUENCE_API_TOKEN": "your-api-token",
        "ALLOWED_SPACES": "SPACE1,SPACE2,SPACE3"
      }
    }
  }
}

Opción 3: Usando tsx para desarrollo

Para desarrollo o si prefieres ejecutar TypeScript directamente:

{
  "command": "npx",
  "args": ["tsx", "/path/to/confluence_mcp/src/index.ts"],
  "env": {
    "CONFLUENCE_BASE_URL": "https://your-domain.atlassian.net",
    "CONFLUENCE_USERNAME": "your-email@domain.com",
    "CONFLUENCE_API_TOKEN": "your-api-token",
    "ALLOWED_SPACES": "SPACE1,SPACE2,SPACE3"
  }
}

Notas de configuración

Reemplaza las variables de entorno con tus credenciales reales de Confluence
El ALLOWED_SPACES debe ser una lista separada por comas de claves de espacios a los que deseas permitir acceso
Reinicia Claude Code después de actualizar la configuración
Asegúrate de haber compilado el proyecto primero con npm run build si usas la Opción 1

Una vez configurado, puedes usar comandos como:

"Buscar documentación de API en Confluence"
"Crear una nueva página en el espacio DEV"
"Mostrarme todas las páginas en el espacio PROJ"

Inicio rápido

Instalar dependencias:
```
npm install
```

Configurar el entorno:

cp .env.example .env
# Edit .env with your Confluence credentials

Compilar y ejecutar:
```
npm run build
npm start
```
O para desarrollo:
```
npm run dev
```

Configuración

Crea un archivo .env con tus credenciales de Confluence:

CONFLUENCE_BASE_URL=https://your-domain.atlassian.net
CONFLUENCE_USERNAME=your-email@domain.com
CONFLUENCE_API_TOKEN=your-api-token
ALLOWED_SPACES=SPACE1,SPACE2,SPACE3
DEBUG=false

Obtener un token de API

Ve a Configuración de la cuenta de Atlassian
Haz clic en "Crear token de API"
Asígnale una etiqueta descriptiva
Copia el token generado (¡guárdalo de forma segura!)

Herramientas disponibles

search_confluence - Buscar contenido en los espacios permitidos
get_page - Recuperar una página específica por ID
create_page - Crear una nueva página
update_page - Actualizar una página existente
delete_page - Eliminar una página
list_spaces - Listar espacios accesibles
get_space_content - Obtener páginas de un espacio específico

Características de seguridad

Autenticación con token de API - Acceso seguro usando tokens de API de Atlassian
Restricciones de espacios - Lista configurable de espacios permitidos
Validación de permisos - Respeta los permisos de Confluence
Validación de solicitudes - Validación y saneamiento de entradas

Desarrollo

# Type checking
npm run typecheck

# Linting
npm run lint

# Testing
npm test

# Build
npm run build