Atlassian MCP Server

Atlassian Rovo MCP Server

Официальный сервер Model Context Protocol (MCP) для Atlassian: облачный мост, предоставляющий вашим ИИ-инструментам безопасный доступ в реальном времени к Jira, Confluence, Jira Service Management, Bitbucket и Compass.

Начало работы · Поддерживаемые инструменты · Безопасность и администрирование · Сообщество

---

Официальный Atlassian Rovo MCP Server — это облачный мост между вашим сайтом Atlassian Cloud и совместимыми внешними инструментами. После настройки он позволяет этим инструментам взаимодействовать с данными Jira, Confluence, Jira Service Management, Bitbucket и Compass в реальном времени. Аутентификация использует OAuth 2.1 или API-токены, поэтому каждое действие учитывает существующие права доступа пользователя.

С Atlassian Rovo MCP Server вы можете:

• Суммировать и искать контент Jira, Confluence, Jira Service Management и Bitbucket, не переключаясь между инструментами.
• Создавать и обновлять задачи или страницы с помощью команд на естественном языке.
• Автоматизировать повторяющуюся работу, например создание тикетов из заметок совещаний или спецификаций.

Он создан для разработчиков, авторов контента и проектных команд, которые работают в IDE или ИИ-инструментах и хотят использовать данные Atlassian без постоянного переключения контекста.

Настройка в один клик

Выберите вашего ИИ-клиента ниже, чтобы установить официальный Atlassian Rovo MCP Server. Каждая кнопка использует нативную ссылку установки вашего клиента, поэтому вам не нужно вручную редактировать JSON-конфигурацию.

Добавить в Cursor Ссылайтесь на задачи и регистрируйте работу в вашей кодовой базе.

Добавить в VS Code Ищите и создавайте задачи Jira через GitHub Copilot.

Добавить в ChatGPT Ищите, суммируйте и создавайте прямо из ChatGPT.

Добавить в Claude Интегрируйте Jira и Confluence в рабочие процессы Claude.

Содержание

• Настройка в один клик
• Поддерживаемые клиенты
• Поддерживаемые продукты и инструменты
• Перед началом работы
• Данные и безопасность
• Как это работает
• Примеры рабочих процессов
• Советы и рекомендации
• Заметки для администраторов: управление доступом
• Безопасность
• Поддержка и обратная связь
• Отказ от ответственности

---

Поддерживаемые клиенты

Atlassian Rovo MCP Server работает с растущим списком MCP-совместимых клиентов:

Клиент	Руководство по настройке
OpenAI ChatGPT	Руководство по коннекторам / MCP
Claude (Claude.ai, Desktop и Code)	Документация Claude MCP
Cursor	Atlassian в маркетплейсе Cursor
Visual Studio Code (GitHub Copilot)	Документация VS Code MCP
GitHub Copilot CLI	О Copilot CLI
Google Gemini CLI	Документация Gemini CLI MCP
Amazon Quick Suite	Руководство по интеграции MCP

Atlassian Rovo MCP Server также поддерживает любой локальный MCP-совместимый клиент, который может работать на localhost и подключаться к серверу через прокси mcp-remote. Это позволяет создавать пользовательские или сторонние интеграции, соответствующие спецификации MCP.

[!TIP] Актуальный канонический список поддерживаемых клиентов и пошаговую настройку см. в разделе Начало работы с Atlassian Rovo MCP Server. Вы также можете обратиться к собственной документации MCP вашего клиента или встроенному помощнику.

---

Поддерживаемые продукты и инструменты

Инструменты организованы по продуктам и назначению (чтение, запись или поиск). Администраторы организации предоставляют или отзывают доступ на уровне групп разрешений, и каждый инструмент наследует доступ своей родительской группы.

Продукт	Группы разрешений	OAuth 2.1	API-токен
Jira	read · write · search	✅	✅
Confluence	read · write · search	✅	✅
Jira Service Management	read · write	—	✅ (только)
Bitbucket Cloud	read · write	—	✅ (с ограниченной областью действия, только)
Compass	read · write	✅ (только)	—
Платформа Atlassian	read_teamwork_graph · search_atlassian	✅	✅

