Як підключити Jira до Claude Code

Термінал із командою claude mcp add для MCP-сервера Atlassian, з'єднаний із дошкою Jira, задачі якої Claude Code може читати й переводити.

Команда CRUX · · Команди перевірено · 6 хв читання

Найкоротший спосіб підключити Jira до Claude Code дає офіційний віддалений MCP-сервер Atlassian: виконайте в терміналі claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp. Потім у Claude Code запустіть /mcp і ввійдіть в Atlassian у браузері, і Claude Code працюватиме в Jira з вашими правами. Сервер зроблено для Jira Cloud, тож для Jira Server чи Data Center потрібен інший шлях.

Як підключити Jira до Claude Code?

Заздалегідь потрібні три речі:

  • Сайт Atlassian Cloud із Jira. Atlassian описує сервер як хмарний і призначений для застосунків Atlassian Cloud.
  • Акаунт Jira на цьому сайті. Сервер діє з тими правами, які цей акаунт уже має.
  • Браузер, щоб увійти.

Додайте сервер:

claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp

Відкрийте сесію Claude Code, виконайте цю команду, оберіть atlassian і ввійдіть:

/mcp

Claude Code відкриє сторінку згоди Atlassian. Ви входите, переглядаєте доступи й підтверджуєте їх. Вхід іде через OAuth 2.1, тому створювати й вставляти токен не треба. З терміналу той самий вхід запускає claude mcp login atlassian.

Без додаткових прапорців Claude Code зберігає сервер лише для вас і лише в поточному проєкті. З --scope user сервер буде доступний у всіх ваших проєктах, а --scope project ділиться ним із командою через файл .mcp.json у корені проєкту. У файлі лежить запис у форматі Claude Code:

{
  "mcpServers": {
    "atlassian": {
      "type": "http",
      "url": "https://mcp.atlassian.com/v2/mcp"
    }
  }
}

Вхід з API-токеном. Для середовищ без браузера Atlassian приймає API-токен. Спершу адмін організації має ввімкнути цей спосіб в Atlassian Administration. Токен зі скоупами ви створюєте на id.atlassian.com і надсилаєте в заголовку Authorization: Basic <base64(email:api_token)>. У Claude Code заголовок задає прапорець --header команди claude mcp add. Atlassian попереджає, що з токеном інструментів може бути менше, а сам токен не прив'язаний до одного сайту.

Що контролює адмін. Адмін організації може заблокувати домени ШІ-інструментів, які підключаються через OAuth, а якщо в організації є IP-список дозволених адрес, запити мають надходити з адреси в ньому. Якщо вхід пройшов, а виклики інструментів падають, спитайте адміна про ці два налаштування.

У старіших інструкціях трапляється адреса https://mcp.atlassian.com/v1/sse. Atlassian припинила її підтримку після 30 червня 2026 року.

Як перевірити, що підключення працює?

У терміналі:

claude mcp list

Біля кожного сервера стоїть статус: ✔ Connected, ! Needs authentication або ✘ Failed to connect. У сесії команда /mcp показує, скільки інструментів сервер віддав Claude Code.

Далі попросіть щось зі своєї Jira. Atlassian радить такий запит:

List my Jira issues.

Якщо у відповіді ваші задачі, підключення працює. Якщо результат порожній, Atlassian радить увійти ще раз і перевірити, які скоупи ви підтвердили.

Що Claude Code уміє в Jira після цього і чого не вміє?

З типовими групами інструментів Claude Code може:

  • читати задачу, її коментарі, історію змін, зв'язки, вкладення й доступні переходи;
  • шукати задачі через JQL;
  • читати дошки, спринти й беклог;
  • створювати й редагувати задачі, додавати й редагувати коментарі;
  • переводити задачу в інший статус через перехід;
  • зв'язувати задачі, завантажувати вкладення й керувати спринтами.

У цих інструментах Jira називає задачу "work item".

Обмеження:

  • Інструменти, що видаляють задачі, коментарі та вкладення, типово вимкнені. Так само вимкнені інструменти, що створюють і змінюють проєкти, читають воркфлоу й редагують екрани. Вмикає їх адмін.
  • Claude Code бачить і змінює лише те, що дозволено вашому акаунту Jira.
  • Інструменти Atlassian для пошуку й контексту по всіх продуктах витрачають кредити Rovo зі спільного пулу організації.
  • Atlassian просить підтверджувати дії з великими наслідками самостійно, бо мовні моделі вразливі до prompt injection.
  • Сервер дає агентові інструменти. Він не повідомляє агентові, хто у вашій команді відповідає за статус і що має бути готово, перш ніж задача піде далі.

Що робити, якщо з'єднання постійно рветься?

Claude Code сам оновлює вхід і кілька разів пробує заново підключити віддалений сервер. Якщо цього мало:

  • Відкрийте /mcp, оберіть atlassian і натисніть Re-authenticate, або виконайте в терміналі claude mcp login atlassian.
  • Виконайте /mcp reconnect all, щоб заново підключити всі сервери (Claude Code 2.1.284 і новіші).
  • Перевірте скоупи, які ви підтвердили. Для простроченого чи завузького токена Atlassian радить увійти ще раз і перевірити надані скоупи.

