title: "Confluence MCP Server — Cursor" tags:

• proyecto/workspace

• subproyecto/tools

• tipo/guía

• área/tech

Confluence MCP Server — Cursor

Servidor MCP local para Cursor: el agente busca y lee páginas de Confluence Server / Data Center mediante Personal Access Token.

La escritura de páginas no está implementada. Confluence Cloud (otra URL y autenticación básica) no es compatible con este conector.

Repositorio: https://github.com/Stillfrozen/confluence-cursor-connector

Instalación paso a paso en ruso: docs/INSTALL.ru.md

Qué puede hacer

El token vive solo en ~/.cursor/mcp.json. No llega a git.

Related MCP server: Confluence Node MCP Server

Inicio rápido

git clone https://github.com/Stillfrozen/confluence-cursor-connector.git
cd confluence-cursor-connector
npm install
npm run build

PAT: en Confluence abra el perfil → Settings → Personal Access Tokens → cree un token.

En ~/.cursor/mcp.json:

{
  "mcpServers": {
    "confluence": {
      "command": "node",
      "args": ["/absolute/path/to/confluence-cursor-connector/dist/stdio-entry.js"],
      "env": {
        "CONFLUENCE_BASE_URL": "https://wiki.example.com",
        "CONFLUENCE_PAT": "your-personal-access-token"
      }
    }
  }
}

CONFLUENCE_BASE_URL — la raíz de la wiki sin la cola /rest/api y sin barra al final. Para compatibilidad también se acepta el nombre de variable PAT.

Recargar MCP: Cursor → Settings → MCP. El indicador confluence debe ponerse verde.

Comprobación en el chat: «Muestra mis espacios en Confluence» o «Lee la página 123456».

Opcionalmente copie la skill:

mkdir -p ~/.cursor/skills/confluence
cp skills/confluence/SKILL.md ~/.cursor/skills/confluence/SKILL.md

Limitaciones

• Solo lectura. No se puede crear o editar una página a través de MCP.

• API — Confluence Server / Data Center (/rest/api/..., Authorization: Bearer).

• get-page devuelve HTML de storage, no Markdown. El agente debe limpiar las macros ac: por sí mismo.

• CQL está limitado por los permisos del PAT: los espacios ajenos no son visibles.

Desarrollo

npm install
npm run build
npm run start:stdio

Prueba de humo de una instancia en vivo (lee confluence.env de ~/.cursor/mcp.json):

node scripts/smoke-test.mjs

Licencia

MIT