Skip to main content
Glama
deenesjakoruzh

Atlassian Confluence MCP Server

by aashari
npmGitHub
TypeScript
819
28
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Сервер Atlassian Confluence MCP

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

Версия НПМ Статус сборки

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

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

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

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

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

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

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

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 :

{ "confluence": { "environments": { "ATLASSIAN_SITE_NAME": "<YOUR_SITE_NAME>", "ATLASSIAN_USER_EMAIL": "<YOUR_ATLASSIAN_EMAIL>", "ATLASSIAN_API_TOKEN": "<YOUR_COPIED_API_TOKEN>" } } }

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

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

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

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

export ATLASSIAN_SITE_NAME="<YOUR_SITE_NAME>" export ATLASSIAN_USER_EMAIL="<YOUR_EMAIL>" export ATLASSIAN_API_TOKEN="<YOUR_API_TOKEN>"

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

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

npx -y @aashari/mcp-server-atlassian-confluence ls-spaces

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

npm install -g @aashari/mcp-server-atlassian-confluence mcp-atlassian-confluence ls-spaces

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

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

{ "mcpServers": { "confluence": { "command": "npx", "args": ["-y", "@aashari/mcp-server-atlassian-confluence"] } } }

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

Инструменты 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

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

{ "type": "global", "status": "current", "limit": 10 }

conf_get_space

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

{ "spaceKey": "DEV" }

conf_ls_pages

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

{ "spaceKeys": ["DEV"], "title": "API Documentation", "status": ["current"], "sort": "-modified-date" }

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

{ "spaceKeys": ["DEV", "HR", "MARKETING"], "limit": 15, "sort": "-modified-date" }

conf_get_page

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

{ "pageId": "12345678" }

conf_ls_page_comments

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

{ "pageId": "12345678" }

conf_search

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

{ "query": "release notes Q1", "spaceKey": "PRODUCT", "contentType": "page", "limit": 5 }

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

{ "cql": "space = DEV AND label = api AND created >= '2023-01-01'" }

Команды 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" .

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

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

mcp-atlassian-confluence ls-spaces --type global --status current --limit 10

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

mcp-atlassian-confluence get-space --space-key DEV

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

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

mcp-atlassian-confluence ls-pages --space-keys DEV HR MARKETING --limit 15 --sort "-modified-date"

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

mcp-atlassian-confluence ls-pages --space-keys DEV --title "API Documentation" --status current

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

mcp-atlassian-confluence get-page --page-id 12345678

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

mcp-atlassian-confluence ls-page-comments --page-id 12345678

Поиск

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

mcp-atlassian-confluence search --query "security best practices" --space-key DOCS --type page --limit 5

Поиск CQL:

mcp-atlassian-confluence search --cql "label = official-docs AND creator = currentUser()"

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

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

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

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

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

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

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

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

# Confluence Spaces Showing **5** global spaces (current) | Key | Name | Description | |---|---|---| | [DEV](#) | Development | Engineering and development documentation | | [HR](#) | Human Resources | Employee policies and procedures | | [MARKETING](#) | Marketing | Brand guidelines and campaign materials | | [PRODUCT](#) | Product | Product specifications and roadmaps | | [SALES](#) | Sales | Sales processes and resources | *Retrieved from mycompany.atlassian.net on 2025-05-19 14:22 UTC* Use `cursor: "next-page-token-123"` to see more spaces.

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

# API Authentication Guide **Space:** [DEV](#) (Development) **Created by:** Jane Smith on 2025-04-01 **Last updated:** John Doe on 2025-05-15 **Labels:** api, security, authentication ## Overview This document outlines the authentication approaches supported by our API platform. ## Authentication Methods ### OAuth 2.0 We support the following OAuth 2.0 flows: 1. **Authorization Code Flow** - For web applications 2. **Client Credentials Flow** - For server-to-server 3. **Implicit Flow** - For legacy clients only ### API Keys Static API keys are supported but discouraged for production use due to security limitations: | Key Type | Use Case | Expiration | |---|---|---| | Development | Testing | 30 days | | Production | Live systems | 90 days | ## Implementation Examples import requests def get_oauth_token(): return requests.post( 'https://api.example.com/oauth/token', data={ 'client_id': 'YOUR_CLIENT_ID', 'client_secret': 'YOUR_CLIENT_SECRET', 'grant_type': 'client_credentials' } ).json()['access_token'] *Retrieved from mycompany.atlassian.net on 2025-05-19 14:25 UTC*

Разработка

# Clone repository git clone https://github.com/aashari/mcp-server-atlassian-confluence.git cd mcp-server-atlassian-confluence # Install dependencies npm install # Run in development mode npm run dev:server # Run tests npm test

Внося вклад

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

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

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

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

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

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

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

Лицензия

Лицензия ISC

Deploy Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

Сервер Model Context Protocol, который позволяет помощникам с искусственным интеллектом, таким как Клод, получать доступ к контенту Atlassian Confluence и выполнять его поиск, обеспечивая интеграцию с базой знаний вашей организации.

  1. Зачем использовать этот сервер?
    1. Что такое МКП?
      1. Предпосылки
        1. Настраивать
          1. Шаг 1: Получите свой токен API Atlassian
          2. Шаг 2: Настройте учетные данные
          3. Шаг 3: Установка и запуск
          4. Шаг 4: Подключитесь к AI Assistant
        2. Инструменты МКП
          1. conf_ls_spaces
          2. conf_get_space
          3. conf_ls_pages
          4. conf_get_page
          5. conf_ls_page_comments
          6. conf_search
        3. Команды CLI
          1. Список пробелов
          2. Получить пространство
          3. Список страниц
          4. Получить страницу
          5. Список комментариев к странице
          6. Поиск
        4. Формат ответа
          1. Ответ на список пробелов
          2. Ответ на содержание страницы
        5. Разработка
          1. Внося вклад
            1. Лицензия

              Related MCP Servers

              • Notion MCP Server

                emmanuelsystems
                A
                security
                F
                license
                A
                quality
                A Model Context Protocol server that connects AI assistants like Claude to Notion workspaces, enabling them to view, search, create, and update Notion databases, pages, and content blocks.
                Last updated -
                12
                208
                1
                • Apple

              • Confluence MCP

                cosmix
                A
                security
                A
                license
                A
                quality
                A Model Context Protocol server that enables AI assistants to interact with Confluence content, supporting operations like retrieving, searching, creating, and updating pages and spaces.
                Last updated -
                9
                7
                MIT License

              • Filesystem MCP Server

                QuantGeekDev
                -
                security
                F
                license
                -
                quality
                A Model Context Protocol server that extends AI capabilities by providing file system access and management functionalities to Claude or other AI assistants.
                Last updated -
                343
                6
                • Apple

              • Confluence MCP Server

                Olson3R
                A
                security
                F
                license
                A
                quality
                A Model Context Protocol server that provides secure access to Atlassian Confluence, allowing users to search, create, update, and manage Confluence pages and spaces through natural language commands.
                Last updated -
                10
                1

              View all related MCP servers

              Appeared in Searches

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/aashari/mcp-server-atlassian-confluence'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server