Skip to content

Commit 4316589

Browse files
Phil Whittakerclaude
andcommitted
Split all sentences over 25 words in README.md for improved readability
Fixed 10 long sentences throughout the document: - Line 22: MCP clients explanation (52 → 17, 6, 23 words) - Line 31: Bridge description (26 → 16, 11 words) - Line 43: Content automation (27 → 7, 19 words) - Line 46: Quality improvements examples (27 → 19, 19 words) - Line 49: Workflow integration (28 → 19, 8 words) - Line 71: Future MCP servers (28 → 18, 10 words) - Line 83: Administrator permissions (27 → 12, 20 words) - Line 118: Configuration restart (39 → 22, 16 words) - Line 132: Destructive consequences warning (28 → 14, 17, 11 words) - Line 197: Version mismatch behavior (38 → 23, 7, 11 words) All sentences now under 25 words for better clarity and readability. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent ec0be98 commit 4316589

File tree

1 file changed

+13
-13
lines changed
  • 16/umbraco-cms/reference/developer-mcp

1 file changed

+13
-13
lines changed

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

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Think of it as giving your AI tools a secure, structured way to “speak to Umbr
1919
Unlike most Umbraco integrations, the Developer CMS MCP Server is not a plugin that you install into your Umbraco site.
2020
Instead, it runs as a standalone Node.js application that acts as an MCP server.
2121

