AI Gateway すべてのAIプロバイダーとMCPサーバーのトラフィックを単一の AI Gateway アドレスに送ることができます。 各プロバイダー AI Gateway リクエストを使うリクエストヘッダーにルーティングするべきかを指示し、プロバイダーごとに別々のエンドポイントに頼るのではなく、
シングルエンドポイントサポートの前後のルーティングリクエスト
この例は、プロバイダー固有のルーティングとシングルエンドポイントモデルを比較しています。以前は、各AIプロバイダーが独自のエンドポイントパスを必要としていました。シングルエンドポイント対応により、すべてのリクエストは同じベースパスを使うでき、 x-ns-aig-slug ヘッダーはリクエストをルーティングすべきプロバイダーまたはMCPサーバー AI Gateway 特定します。
Before — a separate path per provider
curl https://<your-ai-gateway-fqdn>/v1/openai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <api-key>" \
-d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Hello"}]}'
After — one path, header picks the provider
curl https://<your-ai-gateway-fqdn>/v1/chat/completions \
-H "Content-Type: application/json" \
-H "x-ns-aig-slug: openai" \
-H "Authorization: Bearer <api-key>" \
-d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Hello"}]}'
同じリクエストを別のプロバイダにルーティングするには、宛先を変更せずに、x-ns-aig-slug にそのプロバイダのスラッグを設定します。他に変更は必要ありません。
ルーティングヘッダー
| Header name | Header value | 適用対象 |
|---|---|---|
x-ns-aig-slug | プロバイダーのスラッグ — AI Gateway セットアップページのAIプロバイダー列(またはMCPタブ)に表示されている名前と同じです | AIプロバイダー(LLMトラフィック)とMCPサーバーは AI Gateway |
各プロバイダーまたはMCPサーバーのスラッグは、NetskopeUIのAI Gatewayセットアップページで見つけられます。そこに表示されている名前と一致しているので、別途値を作成したり調べたりする必要はありません。これは、プロバイダーが事前定義されたもの(例えば、AWS Bedrock)、カスタムプロバイダー、または汎用的な「その他」スキーマで構成されたもののいずれにも適用されます。
使う MCP サーバーで
単一のエンドポイントは、AI Gateway背後にあるモデルコンテキストプロトコル(MCP)サーバーでも同様に動作します。リクエストをAI Gatewayアドレスに送信し、AI GatewayセットアップページのMCPタブに表示されるMCPサーバーのスラッグにx-ns-aig-slugを設定します。
MCP servers that require OAuth
OAuth経由で認証するMCPクライアントは、発見リクエストにカスタムヘッダーを持たないため、OAuthディスカバリーフローのために使うヘッダーベースのルーティングを行うことはできません。 MCPサーバーがOAuthを要求する場合は、その接続に対してプロバイダー固有の完全な宛先URLを送信し続けてください。ヘッダーベースのルーティングは、トークン取得後に通常通り適用されます。
MCP clients and duplicate server URLs
一部のMCPクライアントアプリケーションは、同じURLを持つ複数のサーバーを単一の接続として扱い、ヘッダーに関係なく最初のサーバーのみを使うことがあります。 同じアドレスの背後に複数の MCP サーバーをデプロイする前に、MCP クライアントのドキュメントを確認し、ヘッダーによってサーバーを区別できることを確認してください。

