Skip to content

Commit 0daedb2

Browse files
Phil Whittakerclaude
andcommitted
Add maintenance use case and fix typos in MCP documentation
Added maintenance use case covering content reorganization, naming standardization, and technical debt cleanup. Fixed typo in schema scaffolding description. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
1 parent a898ea5 commit 0daedb2

File tree

1 file changed

+9
-6
lines changed

1 file changed

+9
-6
lines changed

16/umbraco-cms/reference/developer-mcp/concepts/model-context-protocol.md

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -29,13 +29,15 @@ These are applications that implement MCP support — for example:
2929
- GitHub Copilot
3030
- and many others
3131

32-
A host provides the environment where the model runs and where MCP connections are managed.
32+
The host application is where you interact with the model and manage MCP connections. It coordinates between your input, the LLM, and any connected MCP tools via the client.
3333

3434
---
3535

3636
### MCP Clients
3737

38-
An MCP client represents a single connection between the LLM and an MCP server. It routes information between the MCP servers and the model, makes each MCP capability visible to the LLM, passes calls from the model to the correct server, and returns the results back to the LLM. In short, the client acts as the traffic controller between the model and the external systems it can interact with.
38+
An MCP client represents a single connection between the LLM and an MCP server. It routes information between the MCP servers and the model, makes each MCP capability visible to the LLM, passes calls from the model to the correct server, and returns the results back to the LLM.
39+
40+
In short, the client acts as the traffic controller between the model and the external systems it can interact with.
3941

4042
---
4143

@@ -52,7 +54,7 @@ Servers can represent:
5254

5355
A single client can connect to multiple servers, each running in parallel — for example, one server might expose Umbraco’s Management API, another might provide access to a local file system, and a third could connect to an external data source such as a CRM or analytics database. This allows the LLM to draw from and interact with several systems at once, all through a single, unified MCP connection.
5456

55-
Each exposed element has a name and a description, which the model uses to understand what the element does and when to use it.
57+
Each exposed element has a name, a description and an input schema, which the model uses to understand what the MCP server element does and when to use it.
5658

5759
## The Core Elements of MCP
5860

@@ -71,9 +73,9 @@ Prompts are ideal for multi-step tasks or for standardising a common process.
7173

7274
## What This Means for Umbraco
7375

74-
The Umbraco CMS Developer MCP Server builds on top of Umbraco’s Management API (introduced in v14), which exposes everything the Backoffice can do — from content and media to document and data types — through consistent, structured endpoints.
76+
The Developer MCP Server builds on top of Umbraco’s Management API (introduced in v14), which exposes everything the Backoffice can do — from content and media to document and data types — through consistent, structured endpoints.
7577

76-
These APIs follow predictable patterns for CRUD operations, listings, and metadata, making them an ideal foundation for the Model Context Protocol (MCP).
78+
These APIs follow predictable patterns for CRUD operations, listings etc, making them an ideal foundation for the Model Context Protocol (MCP).
7779

7880
However, the Backoffice UI can only ever expose a fraction of the functionality that the Management API makes possible. It’s designed for day-to-day content management — not for executing complex, multi-step operations that span across entities or require dynamic logic. Many advanced or edge case workflows are simply too specialised, too costly, or too confusing to implement in the UI.
7981

@@ -92,7 +94,8 @@ For example:
9294

9395
- **Bulk content operations** – Identify, update, and republish hundreds of nodes programmatically.
9496
- **Media automation** – Rename, categorise, and relocate assets based on metadata or folder structure.
95-
- **Schema scaffolding** – Generat or manage document types and data types directly from a or prompt.
97+
- **Schema scaffolding** – Generate or manage document types and data types directly from a prompt.
98+
- **Maintenance** – Reorganise into folders, standardise naming conventions or tidy up accumulated technical debt.
9699
- **Reporting** – Extract and analyze content patterns, audit site structure, or generate usage reports across your entire site.
97100

98101
This represents a fundamental shift in how you build with Umbraco.

0 commit comments

Comments
 (0)