用途：本指南说明如何用 CLI 配置并运行 Umbraco MCP 服务器。服务器以 stdio 方式运行 MCP 协议，Claude Code 或其他 MCP 客户端连接后，LLM 可在已认证状态下调用工具。认证由 CLI 完成，LLM 不接触凭据。
主要能力：支持通过 npx 已发布包或本地构建项目启动；可用命令行参数、环境变量或 .env 文件（自动加载，或经 --env 指定路径）提供认证信息，优先级为 CLI 参数 > 环境变量 > .env。提供 dry-run 模式（变更工具返回预览而不调用 Umbraco API，读工具正常执行）与 readonly 模式（完全移除变更工具，仅注册 readOnlyHint 工具）。支持按切片、集合、具体工具名进行包含/排除过滤，可用切片为 read、list、create、update、delete、search、tree、publish、move、copy，排除优先于包含。自省命令 --list-tools、--describe-tool、--generate-context 输出后立即退出，并遵循过滤与认证配置。SDK 会自动校验字符串输入，拒绝控制字符、路径穿越、内嵌查询参数与百分号编码，返回 RFC 7807 错误供 LLM 自纠。
使用方式：可用 npx @umbraco-cms/mcp-dev 加 --umbraco-client-id、--umbraco-client-secret、--umbraco-base-url 启动，或 node dist/index.js 配合同名参数/环境变量。在 Claude Code 的 MCP 配置中以 command 与 args 或 env 方式接入。认证凭据来自 Umbraco 后台 Settings > Users 下创建的 API 用户（OAuth 客户端凭据）。
适用场景：为 Claude Code 接入 Umbraco 实例；安全探索变更操作；只读审计与报表；按需限制 LLM 可见工具范围；本地开发调试 CLI 命令。
限制：需要可用的 OAuth 客户端凭据与运行的 Umbraco 实例；无认证时部分依赖用户的工具集合会被跳过；资料未提供具体收费、价格与平台支持信息。