Skip to content

Commit 9a82dc4

Browse files
jhrozekclaude
andauthored
Fix vMCP documentation based on cluster testing (#331)
* Fix VirtualMCPServer output columns in quickstart Update expected kubectl output to match actual CRD printer columns: - Change STATUS to PHASE - Add BACKENDS and READY columns Verified by testing against live cluster. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]> * Fix minimal VirtualMCPServer config to include required incomingAuth The vMCP binary requires incomingAuth.type to be specified. Without it, the pod crashes with: "incoming_auth.type must be one of: oidc, local, anonymous" Verified by testing against live cluster. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]> * Add note about optional clientSecretRef for token introspection 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]> --------- Co-authored-by: Claude <[email protected]>
1 parent e5d216f commit 9a82dc4

File tree

2 files changed

+7
-3
lines changed

2 files changed

+7
-3
lines changed

docs/toolhive/guides-vmcp/configuration.mdx

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,8 @@ complete field reference, see the
1010
## Minimal configuration
1111

1212
At minimum, a VirtualMCPServer requires a reference to an
13-
[MCPGroup](../tutorials/quickstart-vmcp.mdx#step-1-create-an-mcpgroup):
13+
[MCPGroup](../tutorials/quickstart-vmcp.mdx#step-1-create-an-mcpgroup) and an
14+
authentication type:
1415

1516
```yaml
1617
apiVersion: toolhive.stacklok.dev/v1alpha1
@@ -20,6 +21,8 @@ metadata:
2021
spec:
2122
groupRef:
2223
name: my-group
24+
incomingAuth:
25+
type: anonymous # Disables authentication; do not use in production
2326
```
2427
2528
The MCPGroup must exist in the same namespace and be in a Ready state before the
@@ -57,6 +60,7 @@ spec:
5760
issuer: https://your-idp.example.com
5861
audience: vmcp
5962
clientId: your-client-id
63+
# For token introspection, add clientSecretRef referencing a Secret
6064
```
6165

6266
### Kubernetes service account tokens

docs/toolhive/tutorials/quickstart-vmcp.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -159,8 +159,8 @@ kubectl get virtualmcpservers -n toolhive-system
159159
You should see output similar to:
160160

161161
```text
162-
NAME STATUS URL AGE
163-
demo-vmcp Ready http://vmcp-demo-vmcp.toolhive-system.svc.cluster.local:4483 30s
162+
NAME PHASE URL BACKENDS AGE READY
163+
demo-vmcp Ready http://vmcp-demo-vmcp.toolhive-system.svc.cluster.local:4483 2 30s True
164164
```
165165

166166
:::info[What's happening?]

0 commit comments

Comments
 (0)