Skip to content

Add Editor MCP documentation and hosted MCP setup guides#7948

Draft
hifi-phil wants to merge 3 commits into
umbraco:mainfrom
hifi-phil:docs/editor-mcp-documentation
Draft

Add Editor MCP documentation and hosted MCP setup guides#7948
hifi-phil wants to merge 3 commits into
umbraco:mainfrom
hifi-phil:docs/editor-mcp-documentation

Conversation

@hifi-phil
Copy link
Copy Markdown
Contributor

Summary

  • Add comprehensive documentation for the Umbraco CMS Editor MCP server targeting content editors and managers
  • Add hosted MCP setup guides for connecting via URL + OAuth (Claude Desktop, ChatGPT, Claude Code, Cursor, GitHub Copilot)

New Files

cms-editor-mcp/ — Editor MCP documentation (mirrors cms-developer-mcp/ structure):

  • README.md — Overview, audience, hosted service connection, OAuth authentication
  • available-tools.md — All 89 tools across 20 collections
  • configuration.md — 12 modes, 10 slices, example configurations
  • scenarios.md — 20 editorial use case categories with example prompts
  • best-practice/ — Workflow tips, context management, example instructions file

hosted-mcp-setup/ — Per-host connection guides for hosted MCP servers:

  • Claude Desktop, ChatGPT, Claude Code, Cursor, GitHub Copilot

Test plan

  • Review content accuracy against editor MCP codebase
  • Verify all tool names and descriptions match implementation
  • Check GitBook rendering of all pages
  • Validate internal links between sections

🤖 Generated with Claude Code

@sofietoft
Copy link
Copy Markdown
Contributor

Hi 👋
Just a heads up: We're restructuring the Umbraco in AI docs into a single site: #7956

For your PR here, this means that you need to add all new articles to the main SUMMARY.md file at the root of the umbraco-in-ai directory.
Please also notice that I've removed the redundant umbraco-ai folder.

I'll merge my PR later today or tomorrow morning.

Re-applies the Editor MCP server documentation and hosted MCP client
setup guides on top of the restructured umbraco-in-ai section. The
content originally landed under 17/umbraco-ai/umbraco-in-ai/ but now
sits at 17/umbraco-in-ai/mcp/cms-editor-mcp/ and 17/umbraco-in-ai/
mcp/hosted-mcp-setup/, both as siblings of cms-developer-mcp.

Replaces the per-doc-space GitBook editor URLs with relative links
into the unified umbraco-in-ai space (concepts/model-context-protocol,
concepts/context-engineering, base-mcp/sdk/configuration,
base-mcp/sdk/tool-filtering, hosted-mcp-setup/*). Drops the redundant
per-folder SUMMARY.md files since the top-level SUMMARY.md now drives
navigation.

The OpenAI Codex bullet in the Editor MCP host setup list is replaced
with ChatGPT, since Codex has no hosted-setup page yet.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@hifi-phil hifi-phil force-pushed the docs/editor-mcp-documentation branch from cbb06d3 to cd74358 Compare April 27, 2026 21:13
hifi-phil and others added 2 commits April 27, 2026 22:27
Reflects the editor MCP server's current tool surface. New `public-access`,
`notifications` (hosted-only), and `recycle-bin` collections are now
documented. Tools added or modified in `content`, `publishing`, `versioning`,
`media`, `media-management`, `member`, and `bulk-operations` are aligned with
their source `name` and `description`.

Tree-walking report tools that were disabled pending a filtered-pages
endpoint are dropped from the doc, including the now-empty
`content-reporting` and `media-health` sections, and the per-tool entries
removed from `content-health`, `scheduling`, and `relationships`.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Adds the new `account` collection (`get-current-user`) and seven content
tools shipped since the last sync: `list-page-templates`,
`get-property-value-template`, `add-blocklist-block`, `add-blockgrid-block`,
`add-rte-block`, `set-page-template`, and `delete-block`. Tool order in the
content section matches the registration order in the Editor MCP source.

Co-Authored-By: Claude Opus 4.7 (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.

2 participants