@@ -21,9 +21,10 @@ quickly using a local kind cluster. Try it out and
2121The operator introduces new Custom Resource Definitions (CRDs) into your
2222Kubernetes cluster. The primary CRDs for MCP server workloads are ` MCPServer ` ,
2323which represents a single MCP server running in Kubernetes, ` MCPRemoteProxy ` ,
24- which represents an MCP server running outside the cluster that is proxied by
25- ToolHive, and ` VirtualMCPServer ` , which represents a virtual MCP server gateway
26- that aggregates multiple backend MCP servers.
24+ which represents an MCP server hosted outside the cluster that ToolHive proxies,
25+ ` VirtualMCPServer ` , which aggregates multiple backend MCP servers behind a
26+ single endpoint, and ` MCPServerEntry ` , which declares a remote MCP server as a
27+ catalog entry without creating any pods or infrastructure.
2728
2829All ToolHive CRDs are registered under the ` toolhive ` category, so you can list
2930every ToolHive resource in your cluster with a single command:
@@ -67,19 +68,30 @@ or Gateway. To learn how to expose your MCP servers and connect clients, see
6768
6869## Which resource type should I use?
6970
70- The operator introduces three resource types for MCP workloads. Choose based on
71+ The operator introduces resource types for MCP workloads. Choose based on
7172where your MCP server runs and how many servers you need to manage:
7273
73- | Resource | Use when |
74- | -------------------- | ----------------------------------------------------------------------------------------------------------------- |
75- | ** MCPServer** | Running an MCP server as a container inside your cluster |
76- | ** MCPRemoteProxy** | Connecting to an MCP server hosted outside your cluster (SaaS tools, external APIs, remote endpoints) |
77- | ** VirtualMCPServer** | Aggregating multiple MCPServer and/or MCPRemoteProxy resources behind a single endpoint for a team or application |
74+ | Resource | Use when |
75+ | ----------------------- | ----------------------------------------------------------------------------------------------------------------- |
76+ | ** MCPServer** | Running an MCP server as a container inside your cluster |
77+ | ** MCPRemoteProxy** | Connecting to an MCP server hosted outside your cluster (SaaS tools, external APIs, remote endpoints) |
78+ | ** VirtualMCPServer** | Aggregating multiple MCPServer and/or MCPRemoteProxy resources behind a single endpoint for a team or application |
79+ | ** MCPServerEntry** | Declaring a remote MCP server endpoint as a catalog entry without spawning proxy pods (no infrastructure created) |
7880
7981Most teams start with ` MCPServer ` for container-based servers, add
8082` MCPRemoteProxy ` for external SaaS tools, and graduate to ` VirtualMCPServer `
8183when managing five or more servers or needing centralized authentication.
8284
85+ :::note
86+
87+ ` MCPServerEntry ` is a new resource type added in v0.16.0. The CRD is available
88+ and you can create resources, but the reconciliation controller ships in a
89+ future release. Creating ` MCPServerEntry ` resources before the controller is
90+ available has no effect — the operator will not reconcile them until the
91+ controller ships.
92+
93+ :::
94+
8395The operator also provides shared configuration CRDs that you reference from
8496workload resources:
8597
0 commit comments