agentcourier

agentcourier

AI エージェント同士が、マシンをまたいで安全に通信できるようにします。
Claude Code、Codex、GitHub Copilot、その他あらゆる MCP クライアント間で、エージェント同士のメッセージやファイルをやり取りするための MCP サーバーです。
ノートパソコン、HPC クラスター、同僚のマシンで利用できます。エンドツーエンド暗号化に対応し、サーバーもクラウドも不要です。

機能

• エージェント間でメッセージやファイルをやり取りできます。 ノートパソコン上のエージェントが、クラスター上のエージェントにシミュレーションの確認を依頼すると、その回答が同じ会話に返ってきます。ファイルも送信できます。
• 一度ペアリングすれば、あとはそのまま使えます。 マシンは一度だけペアリングします。エージェントを終了して再起動しても、名前はそのままです。オフラインのエージェント宛てのメッセージは、オンラインに戻るまで保留されます。
• 実行中のセッションで使えます。 Claude Code では、メッセージがセッション内に直接表示されます。その他のクライアントでは、ツールを 1 回呼び出してメッセージを読み取ると、デスクトップ通知が届きます。
• ペアリングしたマシンだけが対象です。 アカウントもサーバーもクラウドも不要です。将来の量子コンピューターへの対策も含め、すべての接続がエンドツーエンドで暗号化されます。
• ガードレールを標準搭載しています。 個人データや秘密情報はマスキングされ、ファイルはマルウェア検査を受けます。また、エージェントには受信メッセージを信頼できないものとして扱うよう指示されます。

エージェントから見ると、agentcourier は courier_send、courier_send_file、courier_inbox、courier_peers、courier_set_name の各ツールを備えた通常の MCP サーバーです。

はじめに

1. インストールは各マシンで行います（小さなプログラムを1つインストールするだけで、管理者権限は不要です）。

pip install agentcourier

または、Rust を使う場合：cargo install --git https://github.com/alhermann/agentcourier。

2. 2台のマシンを一度ペアリングします。もう一方のマシンから接続するマシン（たとえばクラスター）で、次を実行します。

agentcourier invite laptop

一度だけ使えるコードが表示されます。もう一方のマシンでコードを貼り付け、最初のマシンへの接続方法を指定します（ここでは SSH トンネル経由）。

ssh -N -L 17312:127.0.0.1:7312 you@cluster-login-node
agentcourier join agentcourier-… hpc 127.0.0.1:17312

ヒント：マシンには所有者の名前を付けてください（agentcourier invite jana）。そうすれば、「Janaのエージェントに聞いて」と指示できます。

3. エージェントに agentcourier を追加します。

claude mcp add --scope user agentcourier -- agentcourier mcp --channel
claude --dangerously-load-development-channels server:agentcourier

{
  "servers": {
    "agentcourier": { "type": "stdio", "command": "agentcourier", "args": ["mcp"] }
  }
}

[mcp_servers.agentcourier]
command = "agentcourier"
args = ["mcp"]

システムが agentcourier コマンドを見つけられない場合は、インストール時に pip または cargo が表示したフルパスを使用してください。

4. 会話する。 たとえば、エージェントに次のように伝えます。「hpc の Claude にメッシュの解析が終わったか聞いて、results/summary.csv を送ってください。」

各セッションには、ツール名とプロジェクト名をもとに copilot-paper や claude-femsim のような分かりやすい名前が付きます。完全なアドレスは claude-femsim@hpc です。エージェントに 「自分を fe-runs と呼んで」 と伝えることもできます。エージェントは courier_peers で、オンラインの相手と以前に確認した相手を調べます。

状況を確認する

agentcourier peers      # who is reachable, and agents seen before
agentcourier status     # connections, paired machines, refused attempts
agentcourier log        # recent activity (no message text)
agentcourier untrust X  # cut off a machine immediately

よくある質問

2つの Claude Code セッションをどうやって会話させますか？

手順3に従って Claude Code に agentcourier を追加してください。各セッションには claude-femsim のような名前が付き、同じマシン上でもペアリング済みの別のマシン上でも、その名前でほかのセッションにメッセージを送信できます。

Claude Code、Codex、GitHub Copilot は相互に会話できますか？

はい。agentcourier は標準の MCP サーバーなので、異なるベンダーのエージェント同士も同じ方法で接続できます。たとえば、ノートパソコンの Copilot ウィンドウとサーバー上の Claude Code セッションを接続できます。

ノートパソコンのエージェントをリモートサーバーや HPC クラスター上のエージェントに接続するにはどうすればよいですか？

両方のマシンで agentcourier を実行して一度ペアリングし、SSH トンネル経由で接続してください。ファイアウォールの変更も管理者権限も必要ありません。SSH サーバーを共有しているだけのオフィス PC 2台向けの設定例を含め、ガイドを参照してください。

自分のエージェントを同僚のエージェントと会話させることはできますか？

はい。2台のマシンをペアリングすれば可能です。お互いのマシンに名前を付ければ、「Janaのエージェントに聞いて」と指示できます。受信したメッセージは信頼できないテキストとして扱われ、エージェントはそれに基づいて行動する前にユーザーに確認します。

セキュリティは確保されていますか？ サーバーやアカウントは必要ですか？

サーバー、アカウント、クラウドは不要です。接続できるのはペアリングしたマシンだけで、すべての接続はポスト量子保護に対応したエンドツーエンド暗号化で保護されます。個人データや秘密情報はマスキングされ、受信したファイルはマルウェア検査を受けます。詳しい説明と制限事項はセキュリティをご覧ください。

A2A やマルチエージェントフレームワークとは何が違いますか？

AutoGen、CrewAI、LangGraph などのフレームワークは、1 つのプログラム内で複数のエージェントを実行します。一方、A2A はエージェントサービスをウェブ経由で接続します。agentcourier は、すでにお使いのコーディングエージェントを、実行中のセッションのまま、複数のマシンやユーザーの間で接続します。

詳細はこちら

• ユーザーガイド：名前とアドレス、ファイル、通知、コマンド、設定、クラスター
• セキュリティ：ペアリング、暗号化、マスキング、ファイルのスクリーニングの仕組みとその制限

ライセンス

Apache-2.0