メインコンテンツまでスキップ

MCP ゲートウェイ

Yabanin の MCP アグリゲータはゲートウェイ側のプロキシで、組織が任意の外部 Model Context Protocol(MCP)サーバを、自らのエージェントへ公開できるようにします。エージェント限定のアクセス制御、エージェントごとのツール許可リスト、監査証跡、アイデンティティ転送、上流の資格情報(サーバレベル + ユーザーごとの遅延認可)、可観測性、パラメータガードを備えています。既定ではオフです。ルートグループ全体がマウントされるのは、YABANIN_MCP_GATEWAY=1 のときだけです。

名前はプロトコルではありません。 「MCP ゲートウェイ」という名前にもかかわらず、現在出荷されているのは 呼び出し API です。それは、JSON-RPC で外部 MCP サーバを自ら呼び出す、単なる HTTP エンドポイント POST /api/mcp/invoke(JSON リクエスト、エージェントキー yag_*)です。MCP クライアントは接続できません。ここには tools/list も、クライアント向けの MCP トランスポートもありません。ゲートウェイ上のネイティブな MCP エンドポイント(tools/list のカタログと Streamable HTTP サーバ)は、計画されている将来の作業です(カード RM-100 と RM-101)。それが入るまで、アグリゲータの唯一のプログラムインターフェースは、§5 で説明する呼び出し API です。

§1 で説明する 外向きパートナーブリッジは、すでに出荷済みの別機能であり、ここでは対象外です。ブリッジが答えるのは「エージェントが Yabanin のツールを呼ぶ」ことであり、アグリゲータが答えるのはその逆、つまり「Yabanin のエージェントが、任意の外部 MCP サーバを安全に呼ぶ」ことです。

1. 現在あるもの(アグリゲータの対象外)​

Yabanin は、すでに 外向き MCP パートナーブリッジを出荷しています(pkg/mcppartner、services/run/mcp.go、バイナリのサブコマンド mcp)。

  • トランスポート: stdio(Claude Code)と、:8787 上の HTTP-SSE(YABANIN_MCP_HTTP=1)。
  • 公開するツール: tr_route、tr_spend_report、tr_set_policy、tr_lineage_verify、加えてオプションの tr_delegate / tr_delegation_status。
  • 認証: パートナー API キー(YABANIN_PARTNER_API_KEY)。ゲートウェイ :8082 と admin :8086 へ Bearer として送信します。
  • 上流クライアント: 上限のある http.Client(タイムアウト 30 秒)。このクライアントが通信するのは Yabanin 自身のエンドポイントだけで、ユーザーが指定した任意の URL へは決して接続しません。

アグリゲータは新しい作業です。サーバレジストリとアクセス制御、アイデンティティ転送、メトリクス、パラメータガードを、すべて ゲートウェイ のデータプレーン上に置きます。

