MCP-сервер для Atlassian

MCP-сервер для Atlassian — это приложение, которое предоставляет AI-ассистентам доступ к Jira и Confluence через стандартный протокол Model Context Protocol (MCP). Сервер разворачивается на виртуальной машине в Yandex Cloud.

Основные возможности и преимущества

• Интеграция с Yandex AI Studio. MCP-сервер интегрируется с AI Studio MCP Серверы — подключите его к вашим AI-агентам в несколько кликов.
• Работа с Jira. Позволяет AI-ассистентам искать задачи, создавать и обновлять issues, управлять проектами и просматривать статусы через естественный язык.
• Работа с Confluence. Поиск и чтение страниц, создание и обновление контента в пространствах Confluence с помощью AI-ассистента.
• Поддержка Cloud и Server/Data Center. Работает как с Atlassian Cloud, так и с self-hosted Jira Server/Data Center.
• Авторизация Bearer-токеном. Все запросы к MCP-серверу защищены Bearer-токеном, который хранится в Yandex Lockbox.
• Безопасное хранение секретов. Учётные данные Atlassian (API-токены, персональные токены) хранятся в Yandex Lockbox и извлекаются при запуске.
• Стандартный протокол MCP. Использует открытый протокол Model Context Protocol для взаимодействия с AI-моделями.
• HTTP транспорт. MCP-сервер доступен на порту 8000 (HTTP).
• Минимальные ресурсы. Приложение работает на виртуальной машине с минимальной конфигурацией (2 vCPU, 2 GB RAM).
• Docker-контейнеризация. Сервер запускается в Docker-контейнерах (MCP + nginx auth proxy).

1. Убедитесь, что у вас есть доступ к Jira и/или Confluence (Cloud или Server/Data Center).
2. Для Atlassian Cloud: создайте API-токен для вашей учётной записи Atlassian.
3. Для Server/Data Center: создайте персональный токен доступа (Personal Access Token) в настройках профиля.
4. Создайте секрет в Yandex Lockbox для хранения учётных данных Atlassian. Секрет должен содержать ключи в зависимости от типа подключения:
   • Для Confluence Cloud: confluence_username (email) и confluence_api_token.
   • Для Confluence Server/Data Center: confluence_personal_token.
   • Для Jira Cloud: jira_username (email) и jira_api_token.
   • Для Jira Server/Data Center: jira_personal_token.
5. Создайте секрет в Yandex Lockbox для хранения Bearer-токена авторизации. Секрет должен содержать ключ bearer_token с произвольным токеном.
6. Создайте сервисный аккаунт для установки приложения и назначьте ему на каталог установки роли compute.editor, iam.serviceAccounts.admin, vpc.admin, resource-manager.admin.
7. Назначьте установочному сервисному аккаунту роль lockbox.admin отдельно на секрет с Bearer-токеном и на секрет с учётными данными внешнего сервиса. Роль нужна для чтения и изменения прав доступа к выбранным секретам; назначать её на каталог не требуется. Это правило действует и для секретов из другого каталога. При установке приложение создаст отдельный сервисный аккаунт ВМ и назначит ему lockbox.payloadViewer только на выбранные секреты.
8. Шаблон также назначает аккаунту ВМ certificate-manager.certificates.downloader на каталог установки. Для создания этой привязки IAM установочному аккаунту нужна роль resource-manager.admin, в том числе когда пользовательский сертификат не выбран. Если используете сертификат, выберите его из каталога установки; для сертификата из другого каталога отдельно предоставьте аккаунту ВМ доступ к нему.
9. В консоли управления выберите сервис Cloud Apps.
10. На панели слева выберите Магазин приложений.
11. Выберите MCP Atlassian и нажмите кнопку Использовать.
12. Укажите:
    • Имя приложения.
    • (Опционально) Описание приложения.
    • Сервисный аккаунт, созданный ранее.
    • Облачную подсеть, в которой будет развёрнута виртуальная машина.
    • Идентификатор секрета Lockbox с Bearer-токеном для авторизации.
    • URL Confluence (если используется).
    • URL Jira (если используется).
    • Идентификатор секрета Lockbox с учётными данными Atlassian.
    • Внешний доступ к MCP-серверу (опционально; по умолчанию выключен, включите для подключения по публичному IP-адресу).
13. Нажмите кнопку Установить и дождитесь, пока приложение установится.
14. После установки скопируйте полный адрес из раздела Данные приложения, поле URL MCP-сервера (внутренний): http://<private-ip>:8000/mcp. Для подключения клиенту нужен сетевой доступ к внутреннему IP-адресу ВМ.
15. Настройте ваш AI-клиент для подключения к MCP-серверу, указав заголовок Authorization: Bearer <ваш-токен>.

Подключение MCP-сервера к Yandex AI Studio

1. В консоли управления откройте сервис AI Studio и перейдите в раздел Agent Core → MCP-серверы.
2. Нажмите Создать MCP-сервер и в разделе MCP-серверы из Yandex Cloud Marketplace выберите нужный MCP-сервер.
3. Укажите имя сервера и выберите уже развёрнутый экземпляр приложения или создайте новый, следуя инструкциям по развёртыванию. При развёртывании нового сервера кнопка Сохранить будет доступна только после полного развёртывания и запуска MCP-сервера.
4. После выбора приложения значения параметров Сеть и Сервисный аккаунт MCP-сервера заполнятся автоматически.
5. Нажмите Создать. После успешной проверки подключения выберите необходимые инструменты (tools) и нажмите Сохранить — MCP-сервер будет зарегистрирован в AI Studio и доступен для использования AI-агентами.

• Поиск задач в Jira с помощью AI-ассистента.
• Создание и обновление issues в Jira через естественный язык.
• Поиск и чтение страниц в Confluence.
• Создание и редактирование контента в Confluence через AI-ассистента.
• Управление проектами и отслеживание статусов задач в Jira.

Служба технической поддержки Yandex Cloud отвечает на запросы 24 часа в сутки, 7 дней в неделю. Доступные виды запросов и срок их обработки зависят от тарифного плана. Подключить платную поддержку можно в консоли управления. Подробнее о порядке оказания технической поддержки.