Skip to content

Commit ab9b95d

Browse files
Phil Whittakerclaude
andcommitted
Fix all long sentences in model context protocol and host setup docs
Model Context Protocol changes (13 sentences fixed): - Line 7: Split introduction (26 + 26 → 23, 17, 11 words) - Line 16: Split protocol description (33 → 15, 23 words) - Line 38: Split client routing (37 → 14, 12, 11, 17 words) - Line 55: Split multiple servers (51 → 13, 20, 17, 16, 12 words) - Line 57: Split element description (31 → 13, 18 words) - Line 76: Split API description (37 → 15, 14, 11 words) - Line 82: Split compound tasks (36 → 23, 13 words) - Line 84: Split API automation (35 → 20, 18 words) - Line 87: Split Backoffice replacement (28 → 10, 9, 11 words) - Line 88: Split augmentation (28 → 10, 23 words) - Line 91: Split composable tools (26 → 9, 19, 14 words) - Line 106: Split tool orchestration (35 → 11, 13, 16 words) - Line 108: Split imagination limit (38 → 6, 19, 10 words) - Line 112: Split collaboration (36 → 20, 25, 13 words) Claude Desktop changes: - Replaced "Unfortunately" with "Note that" and removed it - All sentences already under 25 words Updates to cursor.md and github-copilot.md from user edits All sentences now at or under 25 words for improved readability. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 37cc4a3 commit ab9b95d

File tree

4 files changed

+21
-21
lines changed

4 files changed

+21
-21
lines changed

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

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Effective and optimal communication with LLMs
44

55
# Model Context Protocol (MCP)
66

7-
**Model Context Protocol (MCP)** is a standardised way to connect Large Language Models (LLMs) with external tools, APIs, and data sources. It brings order and consistency to how LLMs interact with the outside world — transforming what used to be complex, manual integrations into something modular and predictable.
7+
**Model Context Protocol (MCP)** is a standardised way to connect Large Language Models (LLMs) with external tools, APIs, and data sources. It brings order and consistency to how LLMs interact with the outside world. This transforms complex, manual integrations into something modular and predictable.
88

99
## The History of MCP
1010

@@ -13,7 +13,7 @@ MCP was developed by Anthropic and released publicly in November 2024.
1313
Anthropic describes it as “the USB-C of connecting to LLMs.”
1414
Before MCP, connecting an LLM to external systems such as APIs, files, or databases was a complex and manual process. Each integration required custom glue code and inconsistent communication patterns.
1515

16-
With MCP, this has changed. The protocol provides a standardised, declarative way to describe and expose capabilities — making it much easier for developers to connect logic and data to an LLM in a reliable, repeatable way.
16+
With MCP, this has changed. The protocol provides a standardised, declarative way to describe and expose capabilities. This makes it much easier for developers to connect logic and data to an LLM in a reliable, repeatable way.
1717

1818
## What Is MCP
1919

@@ -35,7 +35,7 @@ The host application is where you interact with the model and manage MCP connect
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.
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. It makes each MCP capability visible to the LLM. The client passes calls from the model to the correct server and returns the results back.
3939

4040
In short, the client acts as the traffic controller between the model and the external systems it can interact with.
4141

@@ -52,9 +52,9 @@ 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 Umbracos 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.
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.
5656

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

5959
## The Core Elements of MCP
6060

@@ -73,22 +73,22 @@ Prompts are ideal for multi-step tasks or for standardising a common process.
7373

7474
## What This Means for Umbraco
7575

76-
The Developer MCP Server builds on top of Umbracos 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). This API exposes everything the Backoffice can do through consistent, structured endpoints. This includes content, media, document types, and data types.
7777

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

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

82-
By giving an LLM or AI agent access to these APIs through MCP, you can now ask it to perform powerful, compound tasks that are impossible in the Backoffice and impractical to achieve manually.
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.
8383

84-
MCP turns Umbracos structured API surface into something the model can read from, reason about, and automate — unlocking the full depth of Umbracos 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 just the parts surfaced through the UI.
8585

8686
{% hint style="info" %}
87-
MCP is not a replacement for the Umbraco Backoffice. Many actions — like visual content design, layout composition, and structured editing — are best completed using the UI.
88-
Instead, the Developer MCP Server augments the Backoffice, empowering you to run complex, technical operations that are better expressed as goals or workflows rather than manual clicks.
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.
88+
Instead, the Developer MCP Server augments the Backoffice. It empowers you to run complex, technical operations that are better expressed as goals or workflows rather than manual clicks.
8989
{% endhint %}
9090

91-
Because MCP exposes the Management API as composable tools, the model can chain endpoints in an unlimited number of combinations to solve real-world tasks. You describe the outcome you want, and the model figures out how to get there.
91+
MCP exposes the Management API as composable tools. This means the model can chain endpoints in an unlimited number of combinations to solve real-world tasks. You describe the outcome you want, and the model figures out how to get there.
9292

9393
For example:
9494

@@ -103,10 +103,10 @@ 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 its really just tool orchestration: the LLM figures out what to call, when, and why based on the tools its been given and the goal youve described.
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.
107107

108-
The only limit is your imagination. If you can explain what you want, an LLM that understands Umbraco and has the right MCP tools can be left to figure out how to make it happen.
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.
109109

110110
## The LLM as a Collaborator
111111