З тим самим стикалися й інші на Atlassian Community: The MCP Auth expires too fast, Unstable Atlassian MCP Server Connection і Atlassian MCP Integration with Claude Completely Stopped Working. У цих гілках описано сесії, що завершуються приблизно за пів години, і помилки після оновлення токена.

Чи працює це з Jira Data Center?

Документація Atlassian описує сервер як хмарний і призначений для застосунків Atlassian Cloud. Згадки про Server чи Data Center ми там не знайшли. У публічному трекері Atlassian є відкрита пропозиція зробити MCP-сервер для Data Center, JRASERVER-78874, зі статусом "Gathering Interest". Для Data Center існують MCP-сервери спільноти.

Claude Code чи застосунок Claude?

Claude Code працює у вашому терміналі, і підключає його claude mcp add. У застосунку Claude (claude.ai і Claude Desktop) той самий сервер з'являється як конектор: Atlassian публікує власний конектор Atlassian, а довідка Anthropic пояснює, як користуватися конекторами.

Конектор, доданий у claude.ai, з'являється і в Claude Code, якщо ви ввійшли в Claude Code тим самим акаунтом claude.ai. Якщо сервер додано ще й через claude mcp add, перевагу має він, а /mcp показує конектор як прихований.

Що змінюється, коли так роблять троє чи більше людей?

Одному розробникові описаного вище досить. Коли людей троє, з'являються чотири ситуації.

За статус ніхто не відповідає. Задача стоїть у "Plan". Розробник думає, що крок планування запускає PM, а PM думає, що розробник. Кожен може попросити Claude Code перевести задачу, і ніде не записано, хто це затверджує.

У кожного розробника свої промпти. Один спершу просить в агента план. Інший одразу просить код. Однакові задачі дають різний результат залежно від того, хто їх запускав.

Відповіді лишаються в чаті. QA відповідає на питання агента про граничний випадок у сесії розробника. У Jira цієї відповіді немає, тож наступна сесія питає те саме.

Не видно, хто на кого чекає. Одна сесія чекає на відповідь PM, друга на ревю. Jira показує обидві задачі як "In progress".

Як командну частину вирішує CRUX?

CRUX робимо ми, тож тут ідеться про наш власний продукт. Він у беті.

Те, що агентові треба знати про проєкт, уже є в Jira: задача, її батьківська задача і рішення, які вже в ній записано. CRUX дає агентові це прочитати, а кожен статус у вашому воркфлоу має власні інструкції, тож промпт ніхто не пише. CRUX це шар воркфлоу між трекером команди та агентами для коду, якими команда вже користується. Про Jira можна сказати таке:

  • Підтримується лише Jira Cloud.
  • Кожен учасник підключає власний акаунт Jira через OAuth. Бот-акаунта немає.
  • Кожен статус Jira, який охоплює воркфлоу, має роль-власника.
  • Кожен крок запускає людина, і вона ж затверджує результат у контрольних точках погодження.
  • Агент може перевести задачу лише переходом, який Jira дозволяє цій людині.
  • Кожен крок публікує свій артефакт коментарем до задачі, де його читають PM і QA.

Подробиці є на сторінці Воркфлоу для Claude Code і Codex у команді, що працює в Jira Cloud.

Коли досить звичайного MCP-сервера?

  • Ви працюєте самі, або кожен розробник бере задачі, яких більше ніхто не торкається.
  • Задачі дрібні, і погодження від PM чи QA їм не потрібне.
  • Агент має прочитати задачу й написати коментар, а статуси ви переводите самі.
  • Команда вже домовилась, хто запускає і хто затверджує кожен крок, і тримає спільні промпти в репозиторії.

Питання

Чи потрібен адмін Jira, щоб підключити Claude Code до моїх задач?

Для входу через OAuth документація Atlassian не називає жодного кроку адміна. Адмін потрібен, щоб дозволити API-токени, ввімкнути інструменти видалення й роботи з проєктами, розблокувати домен чи IP-адресу.

Чи безкоштовний MCP-сервер Atlassian?

На сторінках Atlassian не сказано, у які тарифи він входить. Там сказано, що інструменти пошуку й контексту по всіх продуктах витрачають кредити Rovo зі спільного пулу організації.

Чи може Claude Code закривати чи переводити мої задачі в Jira?

Він може перевести задачу будь-яким переходом, який дозволено вашому акаунту. Видалення задач вимкнене, доки адмін не ввімкне інструменти видалення.

Спробуйте на своєму проєкті. CRUX безкоштовний для однієї людини, картка не потрібна.

Почати безкоштовно

Далі: Як підключити Linear до Claude Code

Див. також: Інтеграція Jira для команд на Claude Code і Codex

Усі статті