ドキュメント · 共有

リモート magpie

1 つの magpie で複数のコンピューターをまかなえます。プロバイダを保存するコンピューター（デスクトップ、サーバー、Docker で動かす NAS）でサインインとプロバイダ・ルーティンググループの設定を一度だけ行い、ほかの各コンピューターではその magpie を 1 つのプロバイダとして追加します。それがリモート magpie（Remote magpie）です。

手元のコンピューターでも magpie は動き続けます。そのコンピューターのエージェントを設定し、モデルを選び、セッションを保存します。モデルだけがもう一方から来ます。

1. メインの magpie を共有する

1. 共有をオンにするプロバイダを保存しているコンピューターで 設定 → ローカルネットワークで共有 → オン。magpie はローカルネットワークで待ち受け、Magpie という名前のゲートウェイキーを作ります。スイッチの下の アドレス の行に、ほかのコンピューターから届くアドレス（例：http://192.168.1.20:3425）が表示されます。
2. コンピューターごとにキーを作るゲートウェイ → ゲートウェイキー、または magpie gateway-key add "Laptop"。sk-magpie-key-… が表示されます。キーごとに日・週・月の上限と使えるモデルを決められ、呼び出しはその名前で集計されます。

共有がオフの間、デスクトップの magpie は自分のコンピューターでしか待ち受けず、ほかのコンピューターからは届きません。Docker の magpie は公開したポートから届き、共有のオン・オフにかかわらず、コンテナの外からの呼び出しすべてにゲートウェイキーを求めます。Docker を参照してください。

2. ほかのコンピューターで追加する

手順 1 のアドレスとキーが必要です。次のどれでも追加できます。

• アプリ：プロバイダ タブで ＋ プロバイダを追加 を押し、Remote magpie を選んで、アドレスとキーを入力します。
• TUI（magpie tui）：Providers ページで a を押し、Remote magpie を選んでアドレスとキーを入力します。その行で w はアドレスの変更、m は一覧の再取得です。
• CLI：

magpie provider add remote-magpie sk-magpie-key-… url=http://192.168.1.20:3425 id=office
magpie models            # office/… が共有する magpie のモデル
magpie provider refresh office   # 一覧を再取得

id= はこのコンピューターでのプロバイダ名で、モデル ID の先頭にもなります（office/…）。アドレスは 192.168.1.20:3425（http:// とみなされます）、末尾に /v1 を付けた形、ルートのどれでも構いません。magpie はどの場合もすべての API をそこにつなぎます。共有元のコンピューターごとに、別の id でリモート magpie を 1 つ追加します。

使えるもの

• そのモデル。向こうのエージェントに見えるとおりです：office/relay-a/claude-sonnet-5、ラベルは Claude Sonnet 5 · Relay A · office。ID は ID のままで、名前はラベルにだけ付きます。ほかのモデルと同じようにエージェントに選べます。
• そのルーティンググループ。office/group/… として現れます。振り分けは共有する magpie 上で、そのアカウントを使って決まります。
• すべての API。リクエストはエージェントが使った API のまま転送されます（Anthropic Messages とトークン計数、Responses、Chat Completions）。共有側のプロバイダが別の API でしか提供しないモデルは、変換が 1 回だけ行われ、両方のコンピューターで変換されることはありません。Responses は WebSocket ではなく HTTP（SSE を含む）で送られます。
• 画像と動画。画像・動画モデルは自動で見つかり、向こうの画像生成・編集・動画 API を通して使えます。
• System One。決定モデル（Jev、Clef、自分で名前を付けたモデル）は向こうの /v1/systemone につながり、チャットモデルではなく決定モデルとして現れます。新しいものはプロバイダの一覧を更新すると見つかります。office だけを指定すると一覧の最初の決定モデルに問い合わせます。
• Embeddings と rerank は向こうの対応する API に送られます。エージェントの一覧ではリモートでの扱いのままです。一覧にあっても会話に使えるわけではありません。
• 価格。各モデルは共有する magpie の計算どおり（向こうで手動設定した価格、なければプロバイダの定価）になるので、2 台の集計は一致します。このコンピューターで設定した価格が優先されます。

クォータと使用量

使用量ページ、メニューバー、magpie quota には、共有する magpie のサブスクリプションカードがその名前付きで（Codex · office、id office/codex）、向こうが最後に読んだ内容で表示されます。ベンダーに問い合わせるのはサインインを持つコンピューターだけです。このコンピューターでカードを更新すると、向こうがもう一度読みます（最大で 30 秒に 1 回）。Codex のリセットや WorkBuddy のチェックインは、向こうのコンピューターのアプリ、TUI、CLI で行います。

共有する magpie は、このコンピューターのリクエストを、送ってきたゲートウェイキーの名前と応答したアカウントで記録します。

うまくいかないとき

質問や共有したいセットアップがあれば Discord へどうぞ。詳細はリファレンス（英語）にあります。