MCP Atlassian — Установка & Живое демо

Name: MCP Atlassian MCP Server
Author: sooperset

Зачем использовать

Ключевые функции

Jira: JQL-поиск, получение/создание/обновление задачи, переход по статусу, добавление комментария, список workflow
Confluence: поиск страниц, получение контента, создание/обновление страниц, комментарии, вложения
Поддержка Cloud + Server/Data Center
Режим только на чтение для развёртываний с минимальными привилегиями
Фильтры по сайту — ограничение одним проектом/пространством при большом количестве
Транспорт Stdio + HTTP/SSE

Живое демо

Как выглядит на практике

mcp-atlassian-sooperset.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mcp-atlassian-sooperset",
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "mcp-atlassian-sooperset": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-atlassian"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add mcp-atlassian-sooperset -- uvx mcp-atlassian

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

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

Реальные сценарии: MCP Atlassian

Триаж production-ошибки в Jira-тикет с ссылкой на Confluence runbook

👤 Дежурные инженеры ⏱ ~10 min intermediate

Когда использовать: Sentry прислал alert — нужен триажированный Jira-тикет и ссылка на runbook как можно быстрее.

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

API-токены — Atlassian → My Account → Security → API tokens

Поток

Найти связанные задачи

Atlassian: найди задачи в Jira, содержащие «NullPointerException OrderService» за последние 30 дней. Также найди страницы Confluence с runbook для OrderService.✓ Скопировано

→ Оба набора результатов возвращены
Решить: дубль или новая задача

Если за последние 14 дней есть открытый BUG, добавь комментарий с новым стектрейсом. Иначе создай новый BUG, привяжи страницу runbook, установи приоритет High.✓ Скопировано

→ Вызван jira_add_comment или jira_create_issue один раз
Передать

Сообщи мне ключ тикета и краткое описание, чтобы я мог опубликовать в Slack.✓ Скопировано

→ ABC-1234 + однострочное резюме

Итог: Триажированный тикет со ссылкой на runbook менее чем за 2 минуты; без дублирования.

Подводные камни

Стектрейс вставлен в Jira как plain text — теряется форматирование — Оборачивай в маркеры {code}; MCP передаёт как есть
JQL injection через пользовательский ввод — Всегда экранируй строковые параметры; инструмент экранирует, но будь явным

Сочетать с: sentry · github

Сгенерировать еженедельный статус-отчёт из Jira

👤 Tech leads / EM ⏱ ~10 min beginner

Когда использовать: Утро понедельника: нужно сделать сводку того, что вышло и что заблокировано.

Поток

Получить выполненные за прошлую неделю

Atlassian: JQL project = PLAT AND status changed to Done during (-7d, now()) ORDER BY updated DESC✓ Скопировано

→ Список задач с assignee, ключом и описанием
Получить заблокированные

Теперь JQL project = PLAT AND status = Blocked — для каждой суммируй последний комментарий.✓ Скопировано

→ Список заблокированных с резюме последнего комментария по каждой задаче
Составить

Оформи как статус-отчёт на 200 слов, сгруппированный по разделам: Выполнено / Заблокировано / Под угрозой.✓ Скопировано

→ Краткий отчёт готов для вставки

Итог: Статус-отчёт собран за 90 секунд с указанием ключей задач.

Подводные камни

Длинные ветки комментариев раздувают контекст — Используй jira_get_issue с fields=summary,status,assignee только

Создать черновик RFC в Confluence по дискуссии

👤 Инженеры, пишущие дизайн-документы ⏱ ~20 min intermediate

Когда использовать: Обсудили подход в чате; хочется получить страницу в Confluence.

Поток

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

Atlassian: найди пространство «Engineering RFC». Перечисли страницы верхнего уровня.✓ Скопировано

→ Пространство и родительская страница определены
Составить

Создай новую страницу с заголовком «RFC: переход с Redis на Valkey». Разделы: контекст, цели/не-цели, рассмотренные варианты, решение, план. Использую обсуждение выше как исходный материал.✓ Скопировано

→ confluence_create_page возвращает URL

Итог: Черновик RFC готов к ревью.