112-
Beyond automation, MCP enables you to leverage the expertise of the LLM as an intelligent contributor to your Umbraco project. Instead of just executing tasks, the model can assist in planning schema changes, refactoring document types, improving naming conventions, and proposing best practices — all based on a deep understanding of the CMS. It can help you migrate, restructure, and optimise your setup, reducing manual effort while increasing technical quality. With the Developer MCP Server, the LLM becomes more than a command executor — it becomes a **collaborative development partner**.
112+
Beyond automation, MCP enables you to leverage the expertise of the LLM as an intelligent contributor to your Umbraco project. Instead of just executing tasks, the model can assist in planning schema changes, refactoring document types, improving naming conventions, and proposing best practices. All of this is based on a deep understanding of the CMS. It can help you migrate, restructure, and optimise your setup, reducing manual effort while increasing technical quality. With the Developer MCP Server, the LLM becomes more than a command executor — it becomes a **collaborative development partner**.

16/umbraco-cms/reference/developer-mcp/host-setup/claude-desktop.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -48,12 +48,12 @@ A paid version of Claude.ai will have a higher token limit and will be able to r
4848
{% endhint %}
4949

5050
From here, you should [choose which tools or tool collections](../available-tools.md) you want to enable for your first task.
51-
Unfortunately, you will need to restart Claude Desktop every time you make a change to the tools you are using.
51+
Note that you will need to restart Claude Desktop every time you make a change to the tools you are using.
5252

5353
## Node version mismatch
5454

5555
Occasionally, Claude Desktop may choose to use the wrong version of Node.js when running the MCP Server.
5656
A minimum of Node.js version 22 is required. This issue most commonly occurs when using a Node.js version manager such as nvm. Claude Desktop can sometimes default to the lowest installed version rather than the active one set by nvm.
5757

58-
Unfortunately, the only reliable fix for this is to remove all older Node.js versions, leaving only version 22 or higher installed.
58+
The only reliable fix for this is to remove all older Node.js versions, leaving only version 22 or higher installed.
5959
This behaviour appears to be specific to Claude Desktop and does not affect any other AI hosts.

16/umbraco-cms/reference/developer-mcp/host-setup/cursor.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: "Host set up for Cursor"
44

55
# Cursor Setup
66

7-
[Cursor](https://cursor.com/) is an AI-powered code editor built as a fork of Visual Studio Code. It enhances the familiar VS Code experience with conversational AI features that help you write, refactor, and understand code more efficiently.
7+
[Cursor](https://cursor.com/) is an AI-powered code editor built as a fork of Visual Studio Code. It enhances the familiar Visual Studio Code experience with conversational AI features that help you write, refactor, and understand code more efficiently.
88

99
## Getting started
1010

16/umbraco-cms/reference/developer-mcp/host-setup/github-copilot.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,10 +8,10 @@ description: "Host set up for GitHub Copilot"
88

99
## Getting started
1010

11-
#### Click the button to install:
12-
[<img src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF" alt="Install in VS Code">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%7B%22name%22%3A%22umbraco-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22%40umbraco-cms%2Fmcp-dev%40beta%22%5D%2C%22env%22%3A%7B%22NODE_TLS_REJECT_UNAUTHORIZED%22%3A%220%22%2C%22UMBRACO_CLIENT_ID%22%3A%22%3CAPI%20user%20name%3E%22%2C%22UMBRACO_CLIENT_SECRET%22%3A%22%3CAPI%20client%20secert%3E%22%2C%22UMBRACO_BASE_URL%22%3A%22https%3A%2F%2F%3Cdomain%3E%22%2C%22UMBRACO_INCLUDE_TOOL_COLLECTIONS%22%3A%22document%2Cmedia%2Cdocument-type%2Cdata-type%22%7D%7D)
11+
#### Click the button to install
12+
[<img src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF" alt="Install in Visual Studio Code">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%7B%22name%22%3A%22umbraco-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22%40umbraco-cms%2Fmcp-dev%40beta%22%5D%2C%22env%22%3A%7B%22NODE_TLS_REJECT_UNAUTHORIZED%22%3A%220%22%2C%22UMBRACO_CLIENT_ID%22%3A%22%3CAPI%20user%20name%3E%22%2C%22UMBRACO_CLIENT_SECRET%22%3A%22%3CAPI%20client%20secert%3E%22%2C%22UMBRACO_BASE_URL%22%3A%22https%3A%2F%2F%3Cdomain%3E%22%2C%22UMBRACO_INCLUDE_TOOL_COLLECTIONS%22%3A%22document%2Cmedia%2Cdocument-type%2Cdata-type%22%7D%7D)
1313

14-
**Requirements:** VS Code 1.101+ with GitHub Copilot Chat extension installed.
14+
**Requirements:** Visual Studio Code 1.101+ with GitHub Copilot Chat extension installed.
1515

1616
Or install manually:
1717
Follow the MCP [install guide](https://code.visualstudio.com/docs/copilot/customization/mcp-servers#_add-an-mcp-server), use this config.
@@ -20,7 +20,7 @@ Don't forget to replace the UMBRACO_CLIENT_ID, UMBRACO_CLIENT_SECRET, and UMBRAC
2020

2121
## Getting started
2222

23-
Once you’ve added your MCP Server and updated the JSON configuration, restarting and managing the server is simple.
23+
Once you’ve added your MCP Server and updated the JSON configuration, restarting and managing the server is straightforward.
2424

2525
![MCP Control](../images/GitHub%20Coplot.png)
2626

0 commit comments

Comments
 (0)