Как подключить Atlassian Teamwork Graph CLI к Codex? Руководство 2026

Материал пригодится разработчикам, которые хотят давать Codex контекст из Jira, Confluence и других рабочих источников.
Платформенным инженерам и администраторам, которым нужно проверить личность пользователя, область доступа и отзыв разрешений.
Командам AI Coding, оценивающим подключение контекста и отдельную среду исполнения кода.

Последнее обновление — 8 октября 2026 года; дата объявления и границы планов сверены с сообщением OpenAI о расширении сотрудничества, а настройка — с документацией Atlassian по CLI, skills, аутентификации и разрешениям.

16 октября: объявление — не изменение прав

В объявлении от 6 октября 2026 года OpenAI и Atlassian сообщили о расширении сотрудничества. В числе подтверждённых направлений названы модели серии GPT-6 на платформе Atlassian и доступ пользователей Codex к проектному контексту через соответствующие плагины. Стороны также упомянули изучение более глубокой интеграции с Jira. Эти три пункта не следует сводить к одному: анонсированное направление, доступная интеграция и функция, которую ещё исследуют, — разные статусы. Само объявление не подтверждает, что всем организациям уже доступна одинаковая конфигурация или что изменились полномочия CLI.

Для подключения здесь важен отдельный путь: Teamwork Graph CLI, исполняемый инструмент командной строки, и материалы для Agent, в том числе Codex skills. CLI отвечает за взаимодействие с графом рабочих данных, skills дают Agent инструкции о том, как пользоваться возможностями, а вход определяет, от чьего имени выполняются запросы. Ни одно из этих звеньев само по себе не доказывает, что запросу разрешён доступ к нужному пространству или проекту.

Именно поэтому не переносите обещание о сотрудничестве в эксплуатационное решение. Пока официальные документы не подтверждают доступность конкретной функции в вашей организации, считайте её недоступной для планирования релиза. Сведения о CLI и способ установки сверяйте с руководством Atlassian по началу работы с Teamwork Graph CLI, а детали расширения для Codex — с публичным репозиторием плагинов.

2До установки: зафиксируйте задачу и среду

Сначала определите, что Codex должен получить из рабочего контекста и что ему разрешено сделать в репозитории. Не начинайте проверку с просьбы «разберись во всём проекте»: без ожидаемого результата такая формулировка затрудняет оценку полноты поиска, а при наличии инструментов изменения кода смешивает чтение и выполнение.

Выберите один конкретный сценарий, для которого можно заранее записать ожидаемые источники. Например, попросите найти требование из определённой задачи Jira, связанное с ним решение в Confluence и, если доступно, относящийся к работе контекст совместной разработки. Заранее укажите допустимый результат: краткое резюме со ссылками или идентификаторами источников, без редактирования задачи, страницы и файлов репозитория. Такой запрос одновременно проверяет, что нужные данные видны, и снижает риск принять предположение Agent за найденный факт.

До установки проверьте на официальной странице, какая терминальная среда нужна для выбранного способа запуска, как в ней предполагается использовать Codex CLI и как организации выдают доступ к Atlassian. Не подставляйте команды из старой заметки, если текущая документация предлагает другой путь или иной порядок инициализации. Зафиксируйте для пилота используемую учётную запись, нужный Atlassian-сайт, тестовый проект и ожидаемые источники. Если администратор ещё не подтвердил доступ, сначала запросите подтверждение, а не пытайтесь обойти ограничение другой учётной записью.

Практическая граница здесь существенна: доступность терминала на компьютере не гарантирует доступ к корпоративным данным, а авторизация в сервисе не означает, что учётной записи разрешены все проекты организации. Отдельно оцените, должен ли Codex только читать контекст или также изменять файлы, запускать тесты и создавать результаты для передачи команде. Эти режимы требуют разных критериев приёмки. Если для проверки потребуется отдельная или восстанавливаемая среда исполнения, изучите материалы vpstix о доступных вариантах работы с Mac, но не считайте их заменой документации Atlassian по разрешениям.

3Установка: CLI отдельно, skills отдельно

Следуйте актуальной официальной инструкции по установке Teamwork Graph CLI. Сначала проверьте заявленные там требования к терминалу и выбранной конфигурации, затем выполните приведённые в документации действия и убедитесь, что исполняемый файл доступен именно в той среде, где запускается Codex. Не добавляйте параметры или переменные окружения из сторонних примеров, пока не подтвердите их назначение и соответствие текущей версии инструкции.

Затем отдельно настройте Agent skills. В официальном описании Agent skills Atlassian проверьте, какой способ установки и расположение файлов актуальны для вашего клиента. Сопоставьте это с текущим содержимым репозитория плагинов: он показывает опубликованные материалы и структуру плагинов, но сам факт наличия файлов не означает, что нужная версия уже установлена или активирована в вашем Codex.

Запускайте каждый шаг в том же пользовательском профиле и терминальном окружении, из которых будет работать Agent. Иначе можно установить CLI для одного пользователя, а Codex запустить под другим; внешне инструменты будут присутствовать, но Agent не найдёт ожидаемые файлы настроек или учётные данные. После установки проверьте наличие CLI и корректное обнаружение skills без запроса на изменение данных. Если официальная инструкция предусматривает отдельную команду диагностики, используйте именно её и не заменяйте похожей командой из предыдущей версии.

Это не три взаимозаменяемые кнопки. CLI — исполняемый инструмент, skills — инструкции для Agent, а MCP — отдельный способ организации доступа к инструментам. Выбирайте по требованиям к управлению и эксплуатации, а не по названию интеграции: в официальном руководстве Atlassian по выбору между CLI и MCP сравниваются именно эти варианты. Для первого теста не устанавливайте оба пути одновременно, если не можете независимо определить, какой из них обслужил конкретный запрос.

Важно: команды установки и каталог для skills намеренно не приведены как универсальный набор. Их источник — актуальная версия официальной инструкции и репозитория, а не предположение о том, что структура файлов и команда инициализации останутся неизменными.

4После установки: вход и проверка полномочий

Выполните вход так, как предписывает описание аутентификации Teamwork Graph CLI. Проверьте, какой пользователь авторизован и какой Atlassian-сайт выбран. Если документация предусматривает браузерную авторизацию, локально сохраняемые данные или повторный вход после истечения сессии, учитывайте эти детали при настройке рабочей станции и процессе отзыва доступа. Не передавайте секреты Agent в текстовом запросе и не помещайте их в файл репозитория.

После входа проведите контроль не по формулировке ответа Agent, а по фактическому содержимому. Попросите Codex найти известную вам задачу и сообщить её идентификатор, название и источник. Затем проверьте, что найденное соответствует тому, что видит эта же учётная запись при обычной работе с Atlassian. Повторите проверку для ожидаемого документа Confluence и, если это предусмотрено доступом и задачей, для контекста совместной работы с кодом. Если источник недоступен, зафиксируйте это как границу доступа, а не просите Agent «поискать обходной путь».

Уточните, кто управляет разрешениями и где их можно изменить. В документации Atlassian по настройке разрешений проверьте, как настраивается доступ для CLI и какие ограничения применяются. Если для изменения политики нужны полномочия администратора, не делайте выводов о доступе всей организации по успешной проверке одного пользователя.

Проверка должна различать три вопроса: под кем выполнен запрос, какие источники видимы этому пользователю и на какие действия у интеграции есть разрешение. Само наличие Teamwork Graph не является основанием считать, что он расширяет исходные права учётной записи. Организуйте контроль по принципу наименьших необходимых полномочий: предоставьте только тот доступ, который нужен для пилотного сценария, а после проверки удалите или сузьте ненужные разрешения по процедуре вашей организации.

5Первый запрос: от поиска к изменению кода

Когда авторизация подтверждена, используйте тестовую задачу с известным результатом. Попросите Codex извлечь требования и связанный контекст, перечислить первичные источники и разделить подтверждённые сведения от выводов. Сверьте каждую существенную ссылку с оригиналом в Atlassian. Если ответ пересказывает нужный документ, но не указывает, откуда взята формулировка, это ещё не подтверждение корректной работы с контекстом.

Затем отдельно проверьте, что Agent умеет удерживать контекст при работе с кодом. Попросите его предложить план изменений, но на первой проверке не разрешайте автоматически выполнять запись, если права и границы репозитория ещё не протестированы. Сопоставьте план с требованием и решением из Atlassian, проверьте, не добавил ли Agent собственные предположения, и только затем разрешайте редактирование в контролируемой ветке или другой предусмотренной вашей командой рабочей области.

