---
title: "Confluence MCP Server — Cursor"
tags:
  - проект/workspace
  - подпроект/tools
  - тип/guide
  - область/tech
---

# Confluence MCP Server — Cursor

Локальный [MCP](https://modelcontextprotocol.io/)-сервер для Cursor: агент ищет и читает страницы [Confluence](https://www.atlassian.com/software/confluence) **Server / Data Center** по Personal Access Token.

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

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

> **Русская пошаговая установка:** [docs/INSTALL.ru.md](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 он не попадает.

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

```bash
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`:

```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:

```bash
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: чужие пространства не видны.

## Разработка

```bash
npm install
npm run build
npm run start:stdio
```

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

```bash
node scripts/smoke-test.mjs
```

## Лицензия

MIT