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
Improve word choices in model context protocol and configuration docs
Model Context Protocol changes:
- Changed "several" to "many" for clearer quantification
- Changed "really just" to "simply" for more concise language
Configuration changes:
- User edits applied
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: 16/umbraco-cms/reference/developer-mcp/concepts/model-context-protocol.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,7 +27,7 @@ These are applications that implement MCP support — for example:
27
27
- Cursor
28
28
- Windsurf
29
29
- GitHub Copilot
30
-
-and many others
30
+
-And many others
31
31
32
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
@@ -52,7 +52,7 @@ Servers can represent:
52
52
- Filesystems
53
53
- Any other external system
54
54
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. 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 of this happens through a single, unified MCP connection.
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. 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 many systems at once. All of this happens through a single, unified MCP connection.
56
56
57
57
Each exposed element has a name, a description, and an input schema. The model uses these to understand what the MCP server element does and when to use it.
58
58
@@ -77,11 +77,11 @@ The Developer MCP Server builds on top of Umbraco's Management API (introduced i
77
77
78
78
These APIs follow predictable patterns for CRUD operations, listings etc, making them an ideal foundation for the Model Context Protocol (MCP).
79
79
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.
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 often too specialised, too costly, or too confusing to implement in the UI.
81
81
82
82
By giving an LLM or AI agent access to these APIs through MCP, you can now ask it to perform powerful, compound tasks. These tasks would be impossible in the Backoffice and impractical to achieve manually.
83
83
84
-
MCP turns Umbraco's structured API surface into something the model can read from, reason about, and automate. This unlocks the full depth of Umbraco's capabilities, not just the parts surfaced through the UI.
84
+
MCP turns Umbraco's structured API surface into something the model can read from, reason about, and automate. This unlocks the full depth of Umbraco's capabilities, not only the parts surfaced through the UI.
85
85
86
86
{% hint style="info" %}
87
87
MCP is not a replacement for the Umbraco Backoffice. Many actions are best completed using the UI. This includes visual content design, layout composition, and structured editing.
@@ -97,13 +97,13 @@ For example:
97
97
-**Schema scaffolding** – Generate or manage document types and data types directly from a prompt.
98
98
-**Maintenance** – Reorganise into folders, standardise naming conventions or tidy up accumulated technical debt.
99
99
-**Reporting** – Extract and analyze content patterns, audit site structure, or generate usage reports across your entire site.
100
-
-[**plus many, many more**](../scenarios.md)
100
+
-[**Plus many, many more**](../scenarios.md)
101
101
102
102
This represents a fundamental shift in how you build with Umbraco.
103
103
104
104
You’ve always had access to the Management API — but using it directly meant writing custom scripts or tooling. Now, with MCP, the model (or an agent) can dynamically plan and execute API calls on your behalf.
105
105
106
-
It looks like magic — but it's really just tool orchestration. The LLM figures out what to call, when, and why. It bases this on the tools it's been given and the goal you've described.
106
+
It looks like magic — but it's really purely tool orchestration. The LLM figures out what to call, when, and why. It bases this on the tools it's been given and the goal you've described.
107
107
108
108
The only limit is your imagination. If you can explain what you want, an LLM that understands Umbraco can figure out how to make it happen. This assumes it has the right MCP tools available.
Copy file name to clipboardExpand all lines: 16/umbraco-cms/reference/developer-mcp/configuration.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ description: Configuration options for the Developer MCP server
4
4
5
5
# Configration Options
6
6
7
-
The Developer MCP Server can be configured in various ways to manage authentication, tool access, and security settings. These settings control how the server connects to Umbraco and how it operates within your development environment. Configuration can be applied using configuration keys, environment variables, or CLI arguments, depending on your workflow.
7
+
The Developer MCP Server can be configured in mutliple ways to manage authentication, tool access, and security settings. These settings control how the server connects to Umbraco and how it operates within your development environment. Configuration can be applied using configuration keys, environment variables, or CLI arguments, depending on your workflow.
0 commit comments