Подводные камни

Неверный ID родительской страницы — Всегда сначала выполняй confluence_search по пространству

Массово почистить устаревшие тикеты

👤 Engineering managers ⏱ ~30 min intermediate

Когда использовать: В бэклоге 200 «зомби-задач»; нужно их разобрать.

Поток

Определить устаревшие

JQL: project = PLAT AND status = Open AND updated < -90d. Лимит 50.✓ Скопировано

→ Список устаревших задач
Предложить действие

Для каждой предложи: закрыть-как-устаревшую, переназначить-в-триаж или оставить. Показывай по 10 штук перед переходом.✓ Скопировано

→ Рекомендация по каждой задаче; ты одобряешь пачками
Применить

Закрой одобренные с комментарием «закрывается как устаревшая».✓ Скопировано

→ jira_transition_issue + jira_add_comment вызваны для каждой задачи

Итог: Бэклог почищен с audit trail по каждой задаче.

Подводные камни

Автоматическое закрытие реальных, но тихих тикетов — Всегда выполняй пакетное подтверждение перед переходом

Комбинации

Сочетайте с другими MCP — эффект x10

mcp-atlassian-sooperset + sentry

Конвертировать Sentry-ошибки в хорошо оформленные Jira-тикеты

Sentry: получи последнюю критическую ошибку. Atlassian: создай Jira BUG со стектрейсом и ссылкой на Sentry URL.✓ Скопировано

mcp-atlassian-sooperset + github

Автоматически связывать PR с Jira-тикетами

GitHub: найди PR, влитые сегодня. Atlassian: для каждого добавь комментарий к связанной задаче с URL PR.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
jira_search	jql: str, limit?	Любой поиск в Jira	1 API-вызов
jira_get_issue	key: str, fields?	Нужно полное тело одной задачи	1 вызов
jira_create_issue	project, type, summary, description, fields?	Создать новый тикет	1 вызов
jira_transition_issue	key, transition, comment?	Перевести задачу по workflow	1 вызов
jira_add_comment	key, body	Добавить контекст	1 вызов
confluence_search	cql: str	Найти документы	1 вызов
confluence_get_page	id: str	Прочитать содержимое страницы	1 вызов
confluence_create_page	space, parent_id, title, body	Новый документ	1 вызов
confluence_update_page	id, title, body, version	Редактировать документ	1 вызов

Стоимость и лимиты

Во что обходится

Квота API: Atlassian Cloud: 5000 запросов/ч на пользователя/токен (зависит от тарифа)
Токенов на вызов: 300–4000
Деньги: Бесплатный OSS; применяется ваш тарифный план Atlassian
Совет: Используй fields= для уменьшения payload; jira_get_issue по умолчанию тяжёлый

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

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

Минимальные скоупы: read:jira-work write:jira-work read:confluence-content.all write:confluence-content

Хранение учётных данных: API token в переменной окружения; ротация через My Account

Исходящий трафик: Только ваш экземпляр atlassian.net (или self-hosted)

Никогда не давайте: site-admin

Установи READ_ONLY_MODE=true, если Claude не должен иметь возможность мутировать данные; покрывает все инструменты записи

Устранение неполадок

Частые ошибки и исправления

401 Unauthorized

Токен просрочен или неверный логин (для Cloud обязательно email)

Проверить: curl -u email:token $URL/rest/api/3/myself

Ошибка парсинга JQL

Экранируй строковые значения в кавычки, экранируй спецсимволы; проверяй в UI Jira заранее

Forbidden при создании в пространстве

Пользователь токена не имеет прав «Add page» в этом пространстве

Rate limit 429

Включи backoff; уменьши параллельный fanout; проверь лимит Atlassian на токен

Проверить: X-RateLimit headers

Альтернативы

MCP Atlassian в сравнении

Альтернатива	Когда использовать	Компромисс
Официальный MCP Atlassian (Cloud)	Используешь только Cloud и хочешь OAuth	Новее, но более узкий набор инструментов; не покрывает Server/DC
Linear MCP	Используешь Linear, а не Jira	Другая система; быстрее и чище, но нет аналога Confluence

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills