Handover

Handover MCP

Claude Code、Codex、Cursor、Gemini CLI、人間、サービスエージェント間で、判断、ファイル、履歴、作成者情報を失わずに作業を引き継げます。

Handover は、ホスト型のModel Context Protocolサーバー、依存関係のないCLI、8つのオープンなAgent Skillsを通じて、人間とAIエージェントが共有するバージョン管理済みのコンテキストを提供します。このリポジトリは、これらのインターフェースの公開ソース、発見、インストール、接続に関する記録です。

研究とエビデンス

Handoverの研究とエビデンスの インデックス には、オープンな継続性ベンチマーク、Reporter移行フィールドレポート、Handoff Continuity Record、実行可能な継続デモがまとめられています。調査結果は、その手法、ソース成果物、当事者との関係、重要な制約とともに掲載されています。

バージョン管理されたresearch/v1/パッケージは、エージェントや研究者向けに、安定したJSONインデックス、JSON Schema、引用メタデータ、範囲を限定したMarkdown要約を提供します。このパッケージはHandoverと44pixelsによる一次公開資料であり、独立した検証として提示するものではなく、精査や再利用を目的として設計されています。

• 人間向け研究インデックス
• エージェントが読み取れる本番インデックス
• バージョン管理されたリポジトリインデックス
• 引用メタデータ
• 独立したベンチマーク結果の実行と提出

引き継ぎの全体を見る

公開継続 デモ では、インタラクティブな人間向け画面と、エージェントが読み取れる記録の両方から、同じワークフローを確認できます。Markdown、SQL、JSON、ビジュアル成果物、作成者を追跡できる3件の改訂、人間によるレビューのメモ、次のエージェントによる解決内容が含まれています。アカウントは不要です。

• インタラクティブデモ
• ワークスペースでデモを続ける
• デモのワークフローと検証メモ
• エージェントが読み取れるマニフェスト
• 生のMarkdown
• 生のSQL
• エビデンスJSON

非公開の引き継ぎプロンプトを作成する

AI 引き継ぎプロンプト ジェネレーターは、アカウントを作成しなくても、未完了の作業を記録用と受け取り側用の個別のプロンプトに変換します。入力内容はブラウザーのタブ内にとどまり、分析に送信されたり、サーバー側の下書きとして保存されたりすることはありません。

受け取り側用のプロンプトでは、次の担当者に証拠の確認、検証済みと未検証の状態の切り分け、ブロッカーの特定、続行前に範囲を限定した次のアクションを一つ示すことを求めます。Markdown の記録をコピーまたはダウンロードするか、同じ非公開の下書きを、入力済みの最初の引き継ぎに引き継げます。

• 非公開のプロンプトジェネレーターを開く
• Markdown の生の例を確認する
• HANDOFF.md で十分な場合を判断する

Claude Code から Codex に移行する

Claude Code の対応する設定、プロジェクト、メモリ、最近のチャットを一度だけ移行する場合は、まず Codex に組み込まれているインポート機能を利用してください。Claude Code と Codex を未完了の作業で交互に使用し、共有アーティファクト、個別の ID、レビュー、改訂履歴が必要な場合は、Handover を使用してください。

Claude Code から Codex への移行 レシピには、送信側の正確なチェックポイント、2 つのホストでのサービス認証情報の設定、受信側での検証、楽観的同時実行制御を用いた続行、取り消しテスト、合格基準が記載されています。レンダリング済みの ガイドでは、ネイティブのインポートと永続的な引き継ぎのどちらを使用するかを説明しています。

レビュー済みの MCP 引き継ぎを実行する

デモでは完成した記録を確認できます。エンドツーエンドの MCP 引き継ぎ手順では、個別に認証された ID を使用して、ワークフローそのものをテストします。

1. 発行者を確認します。
2. Markdown、SQL、JSON を公開します。
3. すべてのアーティファクトを読み戻します。
4. 別の ID から正確な証拠をレビューします。
5. 楽観的同時実行制御を用いて修正を公開します。
6. 修正版に基づいて指摘事項を解決します。
7. 新しい後任者が元のチャットなしで作業を続けられることを証明します。

また、拒否、読み取り専用、古いリビジョン、認証情報の取り消しの各ケースもテストします。理由についてはレンダリング済みの ガイドを参照してください。リポジトリの手順を実行する前に、インストール手順を通じてエージェントを接続することもできます。

AI エージェント引き継ぎチェックリストを使用する

より簡単なローカルでの引き継ぎには、まずMarkdown チェックリストを使用してください。目的、現在の状態、決定事項、証拠、制約、次のアクション、担当者を記録し、受け取り側の担当者に、現在のリビジョンを読み、証拠を開き、意味のある結果を一つ再現したうえで、引き継ぎを合格またはブロックとしてマークすることを求めます。

レンダリング済みのチェックリストと FAQでは、各検証手順を説明しています。生のテンプレートは Handover を使わずに利用できます。複数の担当者が認証済みアクセス、不変のリビジョン、検索、注釈、監査可能な担当履歴を必要とする場合は、ホステッドサービスを使用してください。

会社の AI コンテキストの準備状況を確認する

会社のナレッジを複数の人やエージェントに接続する前に、 会社の AI コンテキスト準備状況チェックリストを使用してください。 承認済みのソースナレッジと変化する継続記録を分け、人間とサービスの ID を一覧化し、会社とワークスペースの境界を明示したうえで、2 人・2 エージェントによるパイロットを行います。

このパイロットは、意図的にインポート件数より厳しい基準を設けています。承認された検索、変更の追跡可能性、人間によるレビュー、拒否された検索、エージェントの取り消し、新しいセッションでの継続を検証します。 ソースにリンクされたアーキテクチャガイドでは、検索インデックス、プライベートモデルメモリ、正本となる会社の記録の役割がそれぞれ異なる理由を説明しています。

オープンな引き継ぎフォーマットを使用する

Handoff Continuity Recordは、他の人間や AI エージェントが作業を検証して続行するために必要な状態を記録する、プラットフォームに依存しない JSON フォーマットです。目的、検証済みおよび未検証の状態、決定事項、証拠、制約、次のアクション、担当者、未完了のレビューを記録し、転送、ルーティング、認証、保存方法は規定しません。

protocol/v1/ディレクトリには、次の内容が含まれています。

• JSON Schema Draft 2020-12 の契約。
• 有効なインベントリ報告の例。
• 依存関係のない Node.js 準拠チェッカー。
• 作成者、受信者、スコープ、セキュリティに関する要件。

node protocol/v1/validate.mjs protocol/v1/example.json

MCP では、レコードの読み書きに使用するツールを公開できます。A2A またはオーケストレーションフレームワークでは、そのレコードをルーティングできます。Git または Handover では、そのレコードを保存できます。

接続する

正規の Streamable HTTP エンドポイントは次のとおりです。

https://handover.sh/api/mcp?profile=core

推奨されるコアプロファイルでは、日常的な ID、検索、取得、レビュー、継続、公開、ポータビリティのワークフローに対応する 17 個のツールを公開します。Handover のファーストパーティー操作 27 個すべてを使用するには、https://handover.sh/api/mcp?profile=nativeを使用してください。パラメーターなしのhttps://handover.sh/api/mcpエンドポイントでは、既存の統合向けに Reporter エイリアスを含む 55 個すべてのツールを引き続き利用できます。

このエンドポイントでは、アカウントなしで MCP のハンドシェイクとツールスキーマを公開するため、クライアントやディレクトリは接続前に互換性を確認できます。有効な人間またはサービスの認証情報がない場合、ツールの呼び出しは引き続き保護され、Handover の OAuth リソースチャレンジが返されます。

対話型 MCP ホストでは、Handover のファーストパーティー OAuth フローを使用します。標準のディスカバリー、動的なクライアント登録、PKCE、有効期間の短いアクセストークン、ローテーションするリフレッシュトークンに対応しています。ホストがブラウザーで Handover を開きます。自分のアカウントでサインインし、要求された権限を確認して、接続を承認してください。Handover は、追跡可能なすべてのアクションに人間の ID を記録します。

無人のランナーや OAuth に対応していないホストでは、Workspace or Company -> Agentsで作成した、個別の名前とスコープを持つサービス認証情報を使用します。人間とサービスの ID は、それぞれ独立して追跡および取り消しが可能です。

セットアップ、ID の確認、2 エージェントによる継続テスト、トラブルシューティングの全手順については、CONNECTING.mdを参照してください。

Codex

codex mcp add handover --url https://handover.sh/api/mcp?profile=core
codex mcp login handover

Claude Code

claude mcp add --transport http --scope user \
  handover https://handover.sh/api/mcp?profile=core

Gemini CLI

gemini mcp add --transport http --scope user \
  handover https://handover.sh/api/mcp?profile=core

Cursor

これを.cursor/mcp.jsonに追加してください。Cursor は Handover の認可サーバーを検出し、接続開始時にブラウザーでのサインインを求めます。

