Skip to content

Commit 4b2f1e0

Browse files
JAORMXclaude
andcommitted
Address PR feedback for Virtual MCP documentation
- Change title from "Virtual MCP architecture" to "Understanding Virtual MCP Server" to better reflect user-focused content - Remove specific percentages (90%, 87%) that sound LLM-generated - Simplify authentication section: reference MCP spec mechanism instead of specific implementation details like token exchange - Update related links to match new title 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
1 parent 7030ba5 commit 4b2f1e0

File tree

3 files changed

+21
-22
lines changed

3 files changed

+21
-22
lines changed

docs/toolhive/concepts/vmcp-architecture.mdx

Lines changed: 19 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
title: Virtual MCP architecture
2+
title: Understanding Virtual MCP Server
33
description:
4-
Understanding what Virtual MCP Server does, why it exists, and when to use it.
4+
Learn what Virtual MCP Server does, why it exists, and when to use it.
55
---
66

77
This document explains Virtual MCP Server (vMCP), why it exists, and when you
@@ -22,10 +22,10 @@ tools with sensible defaults.
2222

2323
Virtual MCP Server delivers four key benefits:
2424

25-
1. **Reduce complexity**: 10 connections become 1 connection (90% reduction in
26-
configuration)
27-
2. **Speed up workflows**: Parallel execution makes multi-system tasks 5-10x
28-
faster
25+
1. **Reduce complexity**: Many connections become one, dramatically simplifying
26+
configuration
27+
2. **Speed up workflows**: Parallel execution across systems instead of
28+
sequential calls
2929
3. **Improve security**: Centralized authentication and authorization with a
3030
two-boundary model
3131
4. **Enable reusability**: Define workflows once, use them everywhere
@@ -39,10 +39,10 @@ own configuration, authentication, and maintenance. vMCP aggregates all backends
3939
into one endpoint with automatic conflict resolution.
4040

4141
**Example scenario**: An engineering team needs access to 8 backend servers
42-
(GitHub, Jira, Slack, Confluence, PagerDuty, DataDog, AWS, Internal Docs).
42+
(GitHub, Jira, Slack, Confluence, PagerDuty, Datadog, AWS, Internal Docs).
4343
Instead of configuring 8 separate connections, they configure one vMCP
44-
connection with SSO. The result is 87% less configuration complexity and easier
45-
onboarding for new team members.
44+
connection with SSO. This significantly reduces configuration complexity and
45+
makes onboarding new team members much easier.
4646

4747
When multiple backends have tools with the same name (for example, both GitHub
4848
and Jira have `create_issue`), vMCP automatically prefixes them:
@@ -100,16 +100,15 @@ are centralized in the vMCP configuration.
100100

101101
Different auth is needed for clients versus backends, and managing credentials
102102
across multiple systems is complex. vMCP implements a two-boundary auth model
103-
where clients use SSO and vMCP handles per-backend authentication.
103+
that separates these concerns.
104104

105-
**How it works**: Engineers authenticate once with your identity provider (Okta,
106-
Google, Microsoft Entra ID). vMCP exchanges their token for backend-specific
107-
tokens (GitHub, Jira, Slack), each with appropriate scopes. Revoking access is
108-
simple: disable the user in your IdP and all backend access is revoked
109-
instantly.
105+
**How it works**: Clients authenticate to vMCP using the mechanism defined in
106+
the MCP specification. vMCP then handles authentication to each backend MCP
107+
server independently. Revoking access is simple: disable the user in your
108+
identity provider and all backend access is revoked instantly.
110109

111-
This approach provides single sign-on for users, least-privilege token scoping
112-
per backend, centralized access control, and a complete audit trail.
110+
This approach provides single sign-on for users, centralized access control, and
111+
a complete audit trail.
113112

114113
## When to use vMCP
115114

@@ -130,9 +129,9 @@ per backend, centralized access control, and a complete audit trail.
130129
## Summary
131130

132131
Virtual MCP Server transforms MCP from individual servers into a unified
133-
orchestration platform. The use cases range from simple aggregation (90% less
134-
configuration) to complex workflows with approval gates (5-10x faster
135-
execution), making it valuable for organizations at any scale.
132+
orchestration platform. The use cases range from simple aggregation to complex
133+
workflows with approval gates, making it valuable for teams managing multiple
134+
MCP servers.
136135

137136
## Related information
138137

docs/toolhive/guides-vmcp/intro.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,5 +60,5 @@ flowchart TB
6060

6161
## Related information
6262

63-
- [Virtual MCP architecture](../concepts/vmcp-architecture.mdx)
63+
- [Understanding Virtual MCP Server](../concepts/vmcp-architecture.mdx)
6464
- [Quickstart: Virtual MCP](../tutorials/quickstart-vmcp.mdx)

docs/toolhive/tutorials/quickstart-vmcp.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -151,7 +151,7 @@ Next steps:
151151
- [Configure authentication](../guides-vmcp/authentication.mdx) for production
152152
- [Customize tool aggregation](../guides-vmcp/tool-aggregation.mdx) with
153153
filtering and overrides
154-
- [Learn about Virtual MCP architecture](../concepts/vmcp-architecture.mdx)
154+
- [Understanding Virtual MCP Server](../concepts/vmcp-architecture.mdx)
155155

156156
## Troubleshooting
157157

0 commit comments

Comments
 (0)