Atlassian Teamwork Graph CLIをCodexに接続する方法？2026年チュートリアル

Codex CLIでリポジトリ作業を行い、JiraやConfluenceの背景を参照させたい開発者向けです。
権限管理を担うプラットフォーム担当者や、AI Coding Agentの実行環境まで確認したいチームにも役立ちます。

最終更新：2026年10月8日。日付と発表内容はOpenAIの協業発表、設定と権限はAtlassian公式資料で照合しています。

1発表済みの協業と、今使えるCLI接続は別に確認する

OpenAIとAtlassianは2026年10月6日に協業拡大を発表し、GPT-6シリーズのAtlassianプラットフォームへの導入、関連プラグインを通じたCodexユーザーのプロジェクトコンテキスト取得、Jiraとのより深い連携の検討を公表しました。発表内容では、検討中の連携と提供済みの機能を分けて読む必要があります。

この発表だけを根拠に、Teamwork Graph CLIの権限が変わった、新しいJira機能が全利用者に開放された、と判断することはできません。Teamwork Graph CLIは協業発表とは別の接続経路です。使える機能、インストール方法、認証条件は、作業時点のCLI導入資料と公式の設定説明を確認してください。

2作業前の比較：CLI、skills、認証は役割が異なる

Teamwork Graphは業務情報のコンテキストを扱う仕組み、CLIはその情報にアクセスする実行手段、Codex skillsはAgentが利用方法を理解するための設定要素です。ログインはさらに別の層で、実際に取得できる情報は認証したアカウントと権限に左右されます。公開プラグインリポジトリとAgent skillsの公式説明を照合し、それぞれの役割を混同しないでください。

CLIとMCPの選択では、名称や「接続できる」という説明だけで判断せず、利用環境との適合性をAtlassian公式の選定ガイドで確かめてください。

3接続までのタイムライン：環境確認から読み取り検証へ

第一段階：Codex、作業アカウント、対象タスクをそろえる

まずCodex CLIを使う端末環境と、Atlassianにログインする業務アカウントを確認します。組織でCLIや対象サイトへのアクセスが許可されているとは限らないため、管理者に利用可否を確認してから進めてください。

検証用タスクには、参照してよい課題や文書を一つ選び、期待する情報を記録します。最初からコード変更や書き込みを依頼せず、課題の要点や関連資料を読み取れるかを調べるのが安全です。

第二段階：公式手順に従ってCLIとskillsを設定する

Teamwork Graph CLIの導入資料を開き、使用環境に該当する最新のインストール手順を確認します。コマンドや保存先は古い教程から転記せず、資料に記載されたものを使ってください。

その後、公開プラグインリポジトリとAgent skillsの設定資料を参照し、Codexで使う構成を整えます。プラグイン、CLI実行ファイル、ユーザー認証は別々の要素です。どれか一つを導入しただけで、残りも完了したとみなさないでください。

第三段階：ログインとアクセス範囲を検証する

公式の認証の仕組みに沿ってログインし、どのアカウントが認証されているか、想定したAtlassianサイトを参照しているかを確かめます。次に、権限設定の説明を確認し、管理者が許可した範囲と実際の照会結果を比較してください。

課題、文書、関連するコード協業情報をそれぞれ読み取り専用で尋ね、回答がどの元資料に基づくかを照合します。Teamwork Graphがユーザーの既存権限を越えて情報を見せる、と想定してはいけません。

• [ ] 認証中のアカウントと対象サイトが想定どおりです。
• [ ] 管理者にCLIと対象データへのアクセス可否を確認しました。
• [ ] 読み取り専用の問いで、参照元となる課題や文書を確認しました。
• [ ] Codexの回答とAtlassian上の元資料に食い違いがないか照合しました。
• [ ] 不一致があればコード変更を止め、認証と権限設定を見直します。

認証に成功したことは、必要なデータがすべて見える証明ではありません。期待した資料が返らないときは、Agentへの指示を増やす前に、ログイン先と管理者側の権限設定を調べてください。

第四段階：小さなコーディング作業で出典と成果を分けて確かめる

読み取り結果が妥当なら、影響範囲を限定したコード作業に進みます。Codexが参照した要件、判断、コード協業資料を元資料と突き合わせ、作業指示にない変更を加えていないか確認してください。

ここでは「資料を検索できた」「コードを変更した」「テストを実行した」「成果物を受け入れた」を別々に扱います。CLIが接続できても、ビルドやテストの完了が保証されるわけではありません。iOSやmacOSの案件では、実際のビルドにmacOSとXcodeが必要かを別途判断します。

4FAQ：設定・参照範囲・方式選定の確認

Teamwork Graph CLIをCodexで使うには、何から設定しますか？

Atlassian公式のCLI導入手順で、利用環境に合うインストール方法と初期設定を確認します。次に公開プラグインとAgent skillsの説明に沿ってCodex側を設定し、公式の認証手順でログインします。コマンドや保存先は更新される可能性があるため、古い記事の記述を流用せず、実行時点の公式資料と照合してください。

CodexからTeamwork Graph経由で見える情報は何ですか？

参照できる範囲は、接続設定や対象サイトに加え、ログインしたアカウントが持つ権限に左右されます。Jira、Confluence、Bitbucketの情報が常にすべて取得できるとは限りません。対象の課題や文書を一つずつ照会し、Agentの回答に示された内容を元資料と照合して、実際に見える範囲を確かめてください。

Teamwork Graph CLIとAtlassian MCPは、どのように選び分けますか？

CodexでTeamwork Graph CLIと対応するAgent skillsを使いたい場合は、CLI側の導入条件とサポート範囲を確認します。MCPを含め複数の接続方式を検討する場合は、Atlassian公式の選定ガイドで、利用するクライアントや運用要件に合う方式を比べてください。名前だけで機能や権限が同じだと判断しないことが重要です。

Codexが使うAtlassianの情報に、既存のアクセス権は適用されますか？

Teamwork Graph CLIを接続しただけで、ユーザーが持たない権限を得られるわけではありません。認証中のアカウント、対象サイト、管理者が設定したアクセス範囲を確認し、許可のない課題や文書が取得されないことも検証してください。結果に不一致があれば、書き込みやコード変更へ進まず、認証と権限設定を見直します。

5CLI接続後の実行環境は、作業要件から別に選ぶ

Teamwork Graph CLIを使うこと自体が、クラウドMacや遠隔実行環境を必須にするわけではありません。既存端末で安全に完結でき、Appleのツールチェーンも使わない作業なら、現行環境のままでよい場合があります。一方、長時間動かすAgent、端末から分離した実行環境、Apple向けのビルドや納品確認が必要な案件では、実行場所と復旧方法も設計対象です。

AI Coding Agentの実行環境と権限を整理するときは、Teamwork Graph CLIの接続要件と、コードを実行・検証する環境の要件を別々に記録してください。継続的な遠隔実行やAppleツールチェーンが必要なら、Mac環境の調達方法も比較対象になります。

すでにある端末で短い作業を完結できるなら、新たな環境を借りる必要はありません。ただし、長時間のリモート実行では端末占有や切断後の復旧が負担になり、Apple向けの成果物では対応するビルド環境を別途用意する必要があります。そうした条件が実際にある場合に限り、Codexの接続要件とは切り分けて、vpstixのMacレンタルを検討してください。