MCPゲートウェイは、モデルコンテキストプロトコル(MCP)サーバー向けのリバースプロキシおよび管理層であり、Kubernetes環境におけるMCPサーバーのスケーラブルでステートレスなリクエストルーティング、認可およびライフサイクル管理を可能にします。

変更変更: このバージョンではMCP 2026-07-28クライアントとアダプターが必要です。レガシー初期化、トランスポートセッション、プロトコルダウングレードは提供されません。クライアント要件、リクエスト例、デプロイ設定、ロールバックの考慮事項については移行ガイドをご覧ください。

目次

• 概要
• 主要概念
• 建築
• 特徴
• はじめ – ローカル展開
• はじめ – 1クリックでAzureにデプロイ

概要

このプロジェクトは以下の内容を提供します:

• 各MCPリクエストを独立して準備済みサーバーインスタンスにルーティングするためのデータゲートウェイ。
• MCPサーバーのライフサイクル(展開、更新、削除)を管理するコントロールプレーン。
• テレメトリ、アクセス制御、観測性を含むエンタープライズ対応の統合ポイント。

主要概念

• MCPサーバー:モデルコンテキストプロトコルを実装するサーバーで、通常はストリーミング可能なHTTPエンドポイントです。

MCP Gateway

MCP Gateway is a reverse proxy and management layer for Model Context Protocol (MCP) servers, enabling scalable, stateless request routing, authorization and lifecycle management of MCP servers in Kubernetes environments.

Breaking change: this version requires MCP 2026-07-28 clients and adapters. It does not provide legacy initialization, transport sessions, or protocol downgrade. See the migration guide for client requirements, request examples, deployment settings, and rollback considerations.

Table of Contents

• Overview
• Key Concepts
• Architecture
• Features
• Getting Started – Local Deployment
• Getting Started – 1-Click Deploy to Azure

Overview

This project provides:

• A data gateway for independently routing each MCP request to a ready server instance.
• A control plane for managing the MCP server lifecycle (deploy, update, delete).
• Enterprise-ready integration points including telemetry, access control and observability.

Key Concepts

• MCP Server: A server implementing the Model Context Protocol, which typically a streamable HTTP endpoint.
• Adapters: Logical resources representing MCP servers in the gateway, managed under the /adapters scope. Designed to coexist with other resource types (e.g., /agents) in a unified AI development platform.
• Tools: Registered resources with MCP tool definitions that can be dynamically routed via the tool gateway router. Each tool includes metadata about its execution endpoint and input schema.
• Tool Gateway Router: An MCP server that directs tool execution requests to registered tool servers based on tool definitions. Multiple router instances can handle requests without transport-session affinity.
• Stateless MCP Routing: Each request carries its protocol metadata and is independently authorized. Legacy session headers and the gateway’s session_id query alias do not determine routing.
• Agents & Sessions (Preview): Optional, opt-in resources for running LLM-driven agents on top of registered MCP tools. Agents are metadata (system prompt + model + allowed tool list); Sessions are individual runs that stream events over Server-Sent Events. Disabled unless FoundrySettings:Endpoint is configured.

Architecture

flowchart LR
    subgraph Clients[" "]
        direction TB
        DataClient["🔌 Agent/MCPData Client"]
        MgmtClient["⚙️ ManagementClient"]
    end

    subgraph Gateway["MCP Gateway"]
        direction TB
        
        subgraph Auth1["Authentication & Authorization"]
            Auth["🔐 Data Plane AuthBearer Token / RBAC"]
            Auth2["🔐 Control Plane AuthBearer Token / RBAC"]
        end
        
        subgraph DataPlane["Data Plane"]