Atlassian MCP Server

Atlassian Rovo MCP Server

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

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

---

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

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

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

Подключитесь один раз, а затем описывайте, что вам нужно — без переключения вкладок и копирования. Ваш AI выбирает и выполняет нужные действия.

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

[!IMPORTANT] v2 теперь является рекомендуемой версией. Новые настройки должны использовать https://mcp.atlassian.com/v2/mcp, который предоставляет больше инструментов и продуктов. Существующие подключения v1 автоматически начинают использовать инструменты v2; несовместимым клиентам может потребоваться очистить кэшированные идентификаторы клиентов или учетные данные .well-known, чтобы продолжить аутентификацию. Инструкции по настройке см. в разделе Начало работы с Atlassian Rovo MCP Server.

Быстрая настройка

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

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

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

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

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

Позвольте вашему агенту выполнить настройку

Большинство AI-агентов для кодирования могут самостоятельно установить, аутентифицировать и настроить сервер. Скопируйте и вставьте этот промпт в своего агента:

Set up Atlassian Rovo MCP for this agent using the official setup guide at
https://support.atlassian.com/atlassian-rovo-mcp-server/docs/getting-started-with-the-atlassian-remote-mcp-server/
and the MCP server URL https://mcp.atlassian.com/v2/mcp. Then start the Atlassian MCP
authentication flow so I can sign in.

Или добавьте сервер вручную с помощью собственной команды вашего клиента:

Клиент	Команда или конфигурация
Claude Code	claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp, затем выполните /mcp в сеансе для аутентификации
Codex	codex mcp add atlassian --url https://mcp.atlassian.com/v2/mcp
Claude Desktop	Настройки → Расширения → Обзор расширений → Плагины, затем найдите Atlassian
Codex Desktop	Плагины или Коннекторы, затем установите Atlassian Rovo
VS Code / GitHub Copilot	Представление расширений → найдите @mcp Atlassian → Установить
Cursor	Плагин Atlassian для Cursor с MCP → Добавить в Cursor
Windsurf	Cascade → MCP-серверы → Добавить сервер → Добавить пользовательский сервер, с serverUrl, установленным в https://mcp.atlassian.com/v2/mcp
Любой другой MCP-клиент	Используйте URL сервера https://mcp.atlassian.com/v2/mcp

Содержание

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

---

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

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

Клиент	Справочник по настройке
OpenAI ChatGPT	Руководство по Connectors / MCP
OpenAI Codex (CLI и Desktop)	Документация Codex 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
Windsurf	Документация Windsurf MCP
Docker	Каталог и набор инструментов Docker MCP
Kiro и другие клиенты Agent Plugins	Документация Kiro Powers
Amazon Quick Suite	Руководство по интеграции MCP

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

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

---

Упаковка плагинов и совместимость

Этот репозиторий публикует один и тот же MCP-сервер и навыки в нескольких форматах пакетов, чтобы клиенты могли использовать собственные процессы обнаружения и установки:

Формат	Манифест и конфигурация	Общие компоненты
Agent Plugins v1	plugin.json и mcp.json	skills/
Плагин Claude Code	.claude-plugin/plugin.json и .claude-plugin/marketplace.json	.mcp.json и skills/
Плагин Cursor	.cursor-plugin/plugin.json	.mcp.json и skills/
Расширение Gemini	gemini-extension.json	Конфигурация MCP-сервера, встроенная в манифест
Реестр MCP	server.json	Метаданные удаленного сервера

Оба mcp.json и .mcp.json являются намеренными. Agent Plugins требует корневое имя файла mcp.json и его переносимый транспортный словарь; существующие клиенты продолжают использовать .mcp.json и собственный словарь конфигурации. При изменении любого файла сохраняйте согласованность настроек конечных точек.

Корневой пакет может быть импортирован клиентами, реализующими Agent Plugins, включая Kiro Powers. Специфичные для клиентов манифесты остаются доступными и не заменяются переносимым пакетом.

---

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

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

Продукт	Группы разрешений	OAuth 2.1	API-токен
Jira	read_jira · write_jira · search_jira	✅	✅
Jira (с правами администратора)	delete_jira · manage_jira	✅	✅
Confluence	read_confluence · write_confluence · search_confluence	✅	✅
Bitbucket Cloud	read_bitbucket · write_bitbucket	✅	✅
Jira Service Management	read_jsm · write_jsm	—	✅ (только)
Платформа Atlassian	read_teamwork_graph · write_teamwork_graph · search_atlassian	✅	✅
Loom	read_loom · write_loom	✅	✅
Goals	read_goals · write_goals	✅	✅
Projects	read_projects · write_projects	✅	✅
Teams	read_teams · write_teams	✅	✅
Focus	read_focus · write_focus	✅	✅
Talent	read_talent · write_talent	✅	✅
Compass	read_compass · write_compass	✅ (только)	—

Условия для конкретных продуктов:

