Інтеграція Jira для команд на Claude Code і Codex
Оновлено
Щоб команда працювала з Claude Code чи Codex і Jira, підключіть проєкт Jira Cloud до CRUX, а агента кожного розробника підключіть до CRUX через MCP. Тоді кожен статус Jira отримує роль-власника і крок для агента, кожен крок запускає людина, а люди затверджують у контрольних точках.
Потрібно лише підключити Jira до Claude Code для себе? Для цього досить MCP-сервера Atlassian, налаштування є в його інструкції для початку.
Чого бракує, коли агент має лише доступ до задач
Розробник підключає до Claude Code MCP-сервер для Jira і просить агента зробити задачу. Агент не знає, що в понеділок команда домовилась у коментарі до сусідньої задачі залишити старий API, тому переписує його.
Звичайний MCP-сервер для Jira дає агентові доступ до задач, і одному розробникові на дрібних задачах цього часто досить. Як така схема виглядає поруч із CRUX, описано на сторінці Jira MCP і власні skills.
Як підключити Jira Cloud
- Створіть проєкт. Створіть у CRUX організацію і проєкт, оберіть трекером Jira Cloud. Адмін вашої організації в CRUX підключає Jira один раз. Один проєкт у CRUX прив'язаний до одного проєкту Jira.
- Підключіть свій акаунт Jira. Кожен учасник підключає власний акаунт Jira на сторінці «Підключені акаунти» через OAuth-застосунок CRUX в Atlassian. Застосунок просить доступи
read:jira-work,write:jira-work,read:jira-userіoffline_access, а також гранулярні доступи до задач, проєктів, дошок, спринтів і JQL. Адмінських доступів на запис він не просить. Якщо в Atlassian Administration увімкнено "Block user apps", спершу застосунок має дозволити адмін, і CRUX дає готове повідомлення, яке можна йому надіслати. - Підключіть агента. Відкрийте в дашборді діалог «Підключіть свого кодинг-агента» і створіть персональний токен. Тримайте його у змінній середовища
CRUX_MCP_TOKEN. Діалог дає налаштування для Claude Code, Codex, Cursor та інших MCP-клієнтів. - Налаштуйте воркфлоу. Адмін проєкту запускає
/crux:crux-configу Claude Code, і для цього потрібен MCP-сервер CRUX із кроку 3. Агент читає статуси проєкту, а потім питає, хто відповідає за кожен і де мають бути контрольні точки. Якщо до проєкту підключено репозиторій коду, агент відкриває pull request з воркфлоу. Якщо репозиторію немає, CRUX імпортує воркфлоу напряму. Без Claude Code оберіть у дашборді «Почати із шаблону» або «Зібрати з моєї дошки». - Запустіть крок. У Claude Code виконайте
/crux:crux-run KEY-12 planner, де вказано ключ задачі в Jira та ім'я агента. У Codex та сама команда пишеться як$crux:crux-run KEY-12 planner.
Команда для Codex із діалогу:
codex mcp add crux --url https://crux.team/mcp/p/<projectId> --bearer-token-env-var CRUX_MCP_TOKENЯк статуси Jira відповідають крокам воркфлоу
Так виглядає шаблон, з якого починає новий проєкт. Під час налаштування ви зіставляєте його статуси з дошкою Jira і змінюєте ролі та агентів.
| Статус | Роль-власник | Агент | Артефакт кроку |
|---|---|---|---|
| To Do | PM | refiner | критерії приймання |
| In Progress | Developer | planner | план реалізації |
| In Review | Developer | reviewer | звіт рев'ю |
| Done | PM | немає | немає |
Крок запускає людина в ролі власника. Люди затверджують у контрольних точках, зазвичай це розуміння задачі агентом, його план і результат. У наступний статус задачу переводить людина.
Воркфлоу Claude Code і Jira крок за кроком
Ось одна задача, KEY-12 «Експорт рахунків у CSV», на шаблоні вище.
- To Do. Емма, PM, запускає в Claude Code
/crux:crux-run KEY-12 refiner. Агент читає задачу й коментарі, питає її про незрозуміле і складає критерії приймання. Емма їх затверджує, агент публікує їх коментарем до KEY-12, і вона переводить задачу в In Progress. - In Progress. Раян, розробник, запускає
/crux:crux-run KEY-12 planner. Агент читає критерії приймання і складає план реалізації. Раян затверджує план, той з'являється коментарем у KEY-12, і Раян робить зміну зі своїм агентом. Потім він переводить задачу в In Review. - In Review. Сара, інша розробниця, запускає
/crux:crux-run KEY-12 reviewer. Агент звіряє зміну з критеріями і планом і пише звіт рев'ю. Сара його затверджує, і звіт з'являється в KEY-12. - Done. Емма читає три артефакти в задачі і переводить її в Done. Агент тут не працює.
Лише MCP-сервер Atlassian чи разом із CRUX
| Питання | Лише MCP-сервер Atlassian | Разом із CRUX |
|---|---|---|
| Хто запускає крок | Кожен розробник, зі своїм промптом | Людина в ролі власника статусу, з інструкціями цього кроку |
| Де лишається відповідь агента | У чаті цього розробника | У коментарі Jira, затвердженому людиною |
| Хто переводить статус | Розробник або агент, якщо його попросили | Людина |
| Що бачить PM | Задачу і те, що хтось напише у відповідь | Критерії, план і рев'ю в задачі |
Що агент читає і що може змінювати
Агент читає задачу, її батьківську й дочірні задачі, усі коментарі, вкладення і зв'язки. Він бачить статуси й спринти проєкту і шукає задачі, зокрема за мітками. Серед коментарів є артефакти попередніх кроків, кожен із яких схвалила людина.
Агент на вашій машині читає вікі проєкту з локальної копії репозиторію, а не через MCP.
Агент може створювати й оновлювати задачі, додавати коментарі та зв'язки, завантажувати вкладення. Статус або оцінку він має змінювати лише тоді, коли ви про це просите. Перевести задачу він може лише прямим переходом, який Jira пропонує вам із поточного статусу. Інакше виклик завершується помилкою STATUS_TRANSITION_UNAVAILABLE, і в ній перелічено статуси, до яких задача може перейти. Щоб видалити задачу, агент спершу отримує попередній перегляд, а потім підтверджує видалення другим викликом. У Jira разом із задачею видаляються і її підзадачі.
Кожен крок публікує свій артефакт коментарем до задачі в Jira. Текст, який написав агент, починається з емодзі робота 🤖.
Обмеження
- CRUX підтримує лише Jira Cloud, а Jira Server і Data Center не підтримує.
- CRUX працює лише як хмарний сервіс.
- Бот-акаунта немає. Агент діє від імені людини, яка його запустила.
- CRUX не змінює налаштувань вашої Jira.
- CRUX у беті, і робить його один засновник.
Наступний крок
Почати безкоштовно. Для однієї людини CRUX безкоштовний. Команда від 2 до 10 людей платить $49 за активний проєкт на місяць, а перший місяць кожного проєкту безкоштовний. Поки триває бета, білінг не ввімкнено, тож нічого не списується. Подробиці на сторінці цін.
У статті Підключіть свого кодинг-агента до CRUX є налаштування для кожного клієнта.
Питання
Чи працює CRUX із Jira Server або Data Center?
Ні. Jira Server і Data Center CRUX не підтримує, лише Jira Cloud.
Чим CRUX відрізняється від MCP-сервера для Jira?
MCP-сервер для Jira дає агентові доступ до задач. CRUX додає інструкції для кроку, що відповідає статусу задачі, ролі-власників, контрольні точки й артефакти в коментарях Jira.
Чим CRUX відрізняється від того, щоб призначити задачу Claude Agent for Jira або Jira Coding Agent?
У Claude Agent for Jira людина призначає задачу на Claude або згадує його в коментарі, і Claude відкриває чорновий pull request у GitHub. У Jira Coding Agent людина призначає задачу на нього і працює з ним у чаті сесії, перш ніж створити pull request. Обидва доводять задачу до pull request. У CRUX кожен крок запускає людина у своєму кодинг-агенті, а люди затверджують розуміння задачі агентом, його план і результат. Докладніше ці продукти порівнює сторінка Агенти «задача в PR». Перевірено 13 листопада 2026 року.
Чи можна запустити Claude Code із задачі в Jira?
Кожен крок запускає людина. У Claude Code вона виконує /crux:crux-run із ключем задачі в Jira та ім'ям агента, і агент читає цю задачу з Jira.
Чи працюють із цими задачами Codex і Cursor?
Так. Codex запускає ті самі кроки через $crux:crux-run, а Cursor підключається до MCP-сервера CRUX, як будь-який MCP-клієнт. /crux:crux-config працює лише в Claude Code; без нього налаштуйте воркфлоу в дашборді. Налаштування для кожного є в статті Підключіть свого кодинг-агента до CRUX.
Чи може агент сам перевести задачу в інший статус?
Йому сказано цього не робити. Задачу переводить людина або просить про це агента. Навіть тоді агент може скористатися лише переходом, який Jira пропонує цій людині.
Інші трекери
CRUX також працює з Linear, Plane і GitHub Issues.