confluence-mcp-server

MCP-сервер для Confluence Server / Data Center REST API (/rest/api). Целевые версии проверки: 7.19.18, 8.7.2 и 9.2.21. Confluence Cloud вне скоупа v1.

С Confluence 9.2.20+ /rest/api/content попадает под rate limiting инстанса — клиент повторяет запросы при HTTP 429 (Retry-After / backoff).

English version

Безопасность: write-tools заблокированы, пока не выставить CONFLUENCE_READ_ONLY=false.

Установка / запуск в Cursor

{
  "mcpServers": {
    "confluence": {
      "command": "npx",
      "args": ["-y", "@mmtr-tech/confluence-mcp"],
      "env": {
        "CONFLUENCE_URL": "https://confluence.company.com",
        "CONFLUENCE_TOKEN": "your-pat",
        "CONFLUENCE_READ_ONLY": "true"
      }
    }
  }
}

После смены tools/конфига — Restart Cursor (toggle MCP часто недостаточен).

Переменные окружения

| Переменная | Обязательно | Описание | |------------|-------------|----------| | CONFLUENCE_URL | да | URL инстанса без trailing slash | | CONFLUENCE_TOKEN | да | Personal Access Token (Bearer) | | CONFLUENCE_READ_ONLY | нет | По умолчанию read-only (true / unset). Запись только при false | | CONFLUENCE_SSL_VERIFY | нет | По умолчанию true; false для self-signed | | CONFLUENCE_TIMEOUT_MS | нет | HTTP timeout в мс (по умолчанию 30000) |

Токены не коммитьте.

Tools

Read: ping, get_current_user, list_spaces, get_space, list_space_pages, get_page, find_page, list_page_children, search, list_page_comments

Write (нужен CONFLUENCE_READ_ONLY=false): create_page, update_page, add_comment

Типовой поток: search (CQL) → get_page → create_page / update_page / add_comment.
Тела страниц/комментариев — storage format (XHTML).

Вне скоупа v1: Cloud, labels CRUD, бинарные вложения, delete/trash, create/delete space, admin API.

Локальная разработка

cp .env.example .env
npm install
npm run test:unit
npm run typecheck
npm run dev

Документация API

• REST 8.7.2
• REST 7.19.18
• REST DC 9.0+ (Swagger)
• CQL

Skills

Skill confluence лежит в .cursor / .claude / .agents (см. docs/SKILLS.md).

License

MIT