tools/call
は、実際のサーバーに到達する前にファイアウォールエンジンを
通ります。このページはそのサーフェスの地図です — ゲートウェイ、呼び出しごとの判定、
スキル統制、egress、暗号化されたクレデンシャル — それぞれに焦点を当てた手順への
リンク付きです。
ここでのすべての管理アクションはコンソール(またはセッション/アクセストークンを
使った REST API)から設定され、ロールゲートされています。
sk-orca-... 形式のキーを
持つのは /v1/* リレー呼び出しとファイアウォールゲートウェイルートだけです。1. なぜ mcp セキュリティにゲートウェイが必要か
10 個のエージェントを 5 つのコミュニティ MCP サーバーに直接向けると、あらゆる世界の 最悪を手に入れます:共有ポリシーなし、監査トレイルなし、10 個のエージェント設定に コピーされたクレデンシャル、そしてshell.exec という名前のツールがクラウド
メタデータエンドポイントへリダイレクト 1 回の距離にある状態です。ゲートウェイは
それをひとつの統制された接続に集約します。
ひとつの接続、すべてのサーバー
エージェントは単一のエンドポイントに接続します。ゲートウェイは、有効で到達可能な
すべてのサーバーのツールを
<server>.<tool> 名前空間の下で集約します。すべての呼び出しにポリシー
各
tools/call は、ディスパッチ前にあなたのファイアウォールポリシーによって
評価されます。暗号化されたクレデンシャル
サーバーの認証シークレットは保存時に暗号化され、読み取り時にマスクされ、
ディスパッチ時に注入されます — モデルやクライアントに到達することは決して
ありません。
統制下の egress
登録されたサーバーのエンドポイントは、デフォルトでプライベートおよびクラウド
メタデータの IP 範囲に対して検証されます。ツールごとの宛先については、ベースライン
SSRF egress 拒否リストを適用するか、独自のホスト/CIDR ルールを作成します。
2. 4 つの構成要素
OrcaRouter での MCP 統制は、協調する 4 つのピースです。答えようとしている問いに 合うものを選んでください。MCP ゲートウェイ
MCP ゲートウェイ
サーバーを直接ダイヤルする代わりに、エージェントが接続する単一のエンドポイント
です。登録されたすべてのサーバーのツールを
<server>.<tool> で名前空間化して
集約し、各ツールの入力スキーマを逐語的に再公開します。
MCP サーバーの接続と
認証から始めてください。完全な
リファレンスはファイアウォール:MCP サーバーに
あります。呼び出しごとの評価
呼び出しごとの評価
ゲートウェイは各
tools/call を mcp サーフェス上でファイアウォールに通し、
ディスパッチの前に判定 — allow、audit、deny、sanitize、または
pending_approval — を返します。
MCP ツールの許可リスト化と
ツール引数のサニタイズを参照してください。スキル統制
スキル統制
エージェントが自己インストールするケイパビリティ — スキル、BYO MCP サーバー、
プラグイン — はスキャンされ、リスクバンドを割り当てられ、すべてのルール判定の
上に乗る強制モード(
allow / quarantine / block)を与えられます。
ファイアウォール:スキルと
ラグプル防御を参照してください。暗号化されたクレデンシャル
暗号化されたクレデンシャル
各サーバーの認証シークレットは保存時に暗号化され、読み取り時にマスクされます。
認証と
クレデンシャルローテーションを参照して
ください。
3. tools/call はどう評価されるか
エージェントがゲートウェイ経由でツールを呼び出すとき、その呼び出しはサーバーへ 直行しません。あなたのワークスペースポリシーに対して照合され、所有元スキルの 強制モードがその上に適用され、allow / audit / sanitize の判定だけが実際の
サーバーに到達します。
| 判定 | エージェントが見るもの |
|---|---|
allow / audit | 転送。audit はイベントもログに記録します。 |
sanitize | 引数をリダクトして転送(結果は決して変更しません)。 |
deny / pending_approval | ツールエラーとして返されるため、エージェントはクラッシュする代わりに適応できます。 |
4. サーバーの登録(具体例 1 つ)
各サーバーは一度登録します。サーバーレコードはname(ワークスペースごとに一意、
. 不可)、endpoint、auth_mode(none / bearer / oauth / basic)、
そしてその暗号化されたクレデンシャルを持ちます。これはコンソールから行います —
書き込みには Developer+ が必要です。
ok / degraded / down)を記録するために
プローブします:
github.create_issue が何を受け付けるかを正確に知った上で github.* に
対してルールを書けます。エンドツーエンドのウォークスルーは
MCP サーバーの接続にあります。
シークレットは決して平文で保存されません。
auth_json は保存時に暗号化され、
読み取り時にマスクされます。更新時には、保存値を維持するためにマスクをそのまま返して
ください。クレデンシャルローテーションを
参照してください。5. エージェントをゲートウェイに接続する
サーバーが登録されたら、任意の MCP クライアントを ファイアウォールゲートウェイスコープのキー(そのスコープを持たないトークンは 403 を受け取ります)とともにゲートウェイに向けます:<server>.<tool> 名前空間の下でアドバタイズします。呼び出しを自身でプロキシする
SDK は、同じゲートウェイトークンで GET /api/v1/firewall/mcp_servers から
ランタイムレジストリを読み取れます。
6. ツールが到達できる先をロックダウンする
呼び出しごとの判定はどのツールが実行されるかを統制し、egress 制御はどこに到達 してよいかを統制します。2 つのレイヤーが協調します。 第 1 に、ゲートウェイが登録されたサーバーのエンドポイントに接続するとき、その URL はデフォルトでプライベート(RFC1918)、ループバック、リンクローカル、クラウド メタデータの範囲に対して検証されます — そしてホストは DNS 解決されるため、ブロック された範囲に解決される名前も拒否されます。したがって、169.254.169.254 や
イントラネットアドレスに向けられた BYO サーバーは、明示的にホワイトリスト化して
いない限り拒否されます。
第 2 に、ツールごとの宛先については、egress ルールが egress サーフェス上で
呼び出しのアウトバウンド宛先に対して照合されるホスト/CIDR の許可/拒否リストを
持ちます。ベースラインのユースケーステンプレートには、そのリストがすでに
プライベート、ループバック、リンクローカル、クラウドメタデータの範囲
(169.254.169.254 と metadata.google.internal を含む)をカバーする既製の
egress 拒否ルールが付属しているため、適用すれば CIDR を手で書くことなく SSRF/
メタデータ防御が得られます。
7. 監視する:イベント、ラン、異常
すべての統制された呼び出しはトレイルを残します。ファイアウォールイベントは判定、 サーフェス、マッチしたルールを記録し、ランはセッションの呼び出しをグループ化し、 異常フィードは学習されたベースラインに対する頻度とコストのスパイクをフラグします。 設定、ポリシー、発見されたツールの読み取りは任意の Member に開放されています。 イベント/ラン/集計の読み取りには Developer+ が必要です。- MCP イベントの監査 — 何が記録され、どう読むか。
- 信頼チェックリスト — 新しいサーバーに エージェントを放つ前のプリフライト。
8. 次のステップ
MCP サーバーの接続
サーバーを登録、プローブし、ゲートウェイ経由で公開します。
MCP ツールの許可リスト化
サーバーをデフォルト拒否にし、レビューしたツールだけを許可します。
ラグプル防御
承認後に変化するサーバーとスキルを統制します。
ファイアウォール:MCP サーバー
完全なフィールドとルートのリファレンス。
