BRYDGE

brydge-mcp

エージェントの作業が実際に行われたか確認します。

これは、MCP サーバーとしてのBRYDGEです。エージェントが動作する前に、BRYDGE が動作を許可するか判断します。その後、BRYDGE は自身の認証情報を使って、決済処理サービスやチケットシステムなど、接続先システムの記録を読み取ります。そして、許可されたとおりに作業が行われたかを報告します。エージェントが作業について述べた内容は、その判定と並べて保持されますが、判定には影響しません。

ツール

ツール	機能
brydge_supervise	動作する前に確認します。ALLOWED は、エージェントがその動作で作成する記録に書き込むための認可 ID を返します。ESCALATED は、人が判断することを意味し、エージェントは動作してはいけません。同じ idempotency_key で再度問い合わせると、その人の回答が返されます。
brydge_report_outcome	エージェントが起きたと考える内容を報告します。
brydge_verify	接続先の記録をその時点で読み取り、作業が行われたかを伝えます。
brydge_get_finding	記録を再度読み取らずに、BRYDGE がこれまでに確認した内容を返します。無料です。
brydge_get_headroom	人に確認を求めるまでに、エージェントが任意の24時間内に実行できる動作の数を伝えます。

サーバーは、モデルに指示も提供します。まず確認し、認可を明記して報告し、作業が完了したと伝える前に検証してください。

まずBRYDGEをセットアップする

BRYDGEで、これらの手順を一度行います。

1. ConnectページでAPIキーを発行します。
2. 動作の価値を申告します。BRYDGEはその価値の一部を請求します。また、価格が設定されていない動作は確認しません。
3. 動作の接続先を登録します。BRYDGEが記録を読み取る場所と、読み取り専用の認証情報を登録します。BRYDGEにはStripeの返金用プリセットがあります。
4. BRYDGEのエージェントページで、その動作についてエージェントに権限を付与します。権限がない場合、すべての呼び出しが人に回され、エージェントはその人が許可した後にのみ動作します（人が判断する場合を参照）。

権限ではエージェントが実行できる内容を定め、ヘッドルームでは任意の24時間内に実行できる量を定めます。新しいエージェントは、1日に1件の動作を実行できる枠から始まり、BRYDGEが確認して正しいと判定した報告があるたびに、その枠が増えます。

MCPクライアントに追加する

ほとんどのクライアントでは、次の設定を使用します（Claude Desktop、Cursor、Windsurfなど）。

{
  "mcpServers": {
    "brydge": {
      "command": "npx",
      "args": ["-y", "brydge-mcp"],
      "env": {
        "BRYDGE_API_KEY": "brydge_sk_...",
        "BRYDGE_ACTOR": "agent:refund-ops"
      }
    }
  }
}

Windowsでは、npx は .cmd ファイルです。シェル経由またはMCP SDK経由でコマンドを起動するクライアントのみ、名前を指定して実行できます。クライアントに spawn npx ENOENT と表示された場合は、代わりにコマンドシェル経由で起動してください。

{
  "mcpServers": {
    "brydge": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "brydge-mcp"],
      "env": {
        "BRYDGE_API_KEY": "brydge_sk_...",
        "BRYDGE_ACTOR": "agent:refund-ops"
      }
    }
  }
}

Claude Codeの場合：

claude mcp add brydge -e BRYDGE_API_KEY=brydge_sk_... -e BRYDGE_ACTOR=agent:refund-ops -- npx -y brydge-mcp

設定
BRYDGE_API_KEY	BRYDGE APIキーです。必須です。
BRYDGE_ACTOR	BRYDGEがこのエージェントを識別する名前です。例：agent:refund-ops。権限はこの名前に対して付与します。必須です。
BRYDGE_URL	BRYDGEの実行場所です。BRYDGEのホスト型サービスを使う場合は、設定しないでください。

エージェント名はこの設定から取得され、モデルから取得されることはありません。そのため、エージェントが別のエージェントの権限を借りることはできません。エージェントごとにサーバーを1つ実行してください。

エージェントの使用方法

1. まず確認します。 返金、支払い、その他の変更を行う前に、エージェントは {"amount": 4200} のような動作、対象、事実を指定して brydge_supervise を呼び出します。
2. 認可を明記します。 回答が ALLOWED の場合、エージェントは動作を実行し、接続先の該当箇所に認可 ID を書き込みます。Stripeの返金の場合は metadata.brydge_authorization です。BRYDGEはこのIDだけを使って作業を特定します。
3. 報告します。 エージェントは、起きたと考える内容を brydge_report_outcome で報告します。
4. 検証します。 作業が完了したと伝える前に、エージェントは brydge_verify を呼び出します。

