Skip to content

Commit e064791

Browse files
Phil Whittakerclaude
andcommitted
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>
1 parent ab9b95d commit e064791

File tree

2 files changed

+7
-7
lines changed

2 files changed

+7
-7
lines changed

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

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ These are applications that implement MCP support — for example:
2727
- Cursor
2828
- Windsurf
2929
- GitHub Copilot
30-
- and many others
30+
- And many others
3131

3232
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

@@ -52,7 +52,7 @@ Servers can represent:
5252
- Filesystems
5353
- Any other external system
5454

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.
5656

5757
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.
5858

@@ -77,11 +77,11 @@ The Developer MCP Server builds on top of Umbraco's Management API (introduced i
7777

7878
These APIs follow predictable patterns for CRUD operations, listings etc, making them an ideal foundation for the Model Context Protocol (MCP).
7979

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.
8181

8282
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.
8383

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.
8585

8686
{% hint style="info" %}
8787
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:
9797
- **Schema scaffolding** – Generate or manage document types and data types directly from a prompt.
9898
- **Maintenance** – Reorganise into folders, standardise naming conventions or tidy up accumulated technical debt.
9999
- **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)
101101

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

104104
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.
105105

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.
107107

108108
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.
109109

16/umbraco-cms/reference/developer-mcp/configuration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Configuration options for the Developer MCP server
44

55
# Configration Options
66

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.
88

99
## Configuration Keys
1010

0 commit comments

Comments
 (0)