Choosing between Teamwork Graph CLI and Atlassian MCP
Teamwork Graph (TWG) CLI and Atlassian MCP server are the two official ways for AI agents to work with Atlassian data via the Teamwork Graph.
これらは、異なるランタイム、認証モデル、ワークフロー図形をターゲットにしています。このページを使用して、どちらをエージェントおよび自動化として使い始めるかを決定してください。
This page will is helpful if you:
are designing or configuring AI agents that need to access Atlassian data.
need to choose between a CLI-based approach and an MCP-based approach.
詳細なセットアップやコマンドのドキュメントが必要な場合は、関連するトピックをご覧ください。
What’s the difference between TWG CLI and Atlassian MCP?
Teamwork Graph (TWG) CLI and Atlassian MCP are both official ways for AI agents to work with Atlassian data via the Teamwork Graph.
これらは相補的なものであり、相互交換できません。
TWG CLI is a command-line, agent-oriented interface (
twg) best suited to shell, CI/CD, OAuth, and deep, graph-style automation.Atlassian MCP is an MCP server that exposes tools to MCP-capable hosts (web LLMs, IDEs, or sandboxes) and personal access tokens (PATs).
どちらのサーフェスも活発に進化しています。カバレッジ、オーケストレーション、ホスト機能の変化に応じて、選択を見直してください。
意思決定ガイド
現在の状況 | 有力な候補 |
|---|---|
ターミナルや CI/CD でエージェントを実行する、またはスクリプト化可能な | TWG CLI |
Web LLM、IDE、またはサンドボックスで信頼性の高いシェル/バイナリを使用せずにエージェントを実行する | Atlassian MCP |
今すぐ OAuth とホストネイティブの MCP 認証パターンが必要である | TWG CLI |
非常に幅広いアトラシアン/グラフスタイルのコマンドの深さが必要である (エンティティを検証してください) | TWG CLI (ご自身のケースのカバレッジをご確認ください) |
Need personal access tokens (PATs) or scoped tokens | Atlassian MCP |
事前に宣言された並列ツールを使用して簡単なタスクのターン数を減らしたい | Atlassian MCP |
早見表
| TWG CLI | Atlassian MCP |
|---|---|---|
概要 | エージェント指向のコマンドライン | MCP 対応の LLM ホストにツールを公開する MCP サーバー |
最適な状況 | Shell, automation, OAuth, deep/broad graph-style workflows | Web LLMs, IDEs, PATs, sandboxed hosts |
coverage | Generally larger Atlassian / graph-oriented surface. Verify your scenario | 厳選されたアトラシアン ツール (設定により、アトラシアン以外のシステムにも拡張可能) |
検出/ターン | Help, flags, examples. Can be slower first run, then repeatable | Tools pre-declared. Often fewer turns for simpler tasks |
トークン | Often more efficient in some flows (no huge catalog every prompt), not universal | ホストとマニフェストに依存 (ロードマップによってトレードオフが変わる可能性がある) |
認証 | OAuth | Tokens (host-dependent) + OAuth |
ランタイム | Not available everywhere (some sandboxes cannot run a CLI) | MCP がサポートされている場合に動作する |
1 つの組織、1 つのセッション、多数のツール
Across the organisation you can use both TWG CLI and Atlassian MCP (different teams or environments).
Within one agent runtime or session, pick one primary surface (TWG CLI or MCP), or always name the surface each time (“Use MCP” / “Use TWG CLI”). Put defaults in
agents.md,claude.md, or your team agent config so behavior is predictable.TWG CLI + Atlassian MCP + RovoDev CLI (or other overlapping sources) in the same profile. Opt for a primary tool unless you have a clear reason not to. If several are installed, explicitly instruct which to use, or use separate profiles (like, MCP-only vs CLI-only) or a documented trigger convention.
どちらをいつ使用するか
TWG CLI を使用する場合
製品全体にわたる幅広いカバレッジ、マルチホップ、またはきめ細かいクエリが必要である (CLI がご自身のエンティティ/アクションをサポートしていることを確認してから)。
エージェントがターミナル、CI/CD、またはその他のシェル対応環境で実行される。
ローカル ツールとの連携、JSON の永続化、または自動化パイプラインの構成を行いたい。
You need OAuth-based access.
Use Atlassian MCP when
Web ベースの LLM、IDE、またはシェル アクセスのないサードパーティ サンドボックスを統合する。
より簡単なタスクでは、ツールのターン数を減らし、事前に宣言されたツールと並列化可能なオーケストレーションを使用したい。
You need personal access token (PATs) access and governance patterns your MCP host supports well.
FAQ
Is TWG CLI basically the same as Atlassian MCP?
No. CLI = shell commands and scripting. MCP = tools exposed via an MCP client directly to the LLM. Complementary, not interchangeable.
We already use Atlassian MCP. What changes if we add TWG CLI?
You add a command-line path for places that can run twg (scripts, automation, pipelines). Everything you already do through MCP stays. This is extra for environments that fit CLI better.
Can we use both in the same org?
Yes. Go to One org, one session, many tools
どちらか一方が常により高速または「優れている」のでしょうか?
No. This depends on task complexity, tool exposure, planning, and product investment. Benchmark your own workflows if needed.
TWG CLI はオフラインですか?
いいえ、必要に応じてクラウド データ/サービスにアクセスするローカル バイナリです。
TWG CLI + Atlassian MCP + RovoDev CLI in one environment?
この内容はお役に立ちましたか?