Приёмку разбивайте на самостоятельные этапы:

• поиск информации в Atlassian и корректная ссылка на источник;
• формирование плана изменения без подмены требования догадкой;
• фактическое редактирование файлов и просмотр diff;
• запуск предусмотренных проектом проверок;
• передача результата с перечнем изменённых файлов, проверок и оставшихся ограничений.

Успешный поиск не доказывает, что изменение кода корректно. Успешный запуск теста не доказывает, что Agent опирался на актуальные требования. И наоборот, корректное резюме документа не доказывает, что в этой среде вообще можно собрать или протестировать проект. Поэтому храните результаты этих проверок раздельно и обозначайте статус каждого этапа явно.

Отдельная граница возникает в проектах для iOS и macOS. Подключение Teamwork Graph CLI не предоставляет само по себе среду macOS, Xcode или возможность выполнить сборку с необходимыми инструментами Apple. Если задание включает сборку, тестирование или выпуск такого проекта, проверьте отдельно, нужна ли ему реальная среда macOS и доступность Xcode; не отмечайте задачу выполненной только потому, что Codex получил описание требований и подготовил diff.

6Контрольный список перед расширением доступа

Используйте список как условие перехода от пилота к рабочему процессу. Если хотя бы один пункт не подтверждён, оставьте доступ в тестовом масштабе и сначала устраните неопределённость.

• [ ] CLI установлен по актуальной инструкции в том окружении, где реально запускается Codex.
• [ ] Skills обнаруживаются Codex, а их происхождение и предназначение проверены по официальной документации и репозиторию.
• [ ] Зафиксированы учётная запись и Atlassian-сайт, использованные при входе.
• [ ] Результаты запросов сверены с первичными источниками, доступными этой учётной записи.
• [ ] Для первого запроса задан режим чтения и заранее определены ожидаемые задача, документ и контекст.
• [ ] Отдельно проверено, какие действия разрешены: чтение, изменение файлов и выполнение команд не считаются одним полномочием.
• [ ] Понятно, кто может изменить и отозвать доступ CLI, а также как команда проверит результат отзыва.
• [ ] Для сборки и тестирования определена среда исполнения, независимо от того, подключён ли Atlassian-контекст.

Последний пункт особенно важен при долгих задачах: Agent может получить достаточную информацию о проекте, но потерять рабочую среду, доступ к репозиторию или незавершённый результат при перезапуске. До запуска таких задач определите, как восстанавливаются файлы, логи и состояние выполнения, и отделите эти требования от интеграции с Atlassian. Для сценария с удалённой средой заранее проверьте порядок подключения, хранения результатов и завершения работы; запросы к рабочему контексту и запуск кода могут происходить в разных средах. Teamwork Graph CLI сам по себе не означает, что Codex должен работать на удалённом Mac.

7Решение о запуске

Начинайте пилот, если официальные инструкции подтверждают доступность выбранного способа для вашей конфигурации, администратор понимает границы разрешений, а команда может сравнить вывод Codex с оригиналами. Для расширения доступа требуйте не просто удачного ответа, а повторяемой проверки идентичности, источников, действий Agent и процедуры отзыва полномочий. Если этих условий нет, безопаснее оставить тест на чтение или отложить интеграцию, чем строить рабочий процесс на предположении о новых возможностях после объявления.

Сравните и среду исполнения. Локальный запуск удобен, если у разработчика уже есть нужные инструменты и команда принимает соответствующие требования к рабочей станции; собственный сервер имеет смысл, когда вы готовы отвечать за изоляцию, обновления и сохранность среды; сторонняя облачная среда может снять часть задач по поддержке, но требует отдельной проверки доступа, восстановления и соответствия требованиям проекта. Ни один вариант не следует выбирать только потому, что подключён Atlassian-контекст.

Если задача ограничивается поиском требований и изменениями в обычном репозитории, аренда Mac может быть избыточна. Но когда команде нужен временный удалённый исполнитель для задач, завязанных на macOS или Xcode, постоянная локальная машина может означать неиспользуемые ресурсы, обслуживание и трудности с передачей среды между исполнителями. В таком случае варианты аренды Mac у vpstix позволяют оценить удалённый сценарий без покупки оборудования; сначала подтвердите, что проекту действительно требуется среда Mac, а затем отдельно проверьте доступ, сохранение результатов и требования к сборке.