{
  "mcpServers": {
    "handover": {
      "url": "https://handover.sh/api/mcp?profile=core"
    }
  }
}

Cline

Cline の MCP ウィザードを開きます。

cline mcp install handover --transport http https://handover.sh/api/mcp?profile=core

Remote (HTTP) と Static headers を選択し、Cline の非公開ヘッダー入力欄に、スコープが設定されたサービスエージェントの認証情報を入力します。エージェントが読み取れる llms-install.md には、正確な設定、ID の確認、安全な初回書き込み、2 つのエージェントによる継続テスト、取り消し手順が記載されています。 Handover の一連のフローについては、Cline の公式セットアップページをご覧ください。実際の認証情報をチャットに貼り付けたり、Cline の非公開 MCP 設定をコミットしたりしないでください。

コマンドラインクライアント

依存関係のない Handover CLI を使用すると、ターミナルから同じ永続的なワークフローを実行できます。

npm install --global handover-sh
handover login
handover doctor
handover search "billing migration"
handover pull <slug-or-url> --out ./continued-work
handover publish ./report --title "Weekly report"

公開パッケージのソースとメタデータは cli/ にあります。npm が適さない場合は、監査済みの直接インストーラーも引き続き利用できます。

curl -fsSL https://handover.sh/install.sh | sh

パッケージのリリースは、この公開リポジトリからビルドされます。ブートストラップと信頼された公開のプロセスについては、RELEASING.md をご覧ください。

handover doctor は読み取り専用の接続確認コマンドです。設定済みのエンドポイント、サーバー側で解決された ID、ワークスペース、ロール、スコープ、および保護されたコンテキストへのリクエスト 1 件を検証しますが、認証情報を表示したり、ハンドオーバーを変更したりすることはありません。エージェントが初めて書き込みを行う前に、完全な検証チェックリストを確認してください。

エージェントスキル

オープンな Agent Skills 形式を使用して、再利用可能な Handover ワークフローを互換性のあるコーディングエージェントにインストールできます。

npx skills add 44-pixels/handover-mcp --list
npx skills add 44-pixels/handover-mcp --skill handoff
npx skills add 44-pixels/handover-mcp --skill handover-record
npx skills add 44-pixels/handover-mcp --skill handover-publish
npx skills add 44-pixels/handover-mcp --skill handover-test-continuity

公開コレクションには、ローカル優先のセッション引き継ぎ、機械可読な記録の作成と検証、接続の確認、コンテキストの公開、作業の再開、リビジョンに紐づくフィードバックのレビュー、複数の ID を使用した完全な継続性のテスト、エージェントアクセスの管理を行うスキルが含まれています。skills.handover.sh でカタログを閲覧するか、skills/ でソースを確認してください。このコレクションは、Skills.sh ディレクトリにも登録されています。カタログでは引き継ぎのフェーズごとにスキルが整理され、各ワークフローの平易な言葉による開始リクエストが含まれています。また、機械可読なインデックスから、正確な MCP ツールと CLI コマンドを確認できます。

ランタイムは、公式 MCP レジストリにも独立して sh.handover/handover として登録されています。

Agent Skills と MCP のガイドでは、ポータブルなワークフロー手順と認証済みのランタイム機能との境界について説明しています。エンドツーエンドのワークフローの生データは、エージェントが直接取得できるように設計されています。

ホスト固有のインストール方法については、検証済みの Claude Code、Codex、Cursor、Gemini CLI のガイドを参照してください。検証チェックリストの生データでは、ファイルのインストールと、ホストによる検出、スキルの有効化、認証済み MCP ID、読み戻し、アクセス拒否、ホスト間での継続を分けて確認できます。

Handover を使用するワークフローを公開するには、Agent Skill 開発者キット、コントリビューター契約、スタータースキルから始めてください。スターターを新しい skills/<name>/SKILL.md にコピーします。このテンプレートでは、レジストリがインストール可能なスキルと誤認しないよう、意図的に予約済みのファイル名を使用していません。コミュニティからの投稿では、公開者とソースの帰属表示が保持されます。カタログへの掲載によって Handover へのアクセス範囲が広がることはなく、ソースのレビューに取って代わることもありません。

認証済みワークフローをテストする前に、ローカルの契約を検証してください。

node templates/handover-skill/validate.mjs skills/<name>/SKILL.md

この検証に合格すると、ファイルの契約が満たされていることは確認できますが、ホストによる検出、MCP 認証、権限、読み戻し、アクセス拒否時の動作は確認できません。開発者キットでは、これらのランタイムチェックを明示的に扱っています。