• delete_jira и manage_jira отключены по умолчанию и должны быть включены администратором перед использованием.
• Инструменты Bitbucket Cloud доступны только в том случае, если ваше рабочее пространство Bitbucket связано с организацией. Рабочие пространства, не связанные с организацией, нельзя выбрать при аутентификации.
• Инструменты Jira Service Management поддерживают аутентификацию только через API-токен и доступны только в том случае, если администратор организации включил аутентификацию через API-токен.
• Инструменты Loom доступны только для рабочих пространств Loom, связанных с сайтом Atlassian.
• Инструменты Teamwork Graph могут получать данные от сторонних сервисов, подключенных к Jira, таких как связанные pull request, сборки и развертывания. Для GitHub for Atlassian полный доступ означает, что инструменты получают данные GitHub на основе разрешений пользователя GitHub, а ограниченный доступ — на основе разрешений пользователя Jira. Коннекторы Azure DevOps, GitLab, Jenkins и Spinnaker следуют модели ограниченного доступа.

[!NOTE] Полный актуальный справочник инструментов, включая требуемую область для каждой группы разрешений, см. в разделе Поддерживаемые инструменты.

---

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

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

Это дает два преимущества:

• Контекст вашего клиента остается свободным для текущей задачи, а не заполняется определениями инструментов.
• Новые инструменты становятся доступными без необходимости переподключения клиента.

MCP-шлюзы

Если вы используете MCP-шлюз или вам по какой-либо причине нужны все инструменты сразу, а не через методы обнаружения и выполнения, используйте переопределение tools=all, чтобы открыть все инструменты в виде разбитого на страницы плоского списка:

https://mcp.atlassian.com/v2/mcp?tools=all

---

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

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

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

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

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

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

Если администратор вашей организации отключил аутентификацию через API-токен, MCP-клиенты не смогут подключиться с токеном и должны использовать OAuth 2.1.

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

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

---

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

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

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

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

• Understand Atlassian Rovo MCP Server
• Control Atlassian Rovo MCP Server settings

---

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

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

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

   https://mcp.atlassian.com/v2/mcp
   

   Конечные точки v1 (https://mcp.atlassian.com/v1/mcp/authv2 и https://mcp.atlassian.com/v1/mcp) остаются поддерживаемыми, и существующие подключения v1 автоматически начинают открывать и использовать инструменты v2.

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

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

[!WARNING] После 30 июня 2026 года устаревшая конечная точка Server-Sent Events (https://mcp.atlassian.com/v1/sse) больше не будет поддерживаться. Обновите любые собственные клиенты, настроенные на использование /sse, чтобы они указывали на /mcp — предпочтительно на https://mcp.atlassian.com/v2/mcp.

[!NOTE] Клиентам, которые не могут завершить аутентификацию после перехода на инструменты v2, может потребоваться очистить кэшированные идентификаторы клиентов или учетные данные .well-known.

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

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

Аутентификация через API-токен (headless)

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

Поддерживаются два механизма:

Механизм	Заголовок
Персональный API-токен (Basic auth)	Authorization: Basic <base64(email:api_token)>
Ключ API сервисного аккаунта (Bearer token)	Authorization: Bearer <api_key>

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

---

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

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

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

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

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

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

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

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

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

• Получение: «Найди запись Loom обзора дизайна за прошлую неделю».
• Резюме: «Суммируй этот обзор Loom и перечисли пункты действий».

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

• Статус: «Какой текущий статус проекта Checkout Revamp?»
• Сводка: «Какие цели находятся под угрозой в этом квартале и почему?»

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

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

[!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 навыки являются частью плагина marketplace.

---

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

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

• Understand Atlassian Rovo MCP Server
• Control Atlassian Rovo MCP Server settings
• Manage Atlassian Rovo MCP Server
• Monitor Atlassian Rovo MCP Server activity

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

• Контроль администратора: Администраторы сайта и организации могут управлять, проверять или отзывать доступ MCP-приложения на странице Manage your organization's Marketplace and third-party apps.
• Контроль доменов: Используйте страницу настроек Rovo MCP server в Atlassian Administration, чтобы контролировать, каким внешним ИИ-инструментам и доменам разрешено подключаться. По умолчанию разрешены домены, поддерживаемые Atlassian; вы можете добавлять доверенные домены или блокировать поддерживаемые. Контроль доменов применяется к подключениям OAuth 2.1. Подробнее см. Available Atlassian Rovo MCP server domains.
• Контроль IP: Если ваша организация использует IP-allowlisting для приложений Atlassian Cloud, запросы через Atlassian Rovo MCP Server должны исходить с IP-адреса, разрешенного IP-allowlist вашей организации для соответствующего приложения. Подробнее о настройке см. Specify IP addresses for product access.
• Контроль конечных пользователей: Отдельные пользователи могут отозвать собственные авторизации приложения в настройках своего профиля.
• Журнал аудита: Каждый раз, когда инструмент используется через Atlassian Rovo MCP Server, событие записывается в журнал аудита вашей организации. Администраторы могут просматривать их в Atlassian Administration в разделе Insights → Audit log (фильтр по Rovo MCP User Actions или поиск MCP). Подробнее см. Monitor Atlassian Rovo MCP server activity.

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

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

---

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

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

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

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

---

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

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

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

---

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

MCP-клиенты могут выполнять действия в продуктах Atlassian с вашими существующими разрешениями. Используйте принцип наименьших привилегий, проверяйте изменения с высоким влиянием перед подтверждением и отслеживайте журналы аудита на предмет подозрительной активности.

Подробнее: MCP Clients: Understanding the potential security risks.