mcp-confluence

MCP-сервер для Confluence Server / Data Center (Self-Hosted) с авторизацией по Personal Access Token. Даёт LLM-агенту доступ к поиску, чтению, созданию/редактированию страниц, комментариям, меткам и вложениям.

Работает с Confluence Server/DC REST API (/rest/api). Для Confluence Cloud API отличается — этот сервер ориентирован именно на self-hosted.

Возможности

Инструмент	Назначение
confluence_search	Поиск по CQL
confluence_get_page	Страница по ID (тело в storage-формате, версия, метки)
confluence_get_page_by_title	Страница по пространству + заголовку
confluence_list_spaces	Список пространств
confluence_get_child_pages	Дочерние страницы
confluence_create_page	Создать страницу
confluence_update_page	Обновить (версия инкрементируется автоматически)
confluence_delete_page	Удалить страницу
confluence_add_comment	Добавить комментарий
confluence_get_labels / confluence_add_labels / confluence_remove_label	Метки
confluence_list_attachments	Список вложений
confluence_upload_attachment	Загрузить файл как вложение
confluence_download_attachment	Скачать вложение на диск

Установка

npm install
npm run build

Настройка

Вариант A — веб-панель (проще)

npm run config

Откройте http://127.0.0.1:4321. Форма позволяет:

• заполнить все поля (Base URL, PAT либо логин/пароль, TLS);
• проверить подключение одной кнопкой (запрос к вашему Confluence);
• сохранить .env в корень проекта;
• скопировать готовый JSON-конфиг для Claude.

Панель слушает только 127.0.0.1 и наружу не доступна.

Вариант B — вручную

Скопируйте .env.example в .env и заполните, либо задайте переменные окружения:

Переменная	Обязательна	Описание
CONFLUENCE_BASE_URL	да	URL инстанса, например https://confluence.company.local
CONFLUENCE_PAT	да*	Personal Access Token (рекомендуемый способ)
CONFLUENCE_USERNAME + CONFLUENCE_PASSWORD	да*	Basic Auth (fallback, если PAT не задан)
CONFLUENCE_TLS_REJECT_UNAUTHORIZED	нет	false — не проверять TLS (для self-signed)

* Нужен либо CONFLUENCE_PAT, либо пара логин/пароль.

Как получить PAT: в Confluence → аватар → Settings → Personal Access Tokens → Create token.

Подключение к Claude Code / Claude Desktop

Добавьте в конфиг MCP-клиента:

{
  "mcpServers": {
    "confluence": {
      "command": "node",
      "args": ["G:/Portfolio/mcp-confluence/dist/index.js"],
      "env": {
        "CONFLUENCE_BASE_URL": "https://confluence.company.local",
        "CONFLUENCE_PAT": "your-personal-access-token"
      }
    }
  }
}

Для Claude Code также можно быстрее:

claude mcp add confluence -- node G:/Portfolio/mcp-confluence/dist/index.js

(предварительно задав переменные окружения или прописав их через -e KEY=value).

Docker

Образ собирается multi-stage (сборка TypeScript → лёгкий node:22-alpine рантайм, ~260 МБ, запуск от непривилегированного пользователя node).

docker build -t mcp-confluence:latest .

MCP-сервер (stdio) — MCP-клиент запускает контейнер сам. Пример для Claude Code:

claude mcp add confluence -- \
  docker run --rm -i \
    -e CONFLUENCE_BASE_URL=https://confluence.company.local \
    -e CONFLUENCE_PAT=your-token \
    mcp-confluence:latest

Ключевой флаг — -i (interactive): протокол MCP идёт через stdin/stdout.

Веб-панель настройки — нужен проброс порта и CONFIG_UI_HOST=0.0.0.0:

docker run --rm -p 4321:4321 -e CONFIG_UI_HOST=0.0.0.0 \
  -v "$(pwd)/.env:/app/.env" \
  mcp-confluence:latest dist/web.js

Или через compose:

docker compose up   # поднимет панель на http://localhost:4321

.env внутри контейнера эфемерен — смонтируйте его томом (как выше), чтобы сохранённые настройки не пропали.

О формате тела страниц

Confluence хранит контент в storage-формате (XHTML с макросами). Примеры:

<p>Обычный абзац</p>
<h2>Заголовок</h2>
<ac:structured-macro ac:name="info">
  <ac:rich-text-body><p>Инфо-блок</p></ac:rich-text-body>
</ac:structured-macro>

При создании/обновлении страниц передавайте тело именно в этом формате.

Разработка

npm run dev   # tsc в watch-режиме

Лицензия

MIT