Skip to content

Add CLI Reference for Base MCP SDK#7941

Draft
hifi-phil wants to merge 9 commits intoumbraco:mainfrom
hifi-phil:base-mcp-cli-reference
Draft

Add CLI Reference for Base MCP SDK#7941
hifi-phil wants to merge 9 commits intoumbraco:mainfrom
hifi-phil:base-mcp-cli-reference

Conversation

@hifi-phil
Copy link
Copy Markdown
Contributor

Summary

  • Adds a new CLI Reference page to the Base MCP SDK documentation (17/umbraco-ai/umbraco-in-ai/mcp/base-mcp/sdk/cli.md)
  • Covers authentication, starting the server, tool filtering, runtime modes (readonly and dry-run), introspection commands, and input sanitization
  • Updates the CMS Developer MCP configuration page to link to the CLI Reference
  • Adds entry to the Base MCP SUMMARY.md

Test plan

  • Verify the new CLI Reference page renders correctly on GitBook
  • Verify the SUMMARY.md entry appears in the navigation under MCP Server SDK
  • Verify the cross-reference link from the CMS Developer MCP configuration page resolves correctly

🤖 Generated with Claude Code

hifi-phil and others added 9 commits April 7, 2026 13:53
Adds a new CLI Reference page to the Base MCP SDK documentation covering
authentication, starting the server, tool filtering, runtime modes
(readonly and dry-run), introspection commands, and input sanitization.
Updates the CMS Developer MCP configuration page to reference it.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Add Claude Code plugin callout for /mcp-cli interactive guidance
- Trim Authentication and Tool Filtering to summaries with links to
  existing Configuration and Tool Filtering pages (reduces duplication)
- Add missing --call and --call-args introspection commands
- Fix Vale editorializing warning ("Very low" → "Minimal")

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Elevates the plugin install and /mcp-cli skill to a dedicated section
at the top of the page, making it clear this is the recommended way to
work with the CLI. The rest of the page is framed as a reference.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Adds the /mcp-cli plugin install instructions and CLI Reference link
to the Developer MCP Server README, right in the Host Setup section
where Claude Code users will see it.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Each MCP server ships its own Claude Code plugin, so the base SDK docs
should not reference a specific one. Points readers to their MCP
server's own docs for install instructions.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The CLI is not needed for normal MCP usage. Moving it to its own page
keeps the README focused on the standard MCP workflow and avoids
confusion. The new page frames CLI as optional for debugging and
introspection, with the Claude Code plugin as the recommended path.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Rework the base SDK CLI intro to explain the CLI wraps the MCP server
  as an alternative interface, not a separate tool
- Replace all node dist/index.js examples with npx @umbraco-cms/mcp-dev
- Add note that examples use the Developer MCP package as an example
- Move CMS Developer MCP CLI content to separate cli-usage.md page

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Credentials connect the same way as the MCP server (API user, always
env vars). All other options are CLI flags the agent can set as needed.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The mcpServers JSON config is for the normal MCP workflow, not CLI
usage. It belongs in the host setup docs, not here.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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.

1 participant