Skip to content

Conversation

@JAORMX
Copy link
Contributor

@JAORMX JAORMX commented Sep 17, 2025

Summary

Add Kubernetes Operator documentation for the new MCPToolConfig CRD and toolConfigRef integration introduced in ToolHive operator (stacklok/toolhive#1814). This enables centrally filtering/renaming MCP server tools and referencing these configurations from MCPServer resources.

Changes

  • New guide: Configure tools for MCP servers on Kubernetes
    • Explains MCPToolConfig (toolsFilter, toolsOverride)
    • Notes same-namespace constraint and precedence over deprecated spec.tools
    • Provides basic and override examples
    • End-to-end MKP example including RBAC, MCPToolConfig, and MCPServer with toolConfigRef
    • Troubleshooting and status inspection guidance
  • Sidebar: add the new guide under Guides: Kubernetes Operator
  • MKP guide: cross-link to the new tool configuration guide

Files

  • docs/toolhive/guides-k8s/tool-config.mdx (new)
  • sidebars.ts (sidebar entry)
  • docs/toolhive/guides-mcp/k8s.mdx (cross-link)

Notes

  • Ran markdownlint and prettier; site builds successfully.
  • One unrelated Docusaurus broken anchor warning exists for CRD reference (pre-existing).

Copilot AI review requested due to automatic review settings September 17, 2025 11:26
@vercel
Copy link

vercel bot commented Sep 17, 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 Sep 18, 2025 3:24pm

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 documents the new MCPToolConfig CRD and toolConfigRef integration for the ToolHive Kubernetes operator, enabling centralized management of MCP server tool filtering and renaming.

  • Adds comprehensive documentation for MCPToolConfig CRD usage with filtering and override capabilities
  • Provides practical examples including basic filtering, tool renaming, and end-to-end RBAC setup
  • Establishes cross-links between related Kubernetes guides

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 5 comments.

File Description
docs/toolhive/guides-k8s/tool-config.mdx New comprehensive guide documenting MCPToolConfig CRD usage, examples, and troubleshooting
sidebars.ts Adds the new tool configuration guide to the Kubernetes Operator section
docs/toolhive/guides-mcp/k8s.mdx Adds cross-reference info box linking to the new tool configuration guide

…s per org (acme/foocorp)\n- Update filters to use overridden names\n- Add concise notes on empty filter and override filtering
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.

Thanks for the updates! Minor stuff to fix formatting...

@danbarr danbarr changed the title docs(k8s): document MCPToolConfig and toolConfigRef Document MCPToolConfig and toolConfigRef for K8s operator Sep 18, 2025
@JAORMX JAORMX merged commit f2a5126 into main Sep 18, 2025
6 checks passed
@JAORMX JAORMX deleted the docs/k8s-toolconfig branch September 18, 2025 16:33
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.

4 participants