Слияние MCP

Сервер протокола контекста модели (MCP) для Confluence, позволяющий помощникам на базе искусственного интеллекта взаимодействовать с контентом Confluence через стандартизированный интерфейс.

ℹ️ Для Jira есть отдельный MCP сервер

Функции

Аутентификация в Confluence с использованием персонального API-токена
Извлечение и поиск страниц и пространств Confluence
Создавайте и обновляйте контент Confluence
Извлечение и добавление комментариев к страницам
Извлечение и добавление вложений к страницам
Очистите и преобразуйте контент Confluence для потребления ИИ
Управление коммуникацией API, обработкой ошибок и преобразованием данных
Базовое ограничение скорости для предотвращения злоупотреблений API

Предпосылки

Бан (v1.0.0 или выше)
Аккаунт Confluence с доступом к API

Установка

# Clone the repository
git clone https://github.com/cosmix/confluence-mcp.git
cd confluence-mcp

# Install dependencies
bun install

# Build the project
bun run build

Конфигурация

Чтобы использовать этот MCP-сервер, вам необходимо установить следующие переменные среды:

CONFLUENCE_API_TOKEN=your_api_token
CONFLUENCE_BASE_URL=your_confluence_instance_url  # e.g., https://your-domain.atlassian.net/wiki
CONFLUENCE_USER_EMAIL=your_email

Конфигурация рабочего стола Claude / Cline

Добавьте эту конфигурацию в ваш файл настроек:

{
  "mcpServers": {
    "confluence": {
      "command": "bun",
      "args": ["/absolute/path/to/confluence-mcp/dist/index.js"],
      "env": {
        "CONFLUENCE_API_TOKEN": "your_api_token",
        "CONFLUENCE_BASE_URL": "your_confluence_instance_url/wiki",
        "CONFLUENCE_USER_EMAIL": "your_email"
      }
    }
  }
}

Разработка

# Run in development mode
bun run dev

# Run tests
bun test

Доступные инструменты

Сервер Confluence MCP предоставляет следующие инструменты:

получить_страницу

Извлечь страницу Confluence по идентификатору. Формат относится к возвращаемому формату содержимого и может быть text или markdown . Параметр includeMarkup позволяет извлечь исходную разметку Confluence Storage Format (XHTML), которая полезна для обновления страниц с сохранением форматирования.

{
  "pageId": "123456",
  "format": "text",
  "includeMarkup": true
}

страницы_поиска

Поиск страниц Confluence с использованием CQL (язык запросов Confluence). Формат относится к возвращаемому формату содержимого и может быть text или markdown . Параметр includeMarkup позволяет получить исходную разметку Confluence Storage Format (XHTML) для каждой страницы.

{
  "query": "space = DEV and label = documentation",
  "limit": 10,
  "format": "text",
  "includeMarkup": true
}

получить_пространства

Перечислите все доступные пространства Confluence.

{
  "limit": 50
}

создать_страницу

Создайте новую страницу Confluence. parentId необязателен и может использоваться для создания дочерней страницы под существующей страницей.

{
  "spaceKey": "DEV",
  "title": "New Page Title",
  "content": "<p>Page content in Confluence Storage Format (XHTML)</p>",
  "parentId": "123456"
}

обновить_страницу

Обновите существующую страницу Confluence.

{
  "pageId": "123456",
  "title": "Updated Page Title",
  "content": "<p>Updated content in Confluence Storage Format (XHTML)</p>",
  "version": 1
}

получить_комментарии

Извлечь комментарии для определенной страницы Confluence. Формат относится к возвращаемому формату контента и может быть text или markdown .

{
  "pageId": "123456",
  "limit": 25,
  "format": "text"
}

добавить_комментарий

Добавьте комментарий на страницу Confluence. parentId необязателен для создания цепочек ответов.

{
  "pageId": "123456",
  "content": "<p>This is a new comment.</p>",
  "parentId": "789012"
}

получить_вложения

Извлечение вложений для определенной страницы Confluence.

{
  "pageId": "123456",
  "limit": 25
}

добавить_вложение

Добавьте вложение на страницу Confluence. fileContentBase64 должен быть закодированной в base64 строкой содержимого файла.

{
  "pageId": "123456",
  "filename": "document.pdf",
  "fileContentBase64": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFI+P...",
  "comment": "Uploaded new version of the document"
}

ЛИЦЕНЗИЯ

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENCE .

Confluence MCP

Integrations