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.

¿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

Vaya a la página de administración de tokens de API de Atlassian: https://id.atlassian.com/manage-profile/security/api-tokens
Haga clic en Crear token de API .
Asígnele una etiqueta descriptiva (por ejemplo, mcp-confluence-access ).
Haga clic en Crear .
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:

Bifurcar el repositorio.
Crea una rama de características ( git checkout -b feature/xyz ).
Confirmar cambios ( git commit -m "Add xyz feature" ).
Empujar a la rama ( git push origin feature/xyz ).
Abrir una solicitud de extracción.

Consulte CONTRIBUTING.md para obtener más detalles.

Licencia

Licencia ISC

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

Un servidor de protocolo de contexto de modelo que permite a los asistentes de IA como Claude acceder y buscar contenido de Atlassian Confluence, lo que permite la integración con la base de conocimiento de su organización.

Related MCP Servers

Notion MCP Server
Sjotie
A
security
F
license
A
quality
A Model Context Protocol server that connects Claude and other AI assistants to your Notion workspace, allowing AIs to interact with databases, pages, and blocks.
Last updated 2 months ago
12
0
10
JavaScript
Notion MCP Server
emmanuelsystems
A
security
F
license
A
quality
A Model Context Protocol server that connects AI assistants like Claude to Notion workspaces, enabling them to view, search, create, and update Notion databases, pages, and content blocks.
Last updated a month ago
12
194
JavaScript
Confluence MCP
cosmix
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants to interact with Confluence content, supporting operations like retrieving, searching, creating, and updating pages and spaces.
Last updated 2 days ago
9
8
TypeScript
MIT License
Filesystem MCP Server
QuantGeekDev
-
security
F
license
-
quality
A Model Context Protocol server that extends AI capabilities by providing file system access and management functionalities to Claude or other AI assistants.
Last updated 4 months ago
3
TypeScript

View all related MCP servers