22-
[MCP clients](./concepts/model-context-protocol.md#mcp-clients) - implemented inside compatible [host applications](./concepts/model-context-protocol.md#host-applications) such as Claude Desktop, Cursor, or Windsurf - connect to this server. When you interact with your chat-based development environment, the client communicates with the MCP Server using the Model Context Protocol (MCP).
22+
[MCP clients](./concepts/model-context-protocol.md#mcp-clients) are implemented inside compatible [host applications](./concepts/model-context-protocol.md#host-applications) such as Claude Desktop, Cursor, or Windsurf. These clients connect to this server. When you interact with your chat-based development environment, the client communicates with the MCP Server using the Model Context Protocol (MCP).
2323

2424
Learn more about [Model Context Protocol (MCP)](./concepts/model-context-protocol.md)
2525

@@ -28,7 +28,7 @@ The MCP Server, in turn, talks directly to Umbraco through the Management API. T
2828
By exposing these endpoints as MCP tools, the Developer MCP Server enables you to perform almost any backoffice action. You can do this through natural language interaction with your LLM-powered chat environment.
2929

3030
{% hint style="info" %}
31-
The MCP Server acts as the bridge between your Umbraco instance and your AI assistant, translating and adapting your tasks into Management API calls.
31+
The MCP Server acts as the bridge between your Umbraco instance and your AI assistant. It translates and adapts your tasks into Management API calls.
3232
{% endhint %}
3333

3434
## Who is this for?
@@ -39,14 +39,14 @@ While the Model Context Protocol (MCP) can be used for many types of solution, a
3939

4040
Example use cases:
4141

42-
- **Automation of content, media and schema**
43-
Automate repetitive actions such as creating or updating content or media, generating content models, or performing large-scale content or media operations directly through conversational commands.
42+
- **Automation of content, media and schema**
43+
Automate repetitive actions through conversational commands. This includes creating or updating content or media, generating content models, or performing large-scale operations.
4444

45-
- **Developer quality-of-life improvements**
46-
Speed up tasks that would otherwise take time or require numerous clicks in the backoffice UI. For example, batch-moving Document Types or Data Types, cleaning up unused entities, or synchronising content structures across environments.
45+
- **Developer quality-of-life improvements**
46+
Speed up tasks that would otherwise take time or require numerous clicks in the backoffice UI. Examples include batch-moving Document Types or Data Types, cleaning up unused entities, or synchronising content structures.
4747

48-
- **Integration into modern development workflows**
49-
Use the Developer MCP Server alongside other MCP servers such as Playwright MCP, Figma MCP, or GitHub MCP to streamline your end-to-end site development process.
48+
- **Integration into modern development workflows**
49+
Use the Developer MCP Server alongside other MCP servers such as Playwright MCP, Figma MCP, or GitHub MCP. This streamlines your end-to-end site development process.
5050

5151
- **Leveraging LLM reasoning**
5252
Use your LLM to understand, debug, or make better decisions. For example, ask it to interpret entries from Umbraco Logs, suggest schema changes, or explain configuration errors.
@@ -68,7 +68,7 @@ Do not connect the Developer MCP Server to a production Umbraco environment.
6868
Always use a local or isolated development instance.
6969
{% endhint %}
7070

71-
We are actively working on additional MCP servers tailored to other roles - such as editors and content managers - that will provide safer, simplified toolsets and workflows.
71+
We are actively working on additional MCP servers tailored to other roles such as editors and content managers. These will provide safer, simplified toolsets and workflows.
7272

7373
## Getting started
7474

@@ -80,7 +80,7 @@ The level of access you assign to this API user determines what actions your AI
8080
For example:
8181

8282
- A user with Editor permissions can manage and update content but cannot modify Document Types or perform administrative tasks.
83-
- A user with Administrator permissions grants full access — including the ability to create, edit, or delete document types, data types and more within Umbraco.
83+
- A user with Administrator permissions grants full access to all capabilities. This includes the ability to create, edit, or delete document types, data types, and more within Umbraco.
8484

8585
{% hint style="warning" %}
8686
Only use a dedicated API user for MCP connections.
@@ -115,7 +115,7 @@ Although the details vary slightly, the general pattern is the same across all h
115115

116116
```
117117

118-
Add your Umbraco MCP configuration values (Client ID, Client Secret, URL of umbraco) in the appropriate section of your host setup, then restart the MCP Server — or in some cases, restart the host application itself.
118+
Add your Umbraco MCP configuration values (Client ID, Client Secret, URL of umbraco) in the appropriate section of your host setup. Then restart the MCP Server or, in some cases, restart the host application itself.
119119

120120
Once restarted, you’ll have access to the full suite of tools available through the Umbraco CMS Developer MCP Server.
121121

@@ -129,7 +129,7 @@ You can check your current Node.js version by running node -v in your terminal.
129129
{% hint style="danger" %}
130130
**Critical: Do not connect the Developer MCP Server to a production Umbraco environment.**
131131

132-
The Developer MCP Server provides powerful, direct access to your Umbraco Management API. While this makes it an excellent tool for development and testing, it also means that mistakes, misconfigurations, or misunderstood commands can have immediate and potentially destructive consequences.
132+
The Developer MCP Server provides powerful, direct access to your Umbraco Management API. While this makes it an excellent tool for development and testing, mistakes can have serious consequences. Misconfigurations or misunderstood commands can cause immediate and potentially destructive damage.
133133

134134
**Always use the Developer MCP Server with:**
135135
- Local development instances only
@@ -194,7 +194,7 @@ The Umbraco MCP Server is designed to work with specific major versions of Umbra
194194
The MCP server automatically checks version compatibility on startup:
195195

196196
- **✅ Version Match**: No message displayed, server functions normally
197-
- **⚠️ Version Mismatch**: The first tool request will fail with an error message asking you to retry if you want to proceed. After you retry, the warning is displayed once more and then never shown again for that session.
197+
- **⚠️ Version Mismatch**: The first tool request will fail with an error message asking you to retry if you want to proceed. After you retry, the warning displays once more. It is then never shown again for that session.
198198
- **⚠️ API Error**: If the version check API call fails, a warning is displayed once but does not block tool execution.
199199

200200
The version check uses the Umbraco Management API endpoint `/umbraco/management/api/v1/server/information` to detect the connected Umbraco version and compares the major version number.

0 commit comments

Comments
 (0)