Skip to content

Refresh FAQ for current platform#821

Merged
danbarr merged 6 commits intomainfrom
refresh-faq
May 5, 2026
Merged

Refresh FAQ for current platform#821
danbarr merged 6 commits intomainfrom
refresh-faq

Conversation

@danbarr
Copy link
Copy Markdown
Collaborator

@danbarr danbarr commented Apr 29, 2026

Description

Refreshes the FAQ to reflect the current ToolHive platform: vMCP, Registry Server, skills, Stacklok Enterprise, and the maturing Kubernetes operator. Replaces stale answers, deduplicates, and reorganizes for navigability.

Refreshed / fixed

  • "Is ToolHive free?" now acknowledges Stacklok Enterprise as the paid commercial distribution
  • Secrets answer covers encrypted store + 1Password + Vault (was just 1Password)
  • "Can I use ToolHive in my organization?" now layers in vMCP, Registry Server, and Enterprise
  • Dropped the "experimental" qualifier from Kubernetes deployment
  • Removed the duplicate "Can I run my own custom MCP servers?" entry
  • Bug-report links updated to call out vMCP and Registry Server live in the toolhive repo

New entries

  • ToolHive vs. Stacklok Enterprise (General)
  • vMCP, built-in registry vs. Registry Server, skills (new "ToolHive components" section)
  • Remote MCP server support, AI client compatibility, container runtimes (Using MCP servers)
  • IdP/SSO integration, audit/observability (Security)

Restructured

  • New "ToolHive components" section between General and Using MCP servers
  • "Enterprise and advanced usage" → "Operations and enterprise"

Out of scope: the FAQPage JSON-LD structured data discussed in the issue comment. That's a custom-component task; happy to file as a follow-up.

Type of change

  • Documentation update

Related issues/PRs

Closes #355

Submitter checklist

Content and formatting

  • I have reviewed the content for technical accuracy
  • I have reviewed the content for spelling, grammar, and style

🤖 Generated with Claude Code

Closes #355.

- Add ToolHive vs. Stacklok Enterprise question
- Add ToolHive components section: vMCP, Registry Server vs.
  built-in registry, skills
- Add remote MCP servers, AI clients, and container runtimes
  questions
- Add IdP/SSO and audit logging questions in Security
- Drop "experimental" from Kubernetes operator
- Refresh secrets answer to cover encrypted store, 1Password,
  and Vault
- Remove duplicate custom MCP server question
- Reorganize "Enterprise and advanced usage" into
  "Operations and enterprise"

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings April 29, 2026 20:53
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 29, 2026

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

Project Deployment Actions Updated (UTC)
docs-website Ready Ready Preview, Comment May 5, 2026 5:04pm

Request Review

Copy link
Copy Markdown
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

Updates the ToolHive FAQ to reflect the current platform (vMCP, Registry Server, skills, and Enterprise positioning) and reorganizes content for easier navigation.

Changes:

  • Refreshes/rewrites multiple FAQ answers to reflect current ToolHive components and enterprise capabilities.
  • Adds new FAQ entries (ToolHive vs Enterprise, components overview, remote MCP support, client compatibility, SSO/auditability).
  • Reorganizes sections (adds “ToolHive components”; renames/reshapes enterprise section).

Comment thread docs/toolhive/faq.mdx Outdated
Comment thread docs/toolhive/faq.mdx Outdated
Comment thread docs/toolhive/faq.mdx
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Comment thread docs/toolhive/faq.mdx Outdated
Comment thread docs/toolhive/faq.mdx
Comment thread docs/toolhive/faq.mdx
Comment thread docs/toolhive/faq.mdx
Comment thread docs/toolhive/faq.mdx
Comment thread docs/toolhive/faq.mdx
- Mention agent skills in the What is ToolHive answer
- Note day-2 and day-3 operations in the Enterprise blurb
- Cross-link the available-servers and registry-contribution answers
- Cross-link the custom-servers and remote-servers answers
- Add Lok chat assistant to the help list

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copy link
Copy Markdown
Contributor

@Derek2Tu Derek2Tu left a comment

Choose a reason for hiding this comment

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

LGTM

@danbarr danbarr merged commit d43c460 into main May 5, 2026
12 checks passed
@danbarr danbarr deleted the refresh-faq branch May 5, 2026 20:13
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.

[Enhancement]: Review/refresh FAQ

3 participants