document vMCP remote server support #406
Open
+214
−24
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
There was a problem hiding this comment.
Pull request overview
This PR documents the new vMCP feature that enables MCPRemoteProxy resources to be aggregated alongside MCPServer resources by VirtualMCPServer, providing a unified endpoint for both local container-based and remote MCP servers.
Key changes include:
- Updated vMCP documentation to describe support for both MCPServer and MCPRemoteProxy backend types
- Added configuration examples showing how to add remote proxies to MCPGroups
- Extended the remote MCP proxy guide with a dedicated section on vMCP integration
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 4 comments.
| File | Description |
|---|---|
| docs/toolhive/guides-vmcp/intro.mdx | Updated overview and architecture diagram to show MCPRemoteProxy as a supported backend type alongside MCPServer |
| docs/toolhive/guides-vmcp/configuration.mdx | Added "Add backends to a group" section with YAML examples for both MCPServer and MCPRemoteProxy configurations |
| docs/toolhive/guides-k8s/remote-mcp-proxy.mdx | Added "Use with Virtual MCP Server" section explaining how to add remote proxies to MCPGroups and the benefits of vMCP aggregation |
| docs/toolhive/concepts/vmcp.mdx | Updated multi-server aggregation section to mention MCPRemoteProxy support and mixed backend scenarios |
jhrozek
reviewed
Dec 18, 2025
| remoteURL: https://mcp.analytics.example.com | ||
| transport: streamable-http | ||
| port: 8080 | ||
| oidcConfig: |
Contributor
There was a problem hiding this comment.
What does the oidcConfig here mean? Is it a token that vMCP sends?
jhrozek
reviewed
Dec 18, 2025
| - **Unified endpoint**: Clients connect to one vMCP URL instead of multiple | ||
| proxy endpoints | ||
| - **Centralized authentication**: vMCP handles client authentication; remote | ||
| proxies validate the forwarded tokens |
Contributor
There was a problem hiding this comment.
I assume we can't auth to remote servers as of yet?
jhrozek
reviewed
Dec 18, 2025
| namespace: toolhive-system | ||
| spec: | ||
| groupRef: dev-tools | ||
| remoteURL: https://mcp.analytics.example.com |
Contributor
There was a problem hiding this comment.
could we use a real MCP server in the example?
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
Documents the new vMCP feature that enables MCPRemoteProxy resources to be grouped with MCPServer resources and aggregated by VirtualMCPServer into a single unified endpoint.
Changes include:
groupRefusage and benefits of vMCP aggregationType of change
Related issues/PRs
Screenshots
N/A - content updates only, no structural changes
Submitter checklist
Content and formatting
Navigation
N/A - No pages were added, deleted, renamed, or reordered. Only content updates to existing pages.
Reviewer checklist
Content