Atlassian MCP Server

Что такое сервер Atlassian MCP?

Сервер Atlassian MCP — это сервер протокола контекста модели (MCP), предназначенный для интеграции продуктов Atlassian (Confluence и Jira, как в облаке, так и на сервере/Центре данных) с ИИ-ассистентами и инструментами для разработчиков. Он открывает возможности Jira и Confluence как исполняемые функции ("инструменты") через интерфейс MCP. Это позволяет LLM и агентам автоматизировать, искать и взаимодействовать с контентом Atlassian программно. Он служит безопасным мостом между вашим экземпляром Atlassian и хост-приложениями MCP.

Как настроить сервер Atlassian MCP

1. Настройка аутентификации: Выберите предпочитаемый метод аутентификации в зависимости от типа развертывания:
   • Для Jira/Confluence Cloud: используйте токен API (рекомендуется) или OAuth 2.0
   • Для Server/Data Center: используйте токен персонального доступа (PAT)
2. Переменные окружения: Подготовьте переменные окружения для ваших URL-адресов Atlassian, токенов и других вариантов (таких как фильтры проектов/пространств, режим только для чтения, логирование).
3. Установка: Скачайте образ Docker (ghcr.io/sooperset/mcp-atlassian:latest) в вашу локальную среду или на сервер.
4. Настройка в IDE или ассистенте:
   • Передайте переменные окружения через настройки сервера MCP вашей IDE (например, в claude_desktop_config.json или в настройках MCP Cursor).
   • Либо создайте файл окружения и используйте флаг --env-file Docker.
5. Настройка транспорта: Сервер может работать как процесс, используя stdio, или как постоянный HTTP-сервис (с использованием SSE или потоковых HTTP-транспортов) для многопользовательских или сетевых развертываний.
6. Поддержка прокси: Настройте HTTP(S)/SOCKS-прокси по мере необходимости, используя соответствующие переменные окружения.
7. Контроль инструментов: Используйте ENABLED_TOOLS, чтобы ограничить или разрешить доступ к конкретным операциям, и READ_ONLY_MODE для дополнительной безопасности.

Как использовать сервер Atlassian MCP

1. Запустите сервер: Запустите сервер с вашей конфигурацией через Docker, при необходимости указав включенные инструменты, логирование или тип транспорта.
2. Подключитесь через IDE или ИИ-ассистента: Добавьте работающий сервер в настройки MCP вашей IDE/ассистента, указав соответствующую команду или HTTP-адрес.
3. Вызовите инструменты: Используйте естественный язык или специальные потоки, чтобы попросить вашего помощника о помощи с действиями в Jira и Confluence (например, поиск, создание, обновление, резюмирование).
4. Контроль доступа: Фильтруйте доступные инструменты, включайте/выключайте операции записи и выбирайте аутентификацию для каждого пользователя или для всего сервера по мере необходимости.
5. Мониторинг и отладка: Просматривайте логи, используйте инструменты отладки и следите за взаимодействиями, чтобы обеспечить плавную работу.

Ключевые особенности

• Поддержка Jira и Confluence (облако и сервер/ЦД) с одной интеграцией
• Исполняемые инструменты: Открывает API Atlassian как вызываемые инструменты через MCP для LLM и агентов
• Бесшовная интеграция IDE/ассистента: Настраиваемо в Claude Desktop, Cursor и подобных платформах
• Поддержка многократной аутентификации: Поддержка OAuth 2.0, токенов API и PAT. Обеспечивает как одиночную, так и многопользовательскую аутентификацию
• Безопасное развёртывание внутри инфраструктуры: Держит учетные данные и данные внутри вашей среды
• Фильтрация инструментов и режимы только для чтения: Тонкий контроль над доступными действиями и разрешениями
• Поддержка прокси и логирования: Подготовлен для корпоративного использования с пользовательскими прокси, логированием и подробными опциями отладки
• Масштабируемый HTTP-транспорт: Может работать как постоянный HTTP-сервис для совместного или автоматизированного использования

Сценарии использования

• Поиск на базе ИИ: Быстро находите и резюмируйте документацию и задачи проекта с помощью запросов на естественном языке
• Автоматизированные обновления Jira: Создавайте, обновляйте, переходите и комментируйте задачи Jira на основе заметок со встреч или команд чата
• Генерация документов: Создавайте и обновляйте страницы Confluence или тикеты Jira прямо из вашего ИИ-ассистента или IDE
• Отчеты и фильтрация: Автоматизируйте получение и резюмирование срочных ошибок, статусных обновлений и метрик проекта
• Многопользовательские рабочие процессы: Обеспечьте доступ к действиям Atlassian для всей организации, учитывая каждую учётную запись пользователя с помощью токенов на пользователя

Часто задаваемые вопросы

В: Какие методы аутентификации поддерживаются?
О: Сервер поддерживает токены API Atlassian (облако), токены персонального доступа (сервер/ЦД) и OAuth 2.0 (облако, для сложных сценариев и поддержки многопользовательской аутентификации).

В: Могу ли я ограничить, какие действия предоставляются сервером MCP моему ассистенту?
О: Да, вы можете указать включенные инструменты через переменную окружения ENABLED_TOOLS или флаг командной строки, а также установить READ_ONLY_MODE, чтобы отключить все операции записи.

В: Как решить проблемы с SSL-сертификатами на моем сервере/Центре данных?
О: Установите CONFLUENCE_SSL_VERIFY=false или JIRA_SSL_VERIFY=false в вашей конфигурации, если ваш экземпляр Atlassian использует самоподписанные сертификаты.

В: Можно ли запустить сервер для нескольких пользователей с их собственными учетными данными?
О: Да, используйте HTTP-транспорт (SSE или потоковый HTTP) и пусть каждый клиент предоставляет уникальные токены (OAuth для облака или PAT для сервера/ЦД).

В: Что делать, если мой ассистент не может подключиться к Jira или Confluence?
О: Проверьте учетные данные аутентификации, настройки сети/прокси, точность URL и разрешения пользователей в вашем экземпляре Atlassian.