[!NOTE] Инструменты Jira Service Management и Bitbucket Cloud доступны только через аутентификацию по API-токену, а инструменты Compass доступны только через OAuth 2.1. Полный актуальный справочник инструментов см. в разделе Поддерживаемые инструменты.

---

Перед началом работы

Перед настройкой сервера убедитесь, что ваше окружение соответствует этим требованиям.

Предварительные требования

Требования зависят от способа подключения:

Для поддерживаемых клиентов

• Сайт Atlassian Cloud с одним или несколькими продуктами: Jira, Confluence, Jira Service Management, Bitbucket или Compass
• Доступ к выбранному клиенту
• Современный браузер для прохождения потока авторизации OAuth 2.1 или учетные данные API-токена для автономной аутентификации

Для IDE или локальных клиентов (настройка на десктопе)

• Сайт Atlassian Cloud с одним или несколькими поддерживаемыми продуктами
• Поддерживаемая IDE (например, Claude Desktop, VS Code или Cursor) или пользовательский MCP-совместимый клиент
• Установленная Node.js v18+ для запуска локального MCP-прокси (mcp-remote)
• Современный браузер для завершения входа через OAuth или учетные данные API-токена для автономной аутентификации

---

Данные и безопасность

Сервер обеспечивает несколько мер контроля безопасности:

• Весь трафик шифруется при передаче по протоколу HTTPS (TLS 1.2 или выше) в соответствии с практиками безопасности Atlassian.
• OAuth 2.1 и аутентификация по API-токену обеспечивают безопасный контроль доступа.
• Доступ к данным осуществляется с учетом прав пользователей в Jira, Confluence, Jira Service Management, Bitbucket и Compass.
• Если ваша организация использует белые списки IP-адресов для продуктов Atlassian Cloud, вызовы инструментов, сделанные через Atlassian Rovo MCP Server, также подчиняются этим правилам IP.

Для более подробного обзора модели безопасности и элементов управления администратора см.:

• Общие сведения об Atlassian Rovo MCP Server
• Управление настройками Atlassian Rovo MCP Server

---

Как это работает

Архитектура и взаимодействие

1. Поддерживаемый клиент подключается к конечной точке сервера. Рекомендуемая конечная точка для большинства клиентов:

   https://mcp.atlassian.com/v1/mcp/authv2
   

   Конечная точка https://mcp.atlassian.com/v1/mcp также поддерживается (например, для конфигураций с API-токеном).

2. В зависимости от вашей настройки запускается безопасный браузерный поток OAuth 2.1 или используется аутентификация по API-токену.

3. После авторизации клиент передает контекстные данные и получает ответы в реальном времени от подключенных продуктов Atlassian.

