Сервер Atlassian Confluence MCP

Сервер Node.js/TypeScript Model Context Protocol (MCP) для Atlassian Confluence Cloud. Позволяет системам ИИ (например, LLM, таким как Claude или Cursor AI) безопасно взаимодействовать с вашими пространствами, страницами и контентом Confluence в режиме реального времени.

Зачем использовать этот сервер?

• Минимальный ввод, максимальный вывод : простые идентификаторы предоставляют исчерпывающую информацию без необходимости дополнительных флагов.

• Полный доступ к базе знаний : предоставьте помощникам на базе искусственного интеллекта доступ к документации, вики-страницам и содержимому базы знаний.

• Расширенное форматирование контента : автоматическое преобразование формата документов Atlassian в читаемый Markdown.

• Безопасная локальная аутентификация : работайте локально с вашими учетными данными, никогда не храня токены на удаленных серверах.

• Интуитивно понятные ответы Markdown : хорошо структурированное, единообразное форматирование Markdown для всех выходных данных.

Related MCP server: Confluence MCP

Что такое МКП?

Model Context Protocol (MCP) — открытый стандарт для безопасного подключения систем ИИ к внешним инструментам и источникам данных. Этот сервер реализует MCP для Confluence Cloud, позволяя помощникам ИИ взаимодействовать с вашим контентом Confluence программным способом.

Предпосылки

• Node.js (>=18.x): Загрузить

• Аккаунт Atlassian с доступом к Confluence Cloud

Настраивать

Шаг 1: Получите свой токен API Atlassian

1. Перейдите на страницу управления токенами API Atlassian: https://id.atlassian.com/manage-profile/security/api-tokens

2. Нажмите Создать токен API .

3. Дайте ему описательную метку (например, mcp-confluence-access ).

4. Нажмите «Создать» .

5. Скопируйте сгенерированный API-токен немедленно. Вы больше не сможете его увидеть.

Шаг 2: Настройте учетные данные

Вариант A: Файл конфигурации MCP (рекомендуется)

Отредактируйте или создайте ~/.mcp/configs.json :

• <YOUR_SITE_NAME> : Имя вашего сайта Confluence (например, mycompany для mycompany.atlassian.net ).

• <YOUR_ATLASSIAN_EMAIL> : адрес электронной почты вашей учетной записи Atlassian.

• <YOUR_COPIED_API_TOKEN> : токен API из шага 1.

Вариант B: Переменные среды

Шаг 3: Установка и запуск

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

Глобальная установка

Шаг 4: Подключитесь к AI Assistant

Настройте MCP-совместимый клиент (например, Claude, Cursor AI):

Инструменты МКП

Инструменты MCP используют имена snake_case , параметры camelCase и возвращают ответы в формате Markdown.

• conf_ls_spaces : Список доступных пространств Confluence ( type : str opt, status : str opt, limit : num opt, cursor : str opt). Использование: Просмотр доступных пространств.

• conf_get_space : Получает подробную информацию о пространстве ( spaceKey : str req). Использование: Доступ к содержимому пространства и метаданным.

• conf_ls_pages : Список страниц с фильтрацией ( spaceIds : str[] opt, spaceKeys : str[] opt, title : str opt, status : str[] opt, sort : str opt, limit : num opt, cursor : str opt). Использование: Поиск страниц, соответствующих критериям.

• conf_get_page : Получает полное содержимое страницы ( pageId : str req). Использование: Просмотр полного содержимого страницы в формате Markdown.

• conf_ls_page_comments : Список комментариев на странице ( pageId : str req). Использование: Чтение обсуждений страницы.

• conf_search : Поиск контента Confluence ( cql : str opt, query : str opt, title : str opt, spaceKey : str opt, labels : str[] opt, contentType : str opt, limit : num opt, cursor : str opt). Использование: Поиск определенного контента.

conf_ls_spaces

Список глобальных пространств:

conf_get_space

Получить подробную информацию о пространстве:

conf_ls_pages

Список страниц по пространству и названию:

Список страниц из нескольких пространств:

conf_get_page

Получить содержимое страницы:

conf_ls_page_comments

Комментарии к странице списка:

conf_search

Простой поиск:

Расширенный поиск CQL:

Команды CLI

Команды CLI используют kebab-case . Запустите --help для получения подробной информации (например, mcp-atlassian-confluence ls-spaces --help ).

• ls-spaces : Выводит список пространств ( --type , --status , --limit , --cursor ). Пример: mcp-atlassian-confluence ls-spaces --type global .

• get-space : Получает сведения о пространстве ( --space-key ). Пример: mcp-atlassian-confluence get-space --space-key DEV .

• ls-pages : Выводит список страниц ( --space-keys , --title , --status , --sort , --limit , --cursor ). Пример: mcp-atlassian-confluence ls-pages --space-keys DEV .

• get-page : Получает содержимое страницы ( --page-id ). Пример: mcp-atlassian-confluence get-page --page-id 12345678 .

• ls-page-comments : Выводит список комментариев ( --page-id ). Пример: mcp-atlassian-confluence ls-page-comments --page-id 12345678 .

• search : Поиск контента ( --cql , --query , --space-key , --label , --type , --limit , --cursor ). Пример: mcp-atlassian-confluence search --query "security" .

Список пробелов

Список глобальных пространств:

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

Список страниц

С помощью нескольких клавиш пробела:

С фильтром по названию:

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

Список комментариев к странице

Поиск

Простой поиск:

Поиск CQL:

Формат ответа

Все ответы отформатированы в формате Markdown, включая:

• Название : Тип и название контента.

• Контент : полное содержимое страницы, результаты поиска или список элементов.

• Метаданные : создатель, дата, метки и другая соответствующая информация.

• Пагинация : навигационная информация для постраничных результатов.

• Ссылки : ссылки на связанные ресурсы, если применимо.

Ответ на список пробелов

Ответ на содержание страницы

Разработка

Внося вклад

Вклады приветствуются! Пожалуйста:

1. Создайте форк репозитория.

2. Создайте ветку функций ( git checkout -b feature/xyz ).

3. Зафиксируйте изменения ( git commit -m "Add xyz feature" ).

4. Отправьте изменения в ветку ( git push origin feature/xyz ).

5. Откройте запрос на извлечение.

Подробности смотрите на сайте CONTRIBUTING.md .

Лицензия

Лицензия ISC