You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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]>
Copy file name to clipboardExpand all lines: 16/umbraco-cms/reference/developer-mcp/concepts/model-context-protocol.md
+9-6Lines changed: 9 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,13 +29,15 @@ These are applications that implement MCP support — for example:
29
29
- GitHub Copilot
30
30
- and many others
31
31
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.
33
33
34
34
---
35
35
36
36
### MCP Clients
37
37
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.
39
41
40
42
---
41
43
@@ -52,7 +54,7 @@ Servers can represent:
52
54
53
55
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.
54
56
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.
56
58
57
59
## The Core Elements of MCP
58
60
@@ -71,9 +73,9 @@ Prompts are ideal for multi-step tasks or for standardising a common process.
71
73
72
74
## What This Means for Umbraco
73
75
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.
75
77
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).
77
79
78
80
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.
79
81
@@ -92,7 +94,8 @@ For example:
92
94
93
95
-**Bulk content operations** – Identify, update, and republish hundreds of nodes programmatically.
94
96
-**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.
96
99
-**Reporting** – Extract and analyze content patterns, audit site structure, or generate usage reports across your entire site.
97
100
98
101
This represents a fundamental shift in how you build with Umbraco.
0 commit comments