Skip to content

Commit 26bc235

Browse files
committed
Add guided entry to K8s and vMCP index pages, remove duplicate vMCP content
1 parent 1696adc commit 26bc235

2 files changed

Lines changed: 29 additions & 16 deletions

File tree

docs/toolhive/guides-k8s/index.mdx

Lines changed: 20 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,11 +9,26 @@ import DocCardList from '@theme/DocCardList';
99

1010
## Introduction
1111

12-
The ToolHive Kubernetes operator manages MCP servers in Kubernetes clusters. It
13-
provides a way to deploy, manage, and scale MCP servers in multi-user
14-
environments. By defining MCP servers as Kubernetes resources, the operator
15-
automates their deployment and management, making it easier to run MCP servers
16-
in multi-user environments.
12+
The ToolHive Kubernetes Operator manages MCP servers in Kubernetes clusters. You
13+
define MCP servers as Kubernetes custom resources and the operator automates
14+
their deployment, proxying, and lifecycle management. The operator supports
15+
three resource types:
16+
17+
- **MCPServer** — run a containerized MCP server inside your cluster
18+
- **MCPRemoteProxy** — proxy an MCP server hosted outside your cluster
19+
- **VirtualMCPServer** — aggregate multiple servers behind a single endpoint
20+
21+
## Where to start
22+
23+
- **New to ToolHive on Kubernetes?** Start with the
24+
[Quickstart](./quickstart.mdx) to deploy your first MCP server on a local kind
25+
cluster.
26+
- **Operator already installed?** Jump to [Run MCP servers](./run-mcp-k8s.mdx),
27+
[Proxy remote MCP servers](./remote-mcp-proxy.mdx), or set up a
28+
[Virtual MCP Server](../guides-vmcp/index.mdx).
29+
- **Not sure which resource type to use?** See the
30+
[decision guide](./intro.mdx#which-resource-type-should-i-use) in the
31+
Introduction.
1732

1833
## Contents
1934

docs/toolhive/guides-vmcp/index.mdx

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -7,17 +7,15 @@ Virtual MCP Server (vMCP) is a feature of the ToolHive Kubernetes Operator that
77
aggregates multiple backend MCP servers into a single endpoint, enabling unified
88
tool access, centralized authentication, and multi-step workflows.
99

10-
## When to use vMCP
11-
12-
- You manage multiple MCP servers that should appear as one
13-
- You need to centralize authentication across backends
14-
- You want to create reusable workflows spanning multiple systems
15-
16-
## Get started
17-
18-
- [Understanding Virtual MCP Server](../concepts/vmcp.mdx) - Learn what vMCP
19-
does and when to use it
20-
- [Quickstart: Virtual MCP Server](./quickstart.mdx) - Deploy your first vMCP
10+
## Where to start
11+
12+
- **Evaluating vMCP?** Read
13+
[Understanding Virtual MCP Server](../concepts/vmcp.mdx) for the full picture
14+
of what it does and when it's the right fit.
15+
- **Ready to try it?** Follow the [Quickstart](./quickstart.mdx) to deploy your
16+
first vMCP on a local kind cluster.
17+
- **Already running vMCP?** Jump to [Configuration](./configuration.mdx) or
18+
[Authentication](./authentication.mdx).
2119

2220
## Contents
2321

0 commit comments

Comments
 (0)