Add K8s client connectivity guide #310
Draft
+889
−2
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
Signed-off-by: Dan Barr <[email protected]>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Copilot finished reviewing on behalf of
danbarr
November 21, 2025 03:46
Contributor
There was a problem hiding this comment.
Pull Request Overview
This PR adds a comprehensive guide for connecting clients to MCP servers running in Kubernetes, covering both external connectivity via Ingress/Gateway API and internal cluster connectivity. The guide helps users expose MCP servers securely and establish proper connection patterns for different scenarios.
- Adds detailed documentation on connecting external and internal clients to Kubernetes-hosted MCP servers
- Provides practical examples for Ingress, Gateway API, and in-cluster service discovery patterns
- Includes extensive troubleshooting section covering common connectivity issues
Reviewed Changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/toolhive/guides-k8s/connect-clients.mdx | New comprehensive guide explaining client connectivity options for MCP servers in Kubernetes, including external access via Ingress/Gateway API and internal cluster access patterns |
| sidebars.ts | Adds the new connect-clients guide to the Kubernetes guides section in the appropriate position between run-mcp-k8s and remote-mcp-proxy |
| docs/toolhive/guides-k8s/intro.mdx | Adds reference to the new connectivity guide explaining how to expose MCP servers and connect clients |
| docs/toolhive/guides-k8s/run-mcp-k8s.mdx | Updates "Next steps" section to reference the new connectivity guide with more detailed context about connection options |
| docs/toolhive/tutorials/k8s-ingress-ngrok.mdx | Adds tip box referencing the new general connectivity guide for broader context beyond the ngrok-specific tutorial |
Co-authored-by: Copilot <[email protected]>
Signed-off-by: Dan Barr <[email protected]>
Collaborator
Author
|
Setting to draft for now while I validate auth interoperability (esp. with rewrites) |
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
Adds a guide detailing options for connecting clients to MCP servers running in Kubernetes:
Related issues/PRs
Closes #307
Merge checklist
Content
sidebars.ts) updated for added, deleted, reordered, or renamed filesvercel.jsonfor moved, renamed, or deleted pages (i.e., if the URL slug changed)Reviews