2. 振る舞い​

  • エージェント限定のアクセス。 ツール呼び出しが受理されるのは、エージェント主体のキー(yag_*、エージェント主体キー)の場合だけです。通常の yab_ API キーにはエージェントのアイデンティティがなく、何かを検索する前に 403 agent_only で拒否されます。受信する X-Agent-Id ヘッダは入口で取り除かれ、解決済みの yag_* 主体からのみ再設定されるため、クライアントはエージェントを偽装できません。
  • エージェントごとの付与 + ツール許可リスト。 エージェントがサーバを呼び出せるのは、(org, agent, server) に対する有効な付与を持っている場合だけです。付与がない、または無効な付与は、「サーバ利用不可」(404 not_found)と区別できません。エージェントは、自分の呼び出しのうちどれが付与でブロックされているかを列挙できません。実効ツール集合は、サーバの許可リスト(mcp_servers.allowed_tools、上限)と、付与の許可リスト(mcp_server_grants.allowed_tools)の共通部分です。どちらか一方の [] は、「その側のすべて」を意味します。
  • SSRF ガード付きの外向き通信。 上流 URL は、登録時に pkg/ssrf ガード(DNS 許可リスト + 予約 IP の拒否)を通り、呼び出しのたびに再度通ります(リバインドの窓)。プロキシはリダイレクトを追わず、接続と読み取りのタイムアウトには上限があります。
  • 監査証跡。 すべてのツール呼び出しは、ゲートウェイがチャットのリクエストに使うのと同じイベントストリームへ記録されます。そのため loggerd は、task_id、agent_id、upstream_url を付けた request_logs 行を永続化します。行のラベルは ModelUsed = "mcp:<server>:<tool>" です(モデル推論と区別できます)。ゲートウェイは request_logs を直接は書きません。
  • アイデンティティ転送。 検証済みの主体は、上流へ X-Yabanin-Agent-Id、X-Yabanin-Agent-Name、X-Yabanin-Team-Id ヘッダとして渡されます。これらは認可ではなく帰属です。外部サーバは呼び出しの帰属に使えますが、資格情報になることはなく、ゲートウェイは検証済みの主体からのみ設定します(クライアントからは設定しません)。
  • 可観測性。 gateway_mcp_calls_total{server,tool,outcome} は、すべての呼び出し(成功も失敗も)を数えます。呼び出しごとに 1 つの OTel スパン(mcp.tools/call)が、mcp.server / mcp.tool / mcp.org / mcp.agent_id と、最終的な mcp.outcome を運びます。監査ロガーが接続されていなくても、どちらも記録されます。gateway_toolpolicy_decisions_total{org,server,tool,outcome} は、すべての OP-6 ガードレール判定を数えます(allow / deny / mask / flag / error。error はフェイルオープンとなる方針ストアの障害で、呼び出しはガードなしで実行されました)。
  • ツール呼び出しガードレール(OP-6)。 ツールの入力パラメータは、外向き通信前のガードフック(guardhooks.Scan)を通ります。モードは guard_mode(YABANIN_GUARD_MODE: off / log / redact / deny)から継承されます。redact は、検出したシークレット/PII を、外向き通信の前、かつ監査証跡の前に置換します(クライアントの元のパラメータが監査に届くことはありません)。deny は呼び出しを破棄します(409 denied)。それに加えて、サーバごとのガードレールルール(tool_policies.rules)が、引数に対するスキーマ/サイズ/正規表現のチェックと、結果に対する事後チェックを追加します。§7 を参照してください。

現時点の非目標

  • stdio の上流サーバ(ゲートウェイ上でプロセスを生成しません。新たなホストのセキュリティ面になるためです。HTTP-SSE が実証されたあとで再検討します)。
  • 組織をまたぐサーバ共有。サーバは組織ごとです。
  • 比較画面におけるモデルごとのレイテンシ。ダッシュボードのモデル比較画面が表示するのは、モデルごとのシャドウ評価のコスト、組織全体のレイテンシ百分位(モデルごとではないとキャプションされます)、および evalgate でサンプルされた品質セクションです(ADL-04: 判定が重なる範囲の cheap/premium ペアごと、およびタスククラスごと。人が適用する経路の推奨を含みます)。モデルごとのレイテンシは計測されません。

3. アーキテクチャ​

