Skip to main content
Glama
deenesjakoruzh
aashari

Atlassian Confluence MCP Server

by aashari
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

Сервер 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 :

{
	"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

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

How are these scores calculated?

Resources

Tools

Appeared in Searches

Latest Blog Posts

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