[!NOTE] Устаревшая конечная точка Server-Sent Events (https://mcp.atlassian.com/v1/sse) все еще поддерживается, но мы рекомендуем обновить все пользовательские клиенты, настроенные на использование /sse, чтобы они теперь указывали на /mcp (или /mcp/authv2).

Управление разрешениями

Доступ предоставляется только к тем данным, на просмотр которых у пользователя уже есть разрешение в Atlassian Cloud. Все действия учитывают существующие роли на уровне проекта или пространства. Аутентификация OAuth и по API-токену соблюдает настроенные области действия и разрешения Atlassian.

Аутентификация по API-токену (автономная)

Аутентификация по API-токену доступна для автономных, сервисных или неинтерактивных клиентских настроек (например, бэкенд-системы или автоматизация). Она также обязательна для инструментов Jira Service Management и Bitbucket Cloud.

• Требуется включение администратором: Администратор организации должен включить аутентификацию по API-токену для Rovo MCP Server (Администрирование Atlassian → Rovo → Rovo MCP server → Аутентификация).
• Требуется токен с ограниченной областью действия: Создайте персональный API-токен с областями действия, необходимыми для доступа к нужным инструментам и данным.
• Руководство по настройке: Настройка аутентификации через API-токен
• Справочник настроек администратора: Управление настройками Atlassian Rovo MCP Server: Настройка аутентификации

---

Примеры рабочих процессов

После подключения вы можете выполнять такие задачи из своего клиента.

Рабочие процессы Jira

• Поиск: «Найди все открытые баги в проекте Альфа».
• Создание/обновление: «Создай историю с названием "Редизайн онбординга"».
• Массовое создание: «Создай пять задач Jira из этих заметок».

Рабочие процессы Confluence

• Суммирование: «Суммируй страницу планирования второго квартала».
• Создание: «Создай страницу с названием "Цели команды на третий квартал"».
• Навигация: «К каким пространствам у меня есть доступ?»

Рабочие процессы Compass

• Создание: «Создай сервисный компонент на основе текущего репозитория».
• Массовое создание: «Импортируй компоненты и пользовательские поля из этого CSV/JSON».
• Запрос: «Что зависит от сервиса api-gateway?»

Комбинированные задачи

• Связывание контента: «Свяжи эти три тикета Jira со страницей "План релиза"».
• Поиск документации: «Получи страницу документации Confluence, связанную с этим компонентом Compass».

[!NOTE] Фактические возможности зависят от вашего уровня разрешений и клиентской платформы.

---

Советы и рекомендации

Установите CloudId, проект Jira и пространство Confluence по умолчанию

Обновите ваш AGENTS.md с помощью Markdown ниже, чтобы сократить количество вызовов инструментов обнаружения, сэкономить время и токены, а также установить максимальное количество результатов поиска.

## Atlassian Rovo MCP

When connected to atlassian-rovo-mcp:
- **MUST** use Jira project key = YOURPROJ
- **MUST** use Confluence spaceId = "123456"
- **MUST** use cloudId = "https://yoursite.atlassian.net" (do NOT call getAccessibleAtlassianResources)
- **MUST** use `maxResults: 10` or `limit: 10` for ALL Jira JQL and Confluence CQL search operations.

Используйте навыки

Если вы используете десктопный клиент, такой как Claude, вы можете создавать или повторно использовать навыки для повторяющихся задач. Посмотрите стандартные навыки Rovo MCP.

Для Cursor навыки являются частью плагина маркетплейса.

---

Заметки для администраторов: управление доступом

Если вы администратор, готовящий свою организацию к использованию Atlassian Rovo MCP Server, ознакомьтесь с пунктами ниже. Для получения более подробного руководства для администраторов см.:

• Общие сведения об Atlassian Rovo MCP Server
• Управление настройками Atlassian Rovo MCP Server
• Управление Atlassian Rovo MCP Server
• Мониторинг активности Atlassian Rovo MCP Server

Установка и доступ

• Не является приложением из Marketplace: Atlassian Rovo MCP Server не устанавливается через Atlassian Marketplace или экран Управление приложениями. Вместо этого он устанавливается автоматически при первом прохождении пользователем процедуры согласия OAuth 2.1 (3LO) (установка «точно вовремя» или «отложенная загрузка»).
• Требования для первой установки: Первый пользователь, проходящий процедуру согласия 3LO для вашего сайта, должен иметь доступ к приложениям Atlassian, запрашиваемым областями действия MCP (например, Jira и/или Confluence). Это гарантирует, что приложение MCP будет зарегистрировано с правильными разрешениями для вашего сайта.
• Последующий доступ пользователей: После первоначальной установки пользователи, имеющие доступ только к одному приложению Atlassian (например, только к Jira или только к Confluence), также могут пройти процедуру 3LO для доступа к этому приложению через MCP.

Управление, мониторинг и отзыв доступа

• Элементы управления для администраторов: Администраторы сайта и организации могут управлять, проверять или отзывать доступ приложения MCP со страницы Управление приложениями Marketplace и сторонними приложениями вашей организации. Приложение появляется в списке Подключенные приложения вашего сайта после первого успешного согласия 3LO.
• Управление доменами: Используйте страницу настроек Rovo MCP server в Atlassian Administration, чтобы контролировать, каким внешним инструментам ИИ и доменам разрешено подключаться. По умолчанию разрешены домены, поддерживаемые Atlassian; вы можете добавить доверенные домены или заблокировать поддерживаемые. Управление доменами применяется к подключениям OAuth 2.1. Подробнее см. Доступные домены Atlassian Rovo MCP server.
• Управление IP-адресами: Если ваша организация использует список разрешенных IP-адресов для облачных приложений Atlassian, запросы, выполняемые через Atlassian Rovo MCP Server, должны исходить с IP-адреса, разрешенного списком разрешенных IP-адресов вашей организации для соответствующего приложения. Подробнее о настройке см. Указание IP-адресов для доступа к продуктам.
• Элементы управления для конечных пользователей: Отдельные пользователи могут отозвать авторизацию своих приложений в настройках профиля.
• Ведение журнала аудита: Каждый раз, когда инструмент используется через Atlassian Rovo MCP Server, событие записывается в журнал аудита вашей организации. Администраторы могут просматривать их в Atlassian Administration в разделе Аналитика → Журнал аудита (отфильтруйте по Rovo MCP User Actions или выполните поиск по MCP). Дополнительные сведения см. в разделе Мониторинг активности Atlassian Rovo MCP server.

Устранение распространенных проблем

• Ошибка «Администратор вашего сайта должен авторизовать это приложение»: Администратор сайта должен пройти процедуру согласия 3LO, прежде чем кто-либо еще сможет использовать приложение MCP. Дополнительные сведения см. в разделе Ошибка «Администратор вашего сайта должен авторизовать это приложение» в облачных приложениях Atlassian.
• «У вас нет разрешения на подключение с этого IP-адреса. Обратитесь к администратору за доступом». Обычно это означает, что включен список разрешенных IP-адресов, и текущий IP-адрес пользователя не имеет доступа к Jira, Confluence, Jira Service Management, Bitbucket или Compass через Atlassian Rovo MCP Server. Попросите администратора вашего сайта или организации проверить конфигурацию списка разрешенных IP-адресов и при необходимости добавить соответствующие диапазоны IP-адресов сети или VPN.
• Приложение не отображается в списке «Подключенные приложения»: Убедитесь, что пользователь использует правильную учетную запись и сайт Atlassian, а также что приложение запрашивает правильные области действия приложений Atlassian (например, области Jira). Если проблема не устранена, проверьте Управление приложениями Marketplace и сторонними приложениями вашей организации или обратитесь в службу поддержки Atlassian. Также проверьте разрешения пользователя на продукты в Atlassian Administration.

---

Безопасность

Model Context Protocol (MCP) позволяет агентам ИИ подключаться к инструментам и данным Atlassian, используя разрешения вашей учетной записи, что создает мощные рабочие процессы, но также и структурные риски. Любой клиент или сервер MCP, который вы включаете (например, плагины IDE, настольные приложения, размещенные серверы MCP или интеграции «в один клик»), может заставить агента ИИ выполнять действия от вашего имени.

Большие языковые модели (LLM) уязвимы для атак с внедрением подсказок и связанных с ними атак (таких как косвенное внедрение подсказок и отравление инструментов). Эти атаки могут дать агенту указание извлечь данные или внести непреднамеренные изменения без явных запросов.

Чтобы снизить риск, используйте только доверенные клиенты и серверы MCP, тщательно проверяйте, к каким инструментам и данным имеет доступ каждый агент, и применяйте принцип наименьших привилегий (токены с ограниченной областью действия, минимальный доступ к проекту/рабочей области). Для любых действий с высоким уровнем воздействия или деструктивных действий требуйте подтверждения человеком и отслеживайте журналы аудита на предмет необычной активности. Мы настоятельно рекомендуем ознакомиться с руководством Atlassian по рискам MCP в разделе Клиенты MCP: понимание потенциальных рисков безопасности.

---

Поддержка и обратная связь

Мы используем ваши отзывы для улучшения Atlassian Rovo MCP Server. Если вы столкнулись с ошибкой или ограничением, или у вас есть предложение:

• Посетите Портал поддержки Atlassian, чтобы сообщить о проблемах и запросах на новые функции.
• Делитесь своим опытом и вопросами в Atlassian Community, а вопросами, связанными с разработкой, — в Atlassian Developer Community.
• Перейдите на наш Портал разработчика экосистемы, если вы создаете приложение и обнаружили ошибку или проблему, или у вас есть предложения.

---

Отказ от ответственности

Клиенты MCP могут выполнять действия в Jira, Confluence, Jira Service Management, Bitbucket и Compass с вашими существующими разрешениями. Используйте принцип наименьших привилегий, проверяйте изменения с высоким уровнем воздействия перед подтверждением и отслеживайте журналы аудита на предмет необычной активности.

Подробнее: Клиенты MCP: понимание потенциальных рисков безопасности.