MCP Gateway — это обратный прокси и уровень управления для серверов Model Context Protocol (MCP), позволяющий масштабируемую, бессостоятельную маршрутизацию запросов, авторизацию и управление жизненным циклом MCP серверов в средах Kubernetes.

Неисправные изменения: для этой версии требуются MCP 2026-07-28 клиенты и адаптеры. Она не предоставляет инициализацию устаревшей, транспортные сессии или понижение протокола. См. руководство по миграции для требований клиента, примеров запросов, настроек развертывания и вопросов отката.

Содержание

• Обзор
• Ключевые концепции
• Архитектура
• Особенности
• Начало работы — локальное развертывание
• Начало работы — развернуть Azure в 1 клик

Обзор

Этот проект предусматривает:

• Шлюз данных для независимой маршрутизации каждого MCP-запроса к готовому серверу.
• Управляющая плоскость для управления жизненным циклом MCP-сервера (развертывание, обновление, удаление).
• Точки интеграции, готовые к корпоративному использованию, включая телеметрию, контроль доступа и наблюдаемость.

Ключевые концепции

• MCP Server: сервер, реализующий протокол Model Context Protocol, который обычно является потоковой 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"]