agent (yag_* key, X-Yabanin-Task)
│ POST /api/mcp/invoke {"server":"knowledge","tool":"search","params":{...}}
▼
┌─────────────────────────── gateway proxy (:8082) ───────────────────────────┐
│ 0. agent-only: resolved yag_* principal, else 403 agent_only │
│ 1. server row: enabled? (404 not_found) │
│ 1b. grant: enabled grant for (org, agent, server)? (404 not_found) │
│ 2. tool allowed? server allow-list ∩ grant allow-list (404 not_found) │
│ 2c. toolpolicy guardrails: server-aware deny + args rules │
│ (schema/max_bytes/deny_regex) → 400 mcp_tool_blocked (OP-6) │
│ 3. ssrf: AllowList re-check (400 ssrf_blocked) │
│ 4. guard: guardhooks.Scan(params) → off/log/redact/deny (409 denied) │
│ 5. creds: resolve outbound auth — per-user active → server-level enabled │
│ → none; 401/403 upstream → one force-refresh retry, else lazy │
│ mcp_auth_required with the human flow URL (§6) │
│ 5b. proxy: JSON-RPC tools/call POST → upstream (bounded timeout) │
│ headers: X-Yabanin-Agent-Id / X-Yabanin-Agent-Name / X-Yabanin-Team-Id │
│ 6. record: gateway_mcp_calls_total{server,tool,outcome} + OTel span │
│ + audit event → loggerd → request_logs (task_id, agent_id, upstream_url) │
│ 6b. toolpolicy result post-check (secrets/deny_regex: flag|mask|deny) │
│ → 400 mcp_tool_blocked / redacted result (OP-6) │
└──────────────────────────────────────────────────────────────────────────────┘
▼
external MCP server (HTTP-SSE, e.g. an org's internal knowledge server)

プロキシは ゲートウェイ のデータプレーン(:8082、/api/mcp/... ルートグループ)にあり、admin にはありません。エージェントのトラフィックはデータプレーンです。Admin が mcp_servers の CRUD と、エージェントごとの付与の CRUD を所有します。ゲートウェイは、組織と経路の設定が使うのと同じストア経由で、その両方を読みます。

既定の姿勢は オフ です。ルートグループはコンパイルに含まれますが、マウントされるのは YABANIN_MCP_GATEWAY=1 かつ データベースプールが存在するときだけです。新しい環境変数を設定しない導入は、以前とまったく同じ振る舞いをします。

4. データモデル​

テーブルは 2 つあり、どちらも組織ごとです。

-- Baseline 0001_init: the server registry.
CREATE TABLE mcp_servers (
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
org_id uuid NOT NULL REFERENCES organizations(id) ON DELETE CASCADE,
name text NOT NULL, -- [a-z0-9][a-z0-9_-]*
display_name text,
url text NOT NULL, -- https://… (the SSRF-guarded host)
transport text NOT NULL DEFAULT 'http', -- only 'http' is proxied
allowed_tools jsonb NOT NULL DEFAULT '[]', -- [] = all tools the server offers
enabled boolean NOT NULL DEFAULT false,
created_at timestamptz NOT NULL DEFAULT now(),
updated_at timestamptz NOT NULL DEFAULT now(),
UNIQUE (org_id, name)
);
CREATE INDEX idx_mcp_servers_org ON mcp_servers (org_id) WHERE enabled;

-- Baseline 0001_init: per-agent grants (one row per agent per server).
CREATE TABLE mcp_server_grants (
id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
org_id uuid NOT NULL REFERENCES organizations(id) ON DELETE CASCADE,
agent_id uuid NOT NULL REFERENCES agent_keys(id) ON DELETE CASCADE,
server_name text NOT NULL, -- same name rules as mcp_servers
allowed_tools jsonb NOT NULL DEFAULT '[]', -- [] = every tool the SERVER allows
enabled boolean NOT NULL DEFAULT true,
created_at timestamptz NOT NULL DEFAULT now(),
updated_at timestamptz NOT NULL DEFAULT now(),
UNIQUE (org_id, agent_id, server_name)
);
CREATE INDEX idx_mcp_server_grants_org_agent ON mcp_server_grants (org_id, agent_id) WHERE enabled;
CREATE INDEX idx_mcp_server_grants_org_server ON mcp_server_grants (org_id, server_name) WHERE enabled;

付与は agent_keys.id(エージェント主体)を参照します。付与は認可の事実(誰が何を呼べるか)であり、資格情報ではありません。秘密の実体はありません。無効な付与は、オペレータが有効にするまで不活性です(mcp_servers.enabled と同じく、利用できないものは利用できないと扱う姿勢です)。

マイグレーション 0007 は資格情報のテーブルを追加します。mcp_server_credentials(サーバレベル)と mcp_user_credentials((server, agent) ごと)で、§6 で説明します。

5. エンドポイント​

Admin(コントロールプレーン、root 限定の認証、組織スコープ):

POST /api/organizations/{id}/mcp/servers create server
GET /api/organizations/{id}/mcp/servers list servers
GET /api/organizations/{id}/mcp/servers/{name} get one server
PATCH /api/organizations/{id}/mcp/servers/{name} update (incl. enabled)
DELETE /api/organizations/{id}/mcp/servers/{name} delete server

GET /api/organizations/{id}/mcp/servers/{name}/grants list grants
POST /api/organizations/{id}/mcp/servers/{name}/grants create grant
PATCH /api/organizations/{id}/mcp/servers/{name}/grants/{agent_id} update grant
DELETE /api/organizations/{id}/mcp/servers/{name}/grants/{agent_id} revoke grant

PUT /api/organizations/{id}/mcp/servers/{name}/credential upsert server-level credential
GET /api/organizations/{id}/mcp/servers/{name}/credential read the masked row
DELETE /api/organizations/{id}/mcp/servers/{name}/credential delete

サーバ URL に対する SSRF のドメイン許可リストは、導入の YABANIN_MCP_ALLOWED_UPSTREAMS です(カンマ区切りの完全一致ドメイン、または *.suffix。空はフェイルクローズで、すべてのホストが拒否されます)。付与の作成には、参照するサーバがその組織に存在することが必要です(存在しなければ 404)。一意制約違反の重複では 409 を返します。

ゲートウェイ(データプレーン、エージェント認証 yag_*):

POST /api/mcp/invoke {"server":"knowledge","tool":"search","params":{...}}
→ 200 {tool result} | 401 mcp_auth_required | 403 agent_only | 404 not_found
| 400 ssrf_blocked | 400 mcp_tool_blocked | 409 denied
| 504 timeout | 502 upstream

POST /api/mcp/credentials/{server} headers submit/rotate (per-user, grant ceiling)
POST /api/mcp/auth/{server}/begin oauth: consent URL + pending row
GET /api/mcp/auth/{server}/callback oauth: code exchange (public — the IdP
redirects the human's browser here)

呼び出しエンドポイントは 1 つだけです(サーバごとのパスではありません)。サーバを追加または削除しても、ルートテーブルは安定したままです。サーバは値であり、パスのセグメントではありません。params はツールの入力オブジェクトです。プロキシはこれを、上流の JSON-RPC tools/call リクエストへ直列化します。レスポンスは application/json(単一の結果)または text/event-stream(結果は最後のデータフレーム)のいずれかです。どちらも処理され、最終的な result へ畳み込まれます。ツール呼び出しは、エージェントから見るとリクエスト/レスポンスです(部分的なストリーミングはありません)。

コードHTTP意味
agent_only403呼び出し元が、エージェント主体(yag_*)のキーではありません
mcp_auth_required401上流に使える資格情報がありません(または保存済みのものが失効しています)。ボディは {"error":{"code":"mcp_auth_required","kind":"headers|oauth","url":"/api/mcp/…"}} を運び、それを解決する人向けフローです(§6)
not_found404サーバがない、または無効、またはエージェントの付与がない、またはツールが実効許可リストにありません
ssrf_blocked400URL が、呼び出しごとの SSRF ガードに失敗しました
mcp_tool_blocked400OP-6 の toolpolicy ガードレールが、呼び出しまたはその結果をブロックしました(deny 方針、引数のスキーマ/最大サイズ/正規表現ルール、または deny モードの結果事後チェック)。メッセージが示すのは失敗したチェックの名前だけで、一致した値は決して示しません
denied409パラメータガード(deny モード)が、パラメータを拒否しました
timeout504上流が、読み取り/接続のタイムアウトを超えました
upstream502上流が、非 2xx または不正なボディを返しました

6. 上流の資格情報(MC-1..3)​

上流の MCP サーバは、認証を要求することがあります。アグリゲータは、呼び出しのたびに、固定の連鎖 — ユーザーごと(active)→ サーバレベル(enabled)→ なし — で外向きの資格情報を解決します。資格情報が外向きの面を広げることはありません。サーバ URL に対する SSRF 許可リストの検査は、資格情報の解決より前に実行されます。そのため、登録されていても許可されていないホストは、資格情報があってもなくても、ブロックされたままです。

認証の種類​

認証の種類誰が設定するか呼び出し時の解決
none (-)—呼び出しは未認証のまま進みます(従来の姿勢)。決めるのは上流の判定です
headers(サーバレベル)admin が admin API 経由で設定します(PUT …/credential)有効なとき、すべてのエージェントの呼び出しに適用されます
headers(ユーザーごと)エージェントの担当者が、遅延フロー経由で設定します(POST /api/mcp/credentials/{server})active のとき、その (server, agent) ペアにだけ適用されます
oauth(サーバレベルまたはユーザーごと)admin、または遅延の begin/callback フローアクセストークンが適用されます。上流の 401/403 は、ちょうど 1 回の強制リフレッシュ再試行を引き起こします。失効したトークンは needs_reauth になります(再認証するまで残ります)

遅延認可(mcp_auth_required)​

使える資格情報がないとき(または保存済みのものが失効しているとき)、呼び出しは構造化されたボディ付きの 401 で応答します。

{"error": {"code": "mcp_auth_required", "kind": "headers",
"url": "/api/mcp/credentials/knowledge"}}

kind は、そのサーバを満たす資格情報の種類を示します(headers → submit エンドポイント、oauth → begin エンドポイント)。url は、人がそのフローを開始するための相対パスです。submit/begin フローには、エージェント主体(yag_)のキーが必要で、X-Audit-Reason を尊重します。

ライフサイクルのステータス(ユーザーごとの資格情報)​

ステータス意味
pending遅延フローが開始済みです(oauth の同意が保留中)
active解決され、呼び出しで使われます
orphanedサーバ上の付与が取り消されました。資格情報は不活性です。再付与すると復元されます(RestoreMCPUserCredentials)
needs_reauth上流がトークンを最終的に拒否しました(再認証するまで残ります)
needs_update上流の変更のあと、保存済みのシークレットが検証に失敗しました

version は、ローテーションまたはステータス遷移のたびに増えます。これにより、ゲートウェイのリゾルバキャッシュは直ちに無効になります。

セキュリティ不変条件​

  • 平文の秘密実体が存在するのは、store/resolve メソッドへの呼び出し引数としてだけです。すべての読み取りが返すのは、マスクされた行だけです(secret_last4、has_secret)。API レスポンスが平文や暗号文を運ぶことはなく、それを保持できる構造体フィールドもありません。
  • シークレットは、enc: 接頭辞付きのエンベロープで保存時に暗号化されます(pkg/encryption、BYOK と同等、マイグレーション 0007 のテーブル)。書き込みはフェイルクローズです。設定された暗号化器がなければ、書き込みは拒否されます。暗号化設定の欠落が、黙って平文へ降格することはありません。
  • すべての操作は、app.current_org GUC が固定された 1 つのトランザクションで実行されます。これは org_isolation の RLS 契約です(ENABLE + FORCE、最小権限のロール)。他の組織の行は見えず、書き込むこともできません。
  • すべての CRUD/ステータスの手順は、ハッシュ連鎖の監査ジャーナルに記録されます。
  • 平文には上限があります(シークレットのペイロードあたり 8 KiB)。プロキシがログに書いたり、直列化したりすることはありません。
  • ユーザーごとの upsert には、そのサーバ上の有効な付与が必要です。付与は、すべてのフロー手順における上限のままです(エージェントガバナンス を参照)。

7. ツール呼び出しガードレール(OP-6)​

単なる許可/拒否のレジストリ(ツール方針)に加えて、tool_policies の行は、(組織、サーバ、ツール、主体)の粒度で評価される rules ドキュメントを持てます。

  • 引数ガードは、外向き通信の前に実行されます。対象は、直列化された引数に対する JSON-Schema(draft 2020-12)、max_bytes のサイズ上限、および deny_regex の RE2 パターンです。違反があると、上流へのトラフィックより前に、400 mcp_tool_blocked で呼び出しがブロックされます。
  • 結果の事後チェックは、直列化された上流の結果に対して実行されます。対象は、guardhooks のシークレット/PII/インジェクション検出器と、ルールごとのモード flag | mask | deny を持つカスタム deny_regex です。mask は伏字化された結果を返し、deny は 400 mcp_tool_blocked で破棄します。

一致するルールは、和集合 + 最も制限的に合成されます(ルールが追加できるのは制限だけです)。すべての指摘が運ぶのは、チェックの出所と、スパン/JSON ポインタだけです。一致した値が、エラー、指摘、メトリクスに現れることはありません。失敗モードはルールごとです(fail: closed|open、既定は closed)。組織がフェイルクローズのルールを一度宣言すると、方針ストアの障害は、ストアが復旧するまで、ガードされた呼び出しをブロックします。どの行にも rules がなければ、ガードレール前の振る舞いと、ビット単位で同じです。

判定は gateway_toolpolicy_decisions_total{org,server,tool,outcome} で数えられます(error はフェイルオープンとなる方針ストアの障害です。呼び出しはガードなしで実行されました)。

8. リスクマトリクス​

#リスク深刻度緩和
R1SSRF: 組織が http://169.254.169.254/…、またはクラウドのメタデータ/内部サービスを指す DNS リバインディングのホストを登録する高pkg/ssrf の AllowList.ValidateUpstream(DNS 許可リスト + 予約 IP の拒否)を、登録時と、再度 呼び出しのたびに適用します(リバインドの窓)。リダイレクトは追いません。ドメイン向けの静的な導入許可リスト(YABANIN_MCP_ALLOWED_UPSTREAMS)
R2プロンプトインジェクション/ツールの武器化: モデルが誘発したツール呼び出しが、悪意のある外部サーバのツールスキーマまたはパラメータを介して、組織のデータを持ち出します高エージェント限定のアクセス、エージェントごとの付与、サーバごとのツール許可リスト(共通部分)、パラメータに対するガードフック、組織の toolpolicy による拒否方針 + 外向き前の引数ルール(スキーマ/最大サイズ/正規表現)、既定 OFF、伏字化されたパラメータ付きの監査証跡。エージェントごとの予算が、繰り返し呼び出しの影響範囲を抑えます
R3シークレットの流出: パラメータが、組織の API キー/PII を外部サーバへ運びます中外向きの前に、guard_mode に従う redact/deny モードの guardhooks.Scan(国別の PII 検出器を含む)。deny は 409 と監査イベント付きで呼び出しを破棄します。OP-6 の結果事後チェック(シークレット検出器、ルールごとの flag/mask/deny)が、シークレットを含んだツールの結果がエージェントへ届くのを止めます
R4資格情報の漏えい: サーバごとの上流トークンを Postgres に保存すること中シークレットは、保存時に enc: で暗号化されたエンベロープだけです(暗号化器がなければ書き込みはフェイルクローズ)。RLS による組織の分離(app.current_org GUC)。読み取りが返すのはマスクされた行だけです(secret_last4/has_secret。平文が API を越えることはありません)。すべての CRUD/ステータス手順は、ハッシュ連鎖の監査ジャーナルに入ります。資格情報が外向きを広げることはありません(SSRF の検査が解決より先です)(§6)
R5サービス拒否/コスト: エージェントがツール呼び出しをループします。上流は呼び出しごとに課金します中継承される、エージェントごとのトークン/支出の予算。上限のあるプロキシの接続タイムアウトと読み取りタイムアウト。gateway_mcp_calls_total がループ率を可視化します
R6アイデンティティの偽装: 上流が、組織自身のエージェントによって偽造された X-Yabanin-Agent-* ヘッダを信頼します低ヘッダは帰属であり、認可ではありません。ゲートウェイは、これらのヘッダについて、呼び出し元が供給した値を転送しません(入口で取り除き、検証済みのエージェント主体から設定します)
R7監査の欠落: ツール呼び出しは発生しますが、ログされません中呼び出しは、監査の成否にかかわらず応答されます(可用性を監査より優先)。監査の公開が破棄されても、gateway_mcp_calls_total メトリクスと OTel スパンは記録されるため、欠落は見えます
R8SSE ストリームの乗っ取り/slow-loris の上流低SSE ボディの読み取りタイムアウトに上限、レスポンスサイズの上限、ユーザーが指定したホストに対して、標準プールを超えるアイドル keep-alive の再利用はしません
R9依存関係: HTTP-SSE 向けの MCP クライアント面低トランスポート層を差し替えられるよう、薄いクライアントラッパ(HTTP/SSE 上の JSON-RPC)。変更のたびにセキュリティゲートがかかります
R10stdio 上流へのスコープの肥大(ゲートウェイ上でのプロセス生成)中明示的な非目標(§2)。stdio は外向きブリッジ専用のままです

9. セキュリティ不変条件(アグリゲータの変更のたびに、リポジトリのセキュリティゲートが検査する)​

  1. ユーザーが制御する URL が、SSRF ガードを 2 回(登録 + 呼び出し)通さずに http.Client へ到達することはありません。しかも常に、資格情報の解決より前です。資格情報が外向きを広げることはできません。
  2. 資格情報のシークレットは、enc: エンベロープとしてのみ保存され、組織分離の RLS のもとで、マスクされた行(secret_last4/has_secret)としてのみ読み戻されます。すべての変更は監査されます。秘密の実体が mcp_servers / mcp_server_grants に保存されることはなく、伏字化されずにログされることもありません。監査イベントは params-redacted を運びます。
  3. エージェントのアイデンティティは、検証済みの yag_* 主体からのみ来ます。X-Yabanin-Agent-* ヘッダはプロキシが設定し、受信リクエストから取り除かれます。
  4. 機能は既定で OFF です(YABANIN_MCP_GATEWAY が未設定 ⇒ ルートグループはマウントされない ⇒ 振る舞いの変化はゼロ)。

10. 設定リファレンス​

環境変数既定意味
YABANIN_MCP_GATEWAY未設定(オフ)1 は /api/mcp/invoke ルートグループをマウントします(DB プールが必要です)。
YABANIN_MCP_ALLOWED_UPSTREAMS空上流 URL のホストが一致しなければならない、カンマ区切りの完全一致ドメインまたは *.suffix。空はフェイルクローズです(すべてのホストが拒否されます)。
YABANIN_GUARD_MODEoffoff / log / redact / deny。ツール入力に適用されるパラメータガードのモードです(チャット経路のガードフックから継承されます)。

導入の配線(OP-25 F-5): admin サービスは、環境から YABANIN_MCP_ALLOWED_UPSTREAMS を解析します(config.Load("") は環境変数のみです。マウントされた config.yaml は読まれません)。そして、そのリストをレジストリの CRUD へ渡します。ゲートウェイは、呼び出し時の再検査、資格情報トークン URL のガード、およびサーバ側のツール実行器のために、同じ変数を解析します。1 つのリストが、登録とすべての外向き接続を支配します。compose の導入では、この変数を admin サービスと gateway サービスの両方へ渡す必要があります(deploy/docker-compose.prod.yml と deploy/.env.example がこれを行います)。空または未設定のとき、登録は 400(host not in the allowed domains list)で応答します。これは設計上のフェイルクローズであり、故障ではありません。

11. 受け入れ概要​

コンポーネント受け入れ
レジストリ + プロキシadmin での mcp_servers CRUD。HTTP-SSE 向けの呼び出しプロキシ。既定 OFF。登録と呼び出しでの SSRF ガード。上限のあるタイムアウト。テストは、リダイレクト拒否、予約 IP、タイムアウトをカバーします
アクセス + 監査呼び出しは、yag_ 以外のキー(403 agent_only)と、付与されていないエージェント/サーバ/ツール(404)を拒否します。すべての呼び出し → task_id/agent_id/upstream_url 付きの request_logs 行 + 監査イベント(伏字化されたパラメータ)。ラベルは mcp:<server>:<tool>。付与の CRUD は admin にあります
アイデンティティ上流は X-Yabanin-Agent-Id / -Name / X-Yabanin-Team-Id を受け取ります。受信側のコピーは取り除かれます。値は検証済みの主体から来ます
可観測性/metrics 配下に gateway_mcp_calls_total{server,tool,outcome} があります。呼び出しごとに 1 つの OTel スパン(mcp.tools/call)があり、server/tool/outcome の属性を持ちます
パラメータガードパラメータは guardhooks.Scan を通ります。redact モードはシークレットを置換します。deny モードは呼び出しを破棄します(409)+ 監査。モードは guard_mode から継承されます
ツール呼び出しガードレール(OP-6)tool_policies.rules(外向き前の引数スキーマ/max_bytes/deny_regex。外向き後の結果におけるシークレット/正規表現の flag/mask/deny)。スキーマ違反 → 上流トラフィックより前の 400 mcp_tool_blocked。結果内のシークレット → ルールに従いマスクまたは拒否。指摘が運ぶのはスパン/カテゴリだけです(値なし。テストで固定)。Decide/Guard の並行性で -race は緑です。組織のルールは組織ごとに分離されます
上流の資格情報(MC-1..3)サーバレベル + ユーザーごとの資格情報は、組織分離の RLS のもとで enc: エンベロープです。読み取りはマスクのみです。呼び出しの解決順は、ユーザーごと → サーバレベル → なしで、リフレッシュ再試行は 1 回です。人向けフローの URL 付きの遅延 mcp_auth_required。付与の上限 + 孤立化/復元。すべての CRUD/ステータス手順で監査ジャーナル
モデル比較画面ダッシュボードの比較画面(#compare): モデルごとのシャドウ評価コスト + 組織全体のレイテンシ(モデルごとではないとキャプション)+ ペア/タスククラスごとの evalgate サンプル品質(ADL-04)。人が適用する経路の推奨付き。適用スコープのキャプション。すべてのビューポートで描画されます