Skip to content

Conversation

@eleftherias
Copy link
Member

@eleftherias eleftherias commented Aug 19, 2025

Description

Document the new groups feature.

Related issues/PRs

stacklok/toolhive#1460

Merge checklist

Content

  • New pages include a frontmatter section with title and description at a minimum
  • 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

Copilot AI review requested due to automatic review settings August 19, 2025 12:48
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR adds comprehensive documentation for the new groups feature in ToolHive, which allows users to organize MCP servers into logical collections and control client access to specific server groups.

  • Creates a new guide explaining group concepts, creation, and management
  • Updates existing guides to incorporate group-related commands and options
  • Adds the new documentation page to the sidebar navigation

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
sidebars.ts Adds the new group management guide to the CLI guides section
docs/toolhive/guides-cli/run-mcp-servers.mdx Documents the --group option for running servers within specific groups
docs/toolhive/guides-cli/manage-mcp-servers.md Adds group-based operations for stop, restart, and remove commands
docs/toolhive/guides-cli/group-management.md New comprehensive guide covering group creation, server organization, and client access configuration
docs/toolhive/guides-cli/client-configuration.mdx Documents group-specific client registration and removal options

@vercel
Copy link

vercel bot commented Aug 19, 2025

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

Project Deployment Preview Comments Updated (UTC)
docs-website Ready Ready Preview Comment Aug 20, 2025 0:47am

@eleftherias
Copy link
Member Author

I can't see why Vercel is failing, but my guess is that it's an invalid link which will be fixed once we release and have the thv group reference docs.

@danbarr
Copy link
Collaborator

danbarr commented Aug 19, 2025

@eleftherias Yeah it's the broken link.

To get a clean preview, you could copy over the docs/cli directory from the toolhive repo into your PR (or just the ones you need) and we can rebase/merge with the automatic PR once the release is cut.

Copy link
Collaborator

@danbarr danbarr left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Made a few minor inline suggestions. Some other thoughts:

  • Probably worth mentioning somewhere that a server can only be part of a single group, that if you want the same MCP server available in multiple groups, you need to run multiple instances?

  • Optional, but I wonder if a simple mermaid diagram in the group management guide might be useful to help illustrate the structure?

@eleftherias
Copy link
Member Author

Thanks for feedback, I added a new section for the same MCP server in multiple groups.

@eleftherias eleftherias requested a review from danbarr August 20, 2025 12:49
@eleftherias eleftherias merged commit 8e13464 into main Aug 20, 2025
8 of 10 checks passed
@eleftherias eleftherias deleted the groups branch August 20, 2025 14:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants