仮想ランタイム

agentgateway 仮想ランタイムを使用して、レジストリからリモート MCP サーバーを公開します。

Solo Enterprise for agentgateway をインストールし、Solo Enterprise for agentregistry の仮想ランタイムとして設定します。仮想ランタイムは Kubernetes Gateway API のルート委任モデルを使用します。ゲートウェイ管理者が親 Gateway と HTTPRoute を一度作成し、レジストリネームスペースへの委任を許可します。その後、レジストリユーザーはゲートウェイ管理者から追加の入力を受けることなく、MCP サーバーを追加してゲートウェイで公開できます。

始める前に

OIDC プロバイダーをセットアップします。このガイドでは、Keycloak をインストール済みであることを前提としています。必要なレルム設定、クライアント、シークレットを含めて Keycloak をインストールするには、General setup タブの手順に従ってください。
Solo Enterprise for agentregistry と arctl CLI をインストールします。

ステップ 1: Solo Enterprise for agentgateway をインストールする

Solo Enterprise for agentgateway のライセンスキーを環境変数に保存します。キーを取得するには、アカウント担当者にお問い合わせください。
```
kubectl get pods -n agentgateway-system | grep agentgateway-proxy
```
Solo Enterprise for agentgateway のバージョンを設定します。
```
export AGENTGATEWAY_VERSION=v2026.9.3
```
Gateway、HTTPRoute、および関連リソースを含む標準 Gateway API CRD をインストールします。
```
kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.6.1/standard-install.yaml
```

Solo Enterprise for agentgateway CRD をインストールします。

helm upgrade -i enterprise-agentgateway-crds \
  oci://us-docker.pkg.dev/solo-public/enterprise-agentgateway/charts/enterprise-agentgateway-crds \
  --create-namespace \
  --namespace agentgateway-system \
  --version "${AGENTGATEWAY_VERSION}"

Solo Enterprise for agentgateway のコントローラーとデータプレーンをインストールします。

helm upgrade -i enterprise-agentgateway \
  oci://us-docker.pkg.dev/solo-public/enterprise-agentgateway/charts/enterprise-agentgateway \
  -n agentgateway-system \
  --version "${AGENTGATEWAY_VERSION}" \
  --set-string licensing.licenseKey="${AGENTGATEWAY_LICENSE_KEY}"

コントロールプレーン Pod が実行中であることを確認します。

kubectl get pods -n agentgateway-system

出力例:

NAME                                                     READY   STATUS    RESTARTS   AGE
enterprise-agentgateway-controller-7d9f8b6d4c-xvpzk     1/1     Running   0          45s

ステップ 2: Gateway と親 HTTPRoute を作成する

agentgateway プロキシが MCP トラフィックを受け入れるために使用する Gateway と親 HTTPRoute を作成します。レジストリがそれらを検出し、各 Deployment の exposedAt URL を設定できるように、両方のリソースに agentregistry.solo.io/runtime: mcp-gateway ラベルを付ける必要があります。

Gateway を作成します。

kubectl apply -f - <<EOF
apiVersion: gateway.networking.k8s.io/v1
kind: Gateway
metadata:
  name: agentgateway-proxy
  namespace: agentgateway-system
  labels:
    agentregistry.solo.io/runtime: mcp-gateway
spec:
  gatewayClassName: enterprise-agentgateway
  listeners:
  - protocol: HTTP
    port: 80
    name: http
    allowedRoutes:
      namespaces:
        from: All
EOF

Note

この例では、簡単にするために HTTP リスナーを使用します。本番デプロイでは通常、TLS 証明書を使用する HTTPS リスナーを追加します。

/registry パスプレフィックスのトラフィックを、レジストリが agentregistry-system ネームスペースに作成するすべての子 HTTPRoute に委任する親 HTTPRoute を作成します。

kubectl apply -f - <<EOF
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: agentregistry-delegate
  namespace: agentgateway-system
  labels:
    agentregistry.solo.io/runtime: mcp-gateway
spec:
  parentRefs:
  - name: agentgateway-proxy
  rules:
  - matches:
    - path:
        type: PathPrefix
        value: /registry
    backendRefs:
    - group: gateway.networking.k8s.io
      kind: HTTPRoute
      name: "*"
      namespace: agentregistry-system
EOF

ゲートウェイプロキシ Pod が実行中であることを確認します。

kubectl get pods -n agentgateway-system | grep agentgateway-proxy

出力例:

agentgateway-proxy-64c4bf7c4c-gzfhj   1/1     Running   0          93s

ステップ 3: 仮想ランタイムを登録する

Solo Enterprise for agentregistry で Virtual ランタイムを作成します。name フィールドは、前のステップで Gateway と親 HTTPRoute に設定した agentregistry.solo.io/runtime ラベル値と一致する必要があります。

ランタイムを作成します。

arctl apply -f - <<EOF
apiVersion: ar.dev/v1alpha1
kind: Runtime
metadata:
  name: mcp-gateway
spec:
  type: Virtual
EOF

出力例:

✓ Runtime/mcp-gateway created

ランタイムがカタログに表示されることを確認します。

arctl get runtimes

出力例:

NAME                 TYPE
kubernetes-default   Kubernetes
local                Local
mcp-gateway          Virtual
virtual-default      Virtual

次のステップ

仮想ランタイムを配置したら、MCP サーバーをカタログに登録し、ゲートウェイ経由で公開します。次のクイックスタートでは、JWT 認証、グループレベルのアクセス制御、ユーザーごとのツールフィルタリング、レートリミットを含む完全なセットアップをエンドツーエンドで説明します。

MCP サーバーを公開して保護するリモート MCP サーバーを登録し、ゲートウェイ経由で公開して、その上に JWT 認証、CEL アクセスポリシー、レートリミットを重ねて適用します。

Solo Enterprise for kagent