Atlassian MCP Server

npx add-mcp 'https://mcp.atlassian.com/v1/mcp/authv2'

Atlassian MCP Server

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

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

---

Официальный Atlassian 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 MCP Server вы можете:

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

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

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

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

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

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

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

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

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

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

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

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

Set up Atlassian 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 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 MCP Server также поддерживает любой локальный MCP-совместимый клиент, который может работать на localhost и подключаться к серверу через прокси mcp-remote. Это позволяет создавать пользовательские или сторонние интеграции, соответствующие спецификации MCP.

[!TIP] Актуальный канонический список поддерживаемых клиентов и пошаговую настройку см. в разделе Начало работы с Atlassian 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 Registry	server.json	Метаданные удаленного сервера

Навыки в skills/ нацелены на конечную точку /v2/mcp и устанавливаются каждым упакованным плагином. Предыдущее поколение архивировано в skills/v1/ для тех, кто всё ещё использует конечную точку v1; оно не устанавливается ни одним плагином и настраивается вручную. Различия описаны в skills/README.md.

И 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] Полный актуальный справочник инструментов, включая требуемую область для каждой группы разрешений, см. в разделе Поддерживаемые инструменты.

---

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

Вместо отправки всех определений инструментов AI-клиенту при подключении Atlassian 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 MCP Server также соблюдают эти IP-правила.

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

• Понимание Atlassian MCP Server
• Управление настройками Atlassian MCP Server

---

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

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

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

---

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

---

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

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

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

## Atlassian 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, вы можете создавать или повторно использовать навыки для повторяющихся задач. См. навыки Atlassian MCP по умолчанию.

Для Cursor навыки являются частью плагина marketplace.

---

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

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

• Понимание Atlassian MCP Server
• Управление настройками Atlassian MCP Server
• Управление Atlassian MCP Server
• Мониторинг активности Atlassian MCP Server

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

• Контроль администратора: Администраторы сайта и организации могут управлять, проверять или отзывать доступ MCP-приложения на странице Управление приложениями Marketplace и сторонними приложениями вашей организации.
• Контроль доменов: Используйте страницу настроек Rovo MCP server в Atlassian Administration, чтобы контролировать, каким внешним AI-инструментам и доменам разрешено подключаться. По умолчанию разрешены домены, поддерживаемые Atlassian; вы можете добавить доверенные домены или заблокировать поддерживаемые. Контроль доменов применяется к подключениям OAuth 2.1. Подробнее см. Доступные домены Atlassian MCP server.
• Контроль IP: Если ваша организация использует IP-allowlisting для приложений Atlassian Cloud, запросы через Atlassian MCP Server должны исходить с IP-адреса, разрешенного IP-allowlist вашей организации для соответствующего приложения. Подробнее о настройке см. Указание IP-адресов для доступа к продуктам. Ограничения IP для Bitbucket Cloud настраиваются отдельно администраторами рабочего пространства в разделе Workspace settings → Access controls. См. Контроль доступа к приватному контенту в рабочем пространстве.
• Контроль конечных пользователей: Отдельные пользователи могут отозвать свои собственные авторизации приложения из настроек профиля.
• Журнал аудита: Каждый раз, когда инструмент используется через Atlassian MCP Server, событие записывается в журнал аудита вашей организации. Администраторы могут просматривать их в Atlassian Administration в разделе Insights → Audit log (фильтр Rovo MCP User Actions или поиск MCP). Подробнее см. Мониторинг активности Atlassian MCP server.

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

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

  Хостируемые AI-клиенты могут отправлять запросы с исходящих IP-адресов AI-провайдера, а не из корпоративной сети или VPN пользователя. Поэтому нахождение в разрешенном VPN может быть недостаточным. Попросите администратора проверить опубликованные диапазоны исходящих IP-адресов провайдера и одобрить необходимый доступ. Для коннекторов, размещенных на OpenAI, см. Руководство по исходящим IP OpenAI. Локальные MCP-подключения могут использовать исходящий IP-адрес локальной сети. См. как IP-allowlisting работает с Atlassian MCP.

• Вход через OAuth успешен, но вызовы инструментов возвращают 403. Успешный вход не гарантирует, что вызовы инструментов пройдут IP-ограничения. Код 403 также может указывать на недостаточные области, разрешения приложения или другую политику доступа. Подтвердите причину отказа перед изменением IP-allowlist.

---

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

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

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

---

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

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

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

---

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

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

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