brydge_supervise は、refund:ch_123 のような、実行予定の1つの動作を示す名前 idempotency_key を受け取ります。同じキーと同じ詳細で再度問い合わせると、同一のリクエストとして扱われます。再試行では同じ回答が返り、人に回されたリクエストに対して人が回答した後は、その回答が返されます。同じキーを別の動作に再利用しても、別の動作の回答が返されることはありません。サーバーは問い合わせ内容もハッシュに含めるためです。

人が判断する場合

エスカレーションされたアクションでは、BRYDGE で人の判断を待ちます。サーバーはそれを待ちません。モデルには、アクションを実行せず、相手が回答したらもう一度問い合わせるよう伝えます。

ESCALATED. Do not carry this out: a person decides. No mandate lets agent:refund-ops refund yet, so a person decides. A person has been asked. Ask again with the same idempotency key once they have answered: if they allow it, the answer is ALLOWED. Authorization: cmurkt5mw000i7dev66vu5afm.

モデルが同じ idempotency_key、アクション、対象、事実を指定して再度 brydge_supervise を呼び出すと、BRYDGE は人の判断を返します。

人の回答	decision	settled	モデルへの指示
まだ回答していない	ESCALATED	null	まだ実行せず、回答があったらもう一度問い合わせてください。同じ人に二度尋ねることはありません。
許可した	ALLOWED	"ALLOWED"	同じ承認を示して実行してください。
拒否した	ESCALATED	"REFUSED"	REFUSED. A person refused this: do not carry it out. と、その理由。

詳細が異なるリクエストは別のアクションです。そのため、42 ポンドの返金が許可されても、エージェントが 420 ポンドを返金することは許可されません。

各承認の対象は 1 つのアクションです。すでに実行したアクションを再試行すると、同じ ALLOWED が返されます。また、すでに実行済みの場合は、もう一度実行してはならないとモデルに伝えます。1 つの承認のもとでアクションが 2 回実行された場合、チェックは DUPLICATE_EXECUTION を理由に MISMATCH を報告します。

チェックで確認できること

state	意味
VERIFIED	記録から、許可されたとおりに作業が行われたことが確認できます。
FAILED	記録から、作業が試みられたものの成功しなかったことが確認できます。
MISMATCH	記録に、許可された内容とは異なるものが示されています。reason は理由を示します。理由は AMOUNT、TARGET、ACTOR、ACTION、DUPLICATE_EXECUTION、UNAUTHORISED_EXECUTION、または CORRELATION です。
UNKNOWN	BRYDGE では判断できませんでした。NO_MATCH は、この承認に関する記録がないことを意味します。それ以外の理由は、BRYDGE が記録を読み取れなかったことを意味します。UNKNOWN は FAILED と同じではありません。
PENDING	実行先によると、作業はまだ進行中です。

brydge_verify は呼び出された時点で記録を読み取ります。新しい情報が見つかったチェックは課金対象になりますが、変更がない状態で再度確認しても無料です。また BRYDGE は、実行先の報告期間が過ぎると、各アクションを自動的に確認します（別の期間を設定しない限り 60 分）。brydge_get_finding では、その結果を無料で読み取れます。

プロトコル

サーバーは stdio を介して MCP を使用します。公式 TypeScript SDK を基盤として、2026-07-28 リビジョンおよび同じプロセスの 2025 リビジョンのクライアントに対応します。BRYDGE に問い合わせられない場合（キーが無効、アクションに宣言済みの値がない、レート制限、または BRYDGE に接続できない場合）、ツールはモデルが読み取れるエラーを返し、アクションは実行されません。

制限事項

• BRYDGE は、1 つの対象を 1 件の作業として扱います。同じ対象に対する 2 件目の記録に別の承認が付与されている場合（1 件の請求に対する 2 回目の一部返金など）、MISMATCH として報告されます。
• サーバーは人を待ちません。エスカレーションされたアクションでは、人が判断するという指示をモデルに伝えて終了します。人の回答がエージェントに届くのは、モデルが同じ idempotency_key と同じ詳細で再度問い合わせた場合だけです。新しいキーを使ったリクエストは、改めて判断されます。
• サーバーはアクション自体を確認できないため、2 回目の実行を止められません。アクションがすでに実行されたかどうかは、モデルが記憶しておく必要があります。同じリクエストに BRYDGE が以前回答している場合、サーバーはその旨をモデルに伝えます。

開発

npm install
npm test          # a real MCP client against the server in both protocol eras, and the built command over stdio
npm run test:int  # against a running BRYDGE; see tests/integration
npm run build

ライセンス

MIT