Confluence MCP Server — Cursor

title: "Confluence MCP Server — Cursor"tags:

• проект/workspace
• подпроект/tools
• тип/guide
• область/tech

Confluence MCP Server — Cursor

Локальный MCP-сервер для Cursor: агент ищет и читает страницы Confluence Server / Data Center по Personal Access Token.

Запись страниц не реализована. Облачный Confluence Cloud (другой URL и Basic-auth) этим коннектором не поддерживается.

Репозиторий: https://github.com/Stillfrozen/confluence-cursor-connector

Русская пошаговая установка: docs/INSTALL.ru.md

Что умеет

Токен живёт только в ~/.cursor/mcp.json. В git он не попадает.

Быстрый старт

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

PAT: в Confluence откройте профиль → Settings → Personal Access Tokens → создайте токен.

В ~/.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 — корень вики без хвоста /rest/api и без слэша в конце. Для совместимости принимается и имя переменной PAT.

Reload MCP: Cursor → Settings → MCP. Индикатор confluence должен стать зелёным.

Проверка в чате: «Покажи мои пространства в Confluence» или «Прочитай страницу 123456».

Опционально скопируйте skill:

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

Ограничения

• Только чтение. Создать или править страницу через MCP нельзя.
• API — Confluence Server / Data Center (/rest/api/..., Authorization: Bearer).
• get-page отдаёт storage HTML, не Markdown. Агенту нужно вычищать макросы ac: самостоятельно.
• CQL ограничен правами PAT: чужие пространства не видны.

Разработка

npm install
npm run build
npm run start:stdio

Smoke-тест живого инстанса (читает confluence.env из ~/.cursor/mcp.json):

node scripts/smoke-test.mjs

Лицензия

MIT