Skip to main content
Glama
Stillfrozen

Confluence MCP Server — Cursor

by Stillfrozen

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

Что умеет

Tool

Назначение

get-current-user

Проверка авторизации: display name / username

list-spaces

Пространства, доступные текущему пользователю

search-pages

Поиск по CQL, например title~"паспорт" AND type=page

get-page

Страница по page_id или по space_key + точному title. Тело — body.storage (HTML/storage)

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

Related MCP server: Confluence MCP Server

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

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

Related MCP Connectors

Related MCP Servers