Skip to content

Commit 6be83f9

Browse files
Phil Whittakerclaude
andcommitted
Improve sentence clarity and readability in documentation
- Split long sentences in README.md to be under 25 words each - Changed "easy" to "straightforward" for more professional tone - Updated creating-media.md for consistency - Updated Acronyms.yml with new terms 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent d460fc3 commit 6be83f9

File tree

3 files changed

+10
-7
lines changed

3 files changed

+10
-7
lines changed

.github/styles/UmbracoDocs/Acronyms.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,6 +68,7 @@ exceptions:
6868
- KUDU # Azure deployment engine
6969
- LDAP # Lightweight Directory Access Protocol
7070
- LINK #
71+
- MCP # Mode Context Protocol
7172
- MIT # Open-source software license developed at the Massachusetts Institute of Technology (MIT)
7273
- MDN # Mozilla Developer Network
7374
- MFA # Multi-factor Authentication

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

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,11 @@ description: Get started with the CMS developer MCP.
44

55
# Developer Model Context Protocol (MCP) server
66

7-
The Developer [MCP Server](./concepts/model-context-protocol.md#mcp-servers) makes it easy for developers to connect AI tools with Umbraco. It allows you to harness large language models (LLMs) to perform almost any task that can be achieved within the Umbraco backoffice — from generating and editing content to managing media, automating workflows, and assisting with complex development tasks.
7+
The Developer [MCP Server](./concepts/model-context-protocol.md#mcp-servers) makes it straightforward for developers to connect AI tools with Umbraco. It allows you to harness large language models (LLMs) to perform almost any task that can be achieved within the Umbraco backoffice. This includes generating and editing content, managing media, automating workflows, and assisting with complex development tasks.
88

9-
This MCP Server acts as a secure gateway between your Umbraco installation and MCP-compatible AI environments such as Claude (Desktop or Code), Cursor, or GitHub Copilot. Through this bridge, your AI assistant can interact directly with Umbraco’s Management API, enabling a more natural, conversational way to develop and maintain your sites.
9+
This MCP Server acts as a secure gateway between your Umbraco installation and MCP-compatible AI environments such as Claude (Desktop or Code), Cursor, or GitHub Copilot.
10+
11+
Through this bridge, your AI assistant can interact directly with Umbraco's Management API. This enables a more natural, conversational way to develop and maintain your sites.
1012

1113
{% hint style="info" %}
1214
Think of it as giving your AI tools a secure, structured way to “speak to Umbraco.”
@@ -21,9 +23,9 @@ Instead, it runs as a standalone Node.js application that acts as an MCP server.
2123

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

24-
The MCP Server, in turn, talks directly to Umbraco through the Management API. This is the same API layer that powers the Umbraco backoffice, allowing it to read from and modify the CMS.
26+
The MCP Server, in turn, talks directly to Umbraco through the Management API. This is the same API layer that powers the Umbraco backoffice and allows the server to directly read from and modify the CMS.
2527

26-
By exposing these endpoints as MCP tools, the Developer MCP Server enables you to perform almost any backoffice action through natural language interaction with your LLM-powered chat environment.
28+
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.
2729

2830
{% hint style="info" %}
2931
The MCP Server acts as the bridge between your Umbraco instance and your AI assistant, translating and adapting your tasks into Management API calls.
@@ -49,7 +51,7 @@ Use the Developer MCP Server alongside other MCP servers such as Playwright MCP,
4951
- **Leveraging LLM reasoning**
5052
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.
5153

52-
- [**plus many, many more**](./scenarios.md)
54+
- [**Plus many, many more**](./scenarios.md)
5355

5456
**Not recommended for non-developers**
5557

16/umbraco-cms/reference/developer-mcp/best-practice/creating-media.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to create media items in Umbraco using the Developer MCP
44

55
# Creating Media
66

7-
The Developer MCP server provides powerful tools for creating media items with AI agents. You can upload media from local files, remote URLs, or base64-encoded data, making it easy to automate media management tasks.
7+
The Developer MCP server provides powerful tools for creating media items with AI agents. You can upload media from local files, remote URLs, or base64-encoded data, making it sinple to automate media management tasks.
88

99
## Available Media Creation Tools
1010

@@ -73,7 +73,7 @@ Upload media from base64-encoded data. This method is suitable for small files (
7373
**Best Practices:**
7474
- Use only for small files (under 5KB recommended)
7575
- Prefer file path or URL methods when possible
76-
- Base64 encoding significantly increases the size of data sent
76+
- Base64 encoding increases the size of data sent
7777

7878
**Example prompt:**
7979
```

0 commit comments

Comments
 (0)