AWRでは、複数の人 —— と彼らが一緒に働くエージェント —— が1つの共有プロジェクトで調整できます。 全員が同じタスクを見て、自分が行う作業にクレームを取り、進めながら進捗を報告し、完成した作業を独立した レビュアーに渡します。これらはすべて、いつものエージェント会話から操作できます。ブラウザでタスクIDを コピーして回る必要はありません。
利用可能性: この記事が説明するTeamサービスは、まだ開発中です。公開された0.5.0のパーソナルMCP サーバーには含まれていません。以下の機能は、プロジェクト管理者がホストするチームプロジェクトに適用 されるもので、個人のローカルセットアップには適用されません。
根底にある考え方（作業アイテム、契約、証跡、セッション）については、まずコンセプトを 読んでください。一人での日常的なループは日常ワークフローを参照してください。
コラボレーションモデルの概要
4つの考え方がモデル全体を支えます:
- ワークストリームと共有作業。 リモートプロジェクトが共有作業の権威です —— タスク、依存関係、進捗、 結果が存在する唯一の場所です。ローカルのチェックアウトはコードとテスト専用です。リモートプロジェクトを 置き換える2つ目のローカルタスクレジャーを初期化しないでください。
- クレーム。 エージェントが実行作業を開始する前に、そのセッションの下でタスクのライブクレームを取得 します。他人のライブクレームを置き換えてはならないため、2つのエージェントが黙って同じものに取り組む ことはできません。
- レビュー。 デリバリーと受け入れは別の事実です。権限を持つ独立した人が、提出された作業が受け入れ られる前にレビューします。あなたに属する2つ目のエージェントは、独立したレビュアーではありません。
- ハンドオフ。 セッションは永続的です。MCPの再接続を越えて生き残り、チェックポイントとリカバリー 状態を保持し、コンテキストを失うことなく —— 休憩後のあなたによって、あるいはチームメイトによる検査 によって —— 再び拾うことができます。
一度だけ接続する
プロジェクト管理者に、プロジェクトのMCP URLとあなた個人の資格情報を求めてください。すべての参加者が 自分の資格情報を使い、リポジトリの権限はAWRの権限とは分離されたままです —— AWRプロジェクトへの参加は Gitアクセスを付与せず、その逆も同様です。
舞台裏では、権限を持つ管理者がInspectorでMembersを開き、あなたを追加し、プロジェクトロールと ワークストリームを選び、エンドポイントとあなたの資格情報を含む一度限りの個人接続指示をコピーします。 あなたはそれを非公開チャネルで受け取ります。発行パネルをクリアした後、管理者はその平文を取り出せません。 資格情報を紛失した場合は、明示的に再発行できます。
Streamable HTTPとBearer認証によるリモートMCPをサポートする任意のエージェントクライアントに、 リモートMCPサーバーを追加します:
| 設定 | 値 |
|---|---|
| トランスポート | Streamable HTTP |
| サーバーURL | プロジェクトのエンドポイント。例: https://team.example/v1/projects/example/mcp |
| 認証 | HTTP AuthorizationヘッダーのBearerトークン |
| 資格情報 | 管理者から提供された個人資格情報 |
これらは接続設定であり、設定ファイルの形式やシェルコマンドではありません。各クライアントには独自の設定と バージョン要件があります。クライアントがローカルのstdio MCPのみをサポートする場合、このURLは直接使えま せん —— リモートトランスポートをサポートするクライアントバージョンまたは統合を使ってください。
資格情報に関する安全ルール:
- クライアントがサポートするシークレット設定、または信頼できる非公開のエージェント入力を使ってください。
- 資格情報をURL、共有会話、リポジトリに入れてはいけません。
- 設定変更後は再接続し、エージェントでローカルのコードチェックアウトを開いてください。
エージェントに成果を伝える
開発に使っているのと同じ会話で作業します。成果を説明し、エージェントに調整させます。例えば:
接続済みのAWR Teamプロジェクトを使って、issue APIを実装してください。現在のタスクを更新して私の既存の 作業を再開するか、このリクエストに合う適格なタスクにクレームを取ってください。編集前に契約、依存関係、 最新のチェックポイントを読んでください。進捗と証跡はAWRに保持し、テスト済みの変更をPRとして提出し、 独立したレビューを要求してください。
エージェントは共有作業を読み、適格なタスクにクレームを取り、ローカルで開発しながらプロジェクトを最新に 保ちます。実際の権限、依存関係、オーナーシップのコンフリクトに遭遇した場合は、回避するのではなく、 あなたに報告します。
エージェントがあなたのためにすること
エージェントは、発見された2つのMCPツール —— 読み取り用のawr_team_queryと書き込み用の awr_team_command —— を通じてTeamサービスと対話します。すべてのクエリとコマンドは現在の権限を再 チェックするため、誰かがローカル設定を編集しなくてもロール変更が反映されます。
典型的なセッションは次のように流れます:
- 開始または再接続。 エージェントは
capabilitiesを問い合わせて自身の識別情報と権限を確認し、work.nextであなた自身のセッションを再開するか、可視の未完了作業を発見します。返されたnext_queryに従います。（work.nextのない古いサーバーでは、workstreams.listとスコープ付きのwork.list/work.searchにフォールバックします。） - 準備。 選択したタスクについて、
work.prepareは現在の契約、必須の仕様、依存関係、リカバリー状態、 コンテキストハッシュを返します —— エージェントが編集前に実際に消費しなければならない1つのスナップ ショットです。work.prepareとwork.observeは、短いguidance項目（その条件、事実根拠、次の アクション、再評価トリガー）を1件返すこともあります。それは助言であり、実行権限ではありません。 - クレーム。 エージェントは
claim.inspectで既存のクレームを検査し、そのセッションの下でライブ クレームを取得または更新します。 - 実行。
execution.prepareと、execution_authorized=trueを持つ新鮮なexecution.startレスポンスを もって、エージェントは宣言されたスコープ内で1回の実行を行えます。コードとツールを実行するのはあなたの マシンです —— サービス自身が何かを実行することは決してありません。クレームだけでは実行の許可には なりません。 - 進捗の報告。 エージェントは消費したコンテキストハッシュ、次のアクション、未解決ループ、短い
progressサマリーを含むsession.checkpointを送信します。フェーズやテストが完了したとき、ブロッカー が変わったとき、あなたの入力が必要なとき、デリバリーの準備ができたときにまとめて更新し —— ツール 呼び出しごとではありません。チェックポイントのサマリーは権限を持つ作業の閲覧者と共有されるため、生の 機密ログを含めるべきではないことに留意してください。 - 完了または停止。
execution.reportはバージョンに紐付けられた証跡とともに終端の結果を記録します。 クレームの解放とセッションの終了は、アクティブな作業と不明な結果が解決された後にのみ行われます。
レビューと受け入れ
作業の準備ができたら、エージェントはdelivery.submit_and_request_reviewまたはreview.openを通じて 証跡を提出し、レビューを要求します。権限を持つ独立した人がデリバリーをレビューし、権限のある確定が プロジェクトの受け入れポリシーに従って行われます。
これらは別の事実として保持してください。実装、検証、GitHubマージ、AWRの受け入れ。PRのマージはAWRが タスクを受け入れることと同じではなく、あなた自身の2つ目のエージェントは独立したレビュアーとして カウントされません。
ハンドオフとリカバリー
ハンドオフが機能するのは、セッションとチェックポイントが一人のチャット履歴ではなく共有プロジェクト上に 存在するからです:
- MCPの再接続は、永続的な作業セッションを終了させず、リースを更新もしません。
- リカバリー状態と登録済みのデリバリーは、古いチェックポイントの指示より優先されます。戻ってきた エージェントは実際に起きたことを信頼します。
- 書き込みがタイムアウトした場合、エージェントは正確に再試行する前に元のコマンド結果を検査します。 再生された領収書は歴史的事実であり、副作用を再度実行する許可ではありません。
- 実行の副作用が不明な場合（タスク途中の中断）、検査と権限のある調整が必要です。新しいセッションを 作成してもその要件は回避できません。
知っておくべき2つの実務上の制限: AWRはアイドル状態のエージェントを起こすことができません（リース更新は チェックポイントとは別の、ホストのスケジューリングを使います）。また、ブロックまたは待機のフェーズは 報告であり —— それ自体で待機項目を作成したりクレームを更新したりはしません。
Inspector: オプションのワークスペースビュー
Inspectorは同じプロジェクト上のWebビューです。WebサイトへのサインインやWebサイト経由のクレームは、 上記のいずれの前提条件でもありません —— エージェントが調整の場であり続けます。Inspectorは次のような ときに使います:
- タスクの関係、オーナーシップ、進捗、記録された結果を検査したい。
- Connect Agentからクライアント非依存のMCP設定とプロジェクト指示をコピーする、またはタスクごとの ブリーフをコピーする（テキストのコピーはセッションもクレームも作成しません）。
- 管理者として、Membersでメンバーとプロジェクトスコープの資格情報を管理する。
- Activityをレビューする。ここでは認証済みアクセス記録とコミット済み開発履歴が分離されています。 一般メンバーは自分の権限のあるアクティビティを見られます。プロジェクト監査者はメンバーやタスクで フィルタリングできます。監査記録は資格情報の値、会話、任意のツール入出力を除外し、リクエストメタ データの保持期間には上限があります —— 永続的なコンプライアンスアーカイブではありません。
管理者とレビューの権限は、どのクライアントを使うかに関係なく中央サービスによって強制されるため、 誰かがエージェント経由、Inspector経由、またはその両方で作業してもルールは維持されます。