オープンな継続性ベンチマーク

AI Handoff Continuity Benchmark では、後続モデルがトランスクリプト、圧縮メモリ、または構造化された引き継ぎから、目的、現在の状態、決定事項、根拠、制約、次のアクション、担当者、未解決の質問を復元できるかをテストします。

最初の2システムによるパイロットでは、構造化された引き継ぎが79.45、会話のトランスクリプトが76.67、圧縮メモリが45.00でした。これは、モデルのリーダーボードではなく、小規模な作成者主導のパイロットです。公開されているbenchmark/ディレクトリには、データセット、正解キー、依存関係不要のスコアラー、厳密な形式の提出物、決定論的な結果、制限事項、18件すべての生の応答本文が含まれています。ページから値を書き写すのではなく、公開されているCITATION.cff、citation.bib、またはフラット形式のsummary.csvを再利用してください。

cd benchmark/v1
node run.mjs --validate-scorer
node run.mjs --prompts ./prompts

エージェントにできること

接続されたエージェントは、次の操作を行えます。

• handover.whoami で、現在のID、組織、ワークスペース、スコープを確認する。
• 会社または個人のコンテキストを検索する。
• 正確な不変リビジョンを調べる。
• 添付されたMarkdown、HTML、SQL、JSON、コード、画像、その他のファイルを読む。
• 議論と、リビジョンに紐付けられた注釈を取得する。
• 新しい引き継ぎを作成するか、既存の引き継ぎを継続する。
• レビューコメントを追加、編集、解決し、返信する。
• 認証された人間またはサービスのIDを監査履歴に保持する。

サーバーは、ツールへの入力として作成者のIDを指定するようエージェントに求めることはありません。作成者情報は、認証済みの認証情報から取得されます。

接続を確認する

実際の作業を始める前に、接続されたホストに以下の呼び出しを実行するよう依頼してください。

1. 引数なしでhandover.whoamiを呼び出し、返された人物または名前付きサービスエージェント、組織、ワークスペース、ロール、スコープを確認します。
2. { "query": "" }を指定してhandover.searchを呼び出し、そのIDがアクセスできるコンテキストのみが返されることを確認します。
3. 作業の作成または継続を行う前に、既知の引き継ぎとアーティファクトを1つ読み込みます。

正常に接続されていれば、JSONエラーやサインインエラーなしでHandoverのツールが一覧表示され、意図されたIDが作成者として保持され、OAuthの許可またはサービス認証情報が取り消されるとすぐに動作が停止します。

サービスエージェント

ワークスペースの所有者はHandoverでサービスエージェントを作成し、そのエージェントに必要なスコープのみを付与します。認証情報はHANDOVER_TOKENに保存してください。リポジトリや、ソース管理にコミットするMCP設定に含めないでください。

export HANDOVER_TOKEN='hnd_tok_...'
codex mcp add handover \
  --url https://handover.sh/api/mcp?profile=core \
  --bearer-token-env-var HANDOVER_TOKEN

検索とドキュメント

• ログイン不要の継続デモ
• AI エージェントの引き継ぎチェックリスト
• 企業の AI コンテキスト対応状況チェックリスト
• 共有ナレッジベースのアーキテクチャガイド
• レビュー済み MCP 引き継ぎのエンドツーエンド例
• レンダリング済み MCP 引き継ぎガイド
• インストールとホスト別のセットアップ
• Claude Code、Cursor、Codex 向け MCP メモリーのセットアップ
• ホスト横断のセットアップと継続性テストの生データ
• Claude Code から Codex へのコンテキスト転送
• レンダリング済み Claude Code から Codex へのガイド
• 接続と検証の手順書
• MCP ワークフローガイド
• MCP OAuth とサービスアカウントの比較
• AI コーディングエージェント間でコンテキストを保持する
• 静的レポートフォルダーの移行
• Glama ホスト型コネクター
• 機械可読なホスト設定レシピ
• MCP サーバーマニフェスト
• エージェントツールマニフェスト
• OpenAPI ドキュメント
• エージェントが読み取り可能なナレッジコーパス
• セキュリティモデル

ソースとサポート

ホスト型 Handover アプリケーションのソースは、プライベートリポジトリで管理されています。 この公開リポジトリには、MCP 接続情報、セットアップドキュメント、 依存関係のない CLI のソースが含まれており、ホスト型サービスの 実装は含まれていません。

接続またはドキュメントに関する問題は、 GitHub Issues から報告してください。セキュリティ上の懸念は、 SECURITY.md に記載された手順で報告してください。