Microsoft MCP Gateway — インストール & ライブデモ

Name: Microsoft MCP Gateway MCP Server
Author: microsoft

なぜ使うのか

主な機能

Session-affinity routing for stateful MCP servers
Per-tenant isolation and quota
Centralized OAuth/OIDC at the gateway edge
Health probes + auto-restart of backend servers
Helm chart for Kubernetes deployment

ライブデモ

実際の動作

microsoft-mcp-gateway.replay ▶ 準備完了

0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "microsoft-mcp-gateway": {
      "command": "mcp-gateway",
      "args": [
        "serve"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "microsoft-mcp-gateway": {
      "command": "mcp-gateway",
      "args": [
        "serve"
      ]
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "microsoft-mcp-gateway": {
      "command": "mcp-gateway",
      "args": [
        "serve"
      ]
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "microsoft-mcp-gateway": {
      "command": "mcp-gateway",
      "args": [
        "serve"
      ]
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "microsoft-mcp-gateway",
      "command": "mcp-gateway",
      "args": [
        "serve"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json

{
  "context_servers": {
    "microsoft-mcp-gateway": {
      "command": {
        "path": "mcp-gateway",
        "args": [
          "serve"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add microsoft-mcp-gateway -- mcp-gateway serve

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方： Microsoft MCP Gateway

Stand up an internal MCP catalog with one auth boundary

👤 Platform engineering teams ⏱ ~15 min intermediate

使うタイミング： You have 10+ MCP servers and need centralized auth, quotas, and observability.

前提条件

Server/skill installed and authenticated — See repo README

フロー

Deploy the gateway

Generate Helm values for mcp-gateway with our Entra OIDC issuer and three backend MCPs: github, jira, snowflake.✓ コピーしました

→ values.yaml + helm command
Register

Register each backend and assign it to the 'engineering' tenant with a 1000 req/hr quota.✓ コピーしました

→ Three backend ids + quota set

結果： One URL, one OIDC, many MCPs — properly governed.

注意点

Session affinity is critical for stateful servers. If you switch to a stateless backend, also disable affinity to avoid hotspots. — Session affinity is critical for stateful servers. If you switch to a stateless backend, also disable affinity to avoid hotspots.

組み合わせ： containers/kubernetes-mcp-server

組み合わせ

他のMCPと組み合わせて10倍の力を

microsoft-mcp-gateway + containers/kubernetes-mcp-server

Pair with containers/kubernetes-mcp-server for complementary capabilities

Use this server together with containers/kubernetes-mcp-server to complete a multi-step task.✓ コピーしました

ツール

このMCPが提供する機能

ツール	入力	呼び出すタイミング	コスト
list_backends	(none)	See registered MCP servers	1 API call
register_backend	name, image, env	Add a new MCP server behind the gateway	K8s scheduling
tenant_quota	tenant_id	Inspect or adjust per-tenant limits	1 API call

コストと制限

運用コスト

APIクォータ: See provider docs for rate limits
呼び出しあたりのトークン: Varies by tool
金額: See repo README for pricing details
ヒント: Cache tool results and avoid repeated identical calls.

セキュリティ

権限、シークレット、影響範囲

認証情報の保管： Use environment variables; never commit secrets

データ送信先： Tool calls go to the provider's API as documented

トラブルシューティング

よくあるエラーと対処法

backend unhealthy

Gateway probes GET /healthz. Make sure your MCP server implements it or update healthCheck.path.

確認： kubectl get pods -n mcp

OIDC validation fails

Issuer URL must match the token's iss claim exactly, including trailing slash. Recheck Entra app config.

確認： Decode token at jwt.ms

代替案

Microsoft MCP Gateway 他との比較

代替案	代わりに使う場面	トレードオフ
agentic-community/mcp-gateway-registry	You prefer the community OSS option	Less Azure-native

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る