UI: Add remote MCP section

[peppescg]

Description

Create section for remote MCP in the UI (currently visible under feature flag but not released yet )

Related issues/PRs

Screenshots

Merge checklist

Content

• (N/A) New pages include a frontmatter section with title and description at a minimum
• (N/A) Sidebar navigation (sidebars.ts) updated for added, deleted, reordered, or renamed files
• (N/A) Redirects added to vercel.json for moved, renamed, or deleted pages (i.e., if the URL slug changed)

Reviews

• Content has been reviewed for technical accuracy
• Content has been reviewed for spelling, grammar, and style

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
docs-website	Ready	Preview	Comment	Sep 19, 2025 3:41pm

[Copilot]

Pull Request Overview

This PR adds documentation for remote MCP server functionality to the ToolHive UI guide. The documentation explains how users can connect to remotely hosted MCP servers by providing a URL, in addition to the existing local custom server options.

Key changes:

• Documents remote MCP server configuration including authentication options (OAuth2/OIDC)
• Reorganizes the custom server section to distinguish between remote and local options
• Updates navigation and terminology to reflect the new remote server capability

[danbarr]

@peppescg Thanks for providing the examples and talking through the flow, I know this one has been a slog. I have some clarity/flow suggestions; can you make sure I didn't change any technical accuracy?

With this, I think we'd be good to merge once this comes out of feature flag.

[peppescg]

@danbarr

Replace registry snapshot

Wrap local/remote mcp for both registry and custom in tabs
To be consistent I was thinking to have tabs not only for registry section but also for custom one

Kapture.2025-09-19.at.12.20.26.mp4

[danbarr]

Minor nits and just renaming run-mcp-servers.md to .mdx (you'll need to find/replace guides-ui/run-mcp-servers.md in other pages too)

Thanks again for all the effort on this 💪

[danbarr]

Looks good, let's plan to merge once the feature flag is lifted! 🚀