From 65e43bd945fa1ebaec1e0fa9452378ab448432d5 Mon Sep 17 00:00:00 2001 From: Yiyun Liao Date: Thu, 23 Apr 2026 10:41:39 +0200 Subject: [PATCH 1/6] Add documentation for Maia MCP Server --- .../maia-make/maia-mcp-server.md | 40 +++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md new file mode 100644 index 00000000000..47fd4ab5531 --- /dev/null +++ b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md @@ -0,0 +1,40 @@ +--- +title: "Maia MCP Server" +linktitle: "MCP Server" +url: /refguide/maia-mcp-server/ +weight: 80 +description: "Describes the features in Maia MCP Server." +#If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details. +--- + +## Introduction + +{{% alert color="info" %}} +This feature is available in Studio Pro 11.10 and above. + +To use Maia MCP Client, an internet connection and signing in to Studio Pro are required. +{{% /alert %}} + +The Maia MCP Server in Studio Pro enables you to leverage Maia's capabilities directly from external clients, including AI Coding Assistants, Agents, and other MCP-based LLM tools. + +## Enabling the MCP Server + +To enable the MCP Server, navigate to **Preferences** > **Maia** > **MCP Server** and check **Enable MCP Server**. From this menu, you can also configure the port to use. + +### Connecting External Clients + +Once enabled, you can connect external clients to the MCP Server. For example, to add it to Claude Code, run the following command: + +`claude mcp add --transport http http://localhost:/mcp` + +Replace `` with your preferred server name and `` with the port configured in **Preferences**. + +## Key Highlights + +* Full Maia feature parity — The MCP Server exposes the same capabilities as Maia within Studio Pro. +* Live updates — Any changes made through Maia via the MCP Server are reflected in real time within Studio Pro. + +## Read More + +* [Mendix AI Assistance (Maia)](/refguide/mendix-ai-assistance/) +* [Maia Chat](/refguide/maia-chat/) \ No newline at end of file From 7b6192006fe041022ba422c581df554bfd8c9c49 Mon Sep 17 00:00:00 2001 From: Yiyun Liao Date: Thu, 23 Apr 2026 10:56:07 +0200 Subject: [PATCH 2/6] Review --- .../maia-make/maia-mcp-server.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md index 47fd4ab5531..cf70b7ce68e 100644 --- a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md +++ b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md @@ -15,11 +15,16 @@ This feature is available in Studio Pro 11.10 and above. To use Maia MCP Client, an internet connection and signing in to Studio Pro are required. {{% /alert %}} -The Maia MCP Server in Studio Pro enables you to leverage Maia's capabilities directly from external clients, including AI Coding Assistants, Agents, and other MCP-based LLM tools. +The Maia MCP Server in Studio Pro enables you to leverage Maia's capabilities directly from external clients, including AI coding assistants, agents, and other MCP-based LLM tools. + +It has the following key highlights: + +* Full Maia feature parity — The MCP Server exposes the same capabilities that Maia offers within Studio Pro. +* Live updates — Any changes made through Maia via the MCP Server are reflected in real time within Studio Pro. ## Enabling the MCP Server -To enable the MCP Server, navigate to **Preferences** > **Maia** > **MCP Server** and check **Enable MCP Server**. From this menu, you can also configure the port to use. +To enable the MCP Server, navigate to **Preferences** > **Maia** > **MCP Server**, and check **Enable MCP Server**. You can also configure the port in this menu. ### Connecting External Clients @@ -29,12 +34,7 @@ Once enabled, you can connect external clients to the MCP Server. For example, t Replace `` with your preferred server name and `` with the port configured in **Preferences**. -## Key Highlights - -* Full Maia feature parity — The MCP Server exposes the same capabilities as Maia within Studio Pro. -* Live updates — Any changes made through Maia via the MCP Server are reflected in real time within Studio Pro. - ## Read More * [Mendix AI Assistance (Maia)](/refguide/mendix-ai-assistance/) -* [Maia Chat](/refguide/maia-chat/) \ No newline at end of file +* [Maia Chat](/refguide/maia-chat/) From 9a97961f24c80a0eaa9a373b35aeec4772eb430e Mon Sep 17 00:00:00 2001 From: Yiyun Liao Date: Thu, 23 Apr 2026 17:44:44 +0200 Subject: [PATCH 3/6] Add MCP Server section to the Maia Tab in Preferences dialog --- .../mendix-ai-assistance/maia-make/maia-mcp-server.md | 4 ++-- .../refguide/modeling/menus/edit-menu/preferences-dialog.md | 6 ++++++ 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md index cf70b7ce68e..f5753e4bd95 100644 --- a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md +++ b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md @@ -12,10 +12,10 @@ description: "Describes the features in Maia MCP Server." {{% alert color="info" %}} This feature is available in Studio Pro 11.10 and above. -To use Maia MCP Client, an internet connection and signing in to Studio Pro are required. +To use Maia MCP Server, an internet connection and signing in to Studio Pro are required. {{% /alert %}} -The Maia MCP Server in Studio Pro enables you to leverage Maia's capabilities directly from external clients, including AI coding assistants, agents, and other MCP-based LLM tools. +Maia MCP Server in Studio Pro enables you to leverage Maia's capabilities directly from external clients, including AI coding assistants, agents, and other MCP-based LLM tools. It has the following key highlights: diff --git a/content/en/docs/refguide/modeling/menus/edit-menu/preferences-dialog.md b/content/en/docs/refguide/modeling/menus/edit-menu/preferences-dialog.md index 8378392a0e3..581c0a7902a 100644 --- a/content/en/docs/refguide/modeling/menus/edit-menu/preferences-dialog.md +++ b/content/en/docs/refguide/modeling/menus/edit-menu/preferences-dialog.md @@ -138,6 +138,12 @@ The **Best Practice Recommender** section contains the following settings: * **Automatically run an inspection after opening an app** – when enabled, [Best Practice Recommender](/refguide/best-practice-recommender/) automatically runs an inspection when an app is opened. If the app contains errors, the inspection will not run. It is enabled by default. +### MCP Server + +* **Enable MCP Server** - When enabled, you can use the [Maia MCP Server](/refguide/maia-mcp-server/) in Studio Pro, which enables you to leverage Maia's capabilities directly from external clients, including AI coding assistants, agents, and other MCP-based LLM tools. It is disabled by default. + + **Port** (Default: 7782) - With this setting, you can configure the port of the server. + ## Model Tab ### Pages From de8227051fd6f883f598cfb588d638950affaf15 Mon Sep 17 00:00:00 2001 From: Yiyun Liao Date: Thu, 23 Apr 2026 17:46:16 +0200 Subject: [PATCH 4/6] Update doc weight --- .../modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md index f5753e4bd95..1c18414d4f2 100644 --- a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md +++ b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md @@ -2,7 +2,7 @@ title: "Maia MCP Server" linktitle: "MCP Server" url: /refguide/maia-mcp-server/ -weight: 80 +weight: 85 description: "Describes the features in Maia MCP Server." #If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details. --- From 481d979dd6221b0a7810cf27487c87fe67c2359f Mon Sep 17 00:00:00 2001 From: Yiyun Liao Date: Fri, 24 Apr 2026 10:27:00 +0200 Subject: [PATCH 5/6] Update feature name based on feedback --- .../mendix-ai-assistance/maia-make/maia-mcp-server.md | 11 ++++++----- .../modeling/menus/edit-menu/preferences-dialog.md | 4 ++-- 2 files changed, 8 insertions(+), 7 deletions(-) diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md index 1c18414d4f2..0c35fd8250b 100644 --- a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md +++ b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md @@ -1,9 +1,9 @@ --- -title: "Maia MCP Server" +title: "Studio Pro MCP Server" linktitle: "MCP Server" -url: /refguide/maia-mcp-server/ +url: /refguide/studio-pro-mcp-server/ weight: 85 -description: "Describes the features in Maia MCP Server." +description: "Describes the features in Studio Pro MCP Server." #If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details. --- @@ -12,10 +12,10 @@ description: "Describes the features in Maia MCP Server." {{% alert color="info" %}} This feature is available in Studio Pro 11.10 and above. -To use Maia MCP Server, an internet connection and signing in to Studio Pro are required. +To use Studio Pro MCP Server, an internet connection and signing in to Studio Pro are required. {{% /alert %}} -Maia MCP Server in Studio Pro enables you to leverage Maia's capabilities directly from external clients, including AI coding assistants, agents, and other MCP-based LLM tools. +Studio Pro MCP Server enables you to leverage Maia's capabilities directly from external clients, including AI coding assistants, agents, and other MCP-based LLM tools. It has the following key highlights: @@ -36,5 +36,6 @@ Replace `` with your preferred server name and `` with the port conf ## Read More +* [Maia Make Capabilities](/refguide/maia-make/) * [Mendix AI Assistance (Maia)](/refguide/mendix-ai-assistance/) * [Maia Chat](/refguide/maia-chat/) diff --git a/content/en/docs/refguide/modeling/menus/edit-menu/preferences-dialog.md b/content/en/docs/refguide/modeling/menus/edit-menu/preferences-dialog.md index 581c0a7902a..b35dfa6fd42 100644 --- a/content/en/docs/refguide/modeling/menus/edit-menu/preferences-dialog.md +++ b/content/en/docs/refguide/modeling/menus/edit-menu/preferences-dialog.md @@ -128,7 +128,7 @@ The **In-Editor Recommender** section contains the following settings: * **Enable for microflow, nanoflow, and rule editors** – this allows you to enable and disable [Logic Recommender](/refguide/logic-recommender/) in the microflow, nanoflow, and rule editors. It is enabled by default. * **Enable for workflow editor** – this allows you to enable and disable [Workflow Recommender](/refguide/workflow-recommender/) in the workflow editor. It is enabled by default. -* **Enable for page editor** - this allows you to enable and disable the [UI Recommendor](/refguide/ui-recommender/). It is enabled by default. +* **Enable for page editor** - this allows you to enable and disable the [UI Recommender](/refguide/ui-recommender/). It is enabled by default. ### Best Practice Recommender @@ -140,7 +140,7 @@ The **Best Practice Recommender** section contains the following settings: ### MCP Server -* **Enable MCP Server** - When enabled, you can use the [Maia MCP Server](/refguide/maia-mcp-server/) in Studio Pro, which enables you to leverage Maia's capabilities directly from external clients, including AI coding assistants, agents, and other MCP-based LLM tools. It is disabled by default. +* **Enable MCP Server** - When enabled, you can use the [Studio Pro MCP Server](/refguide/studio-pro-mcp-server/), which enables you to leverage Maia's capabilities directly from external clients, including AI coding assistants, agents, and other MCP-based LLM tools. It is disabled by default. **Port** (Default: 7782) - With this setting, you can configure the port of the server. From 68f6c34011e64c177809109558facb19a2d8ca87 Mon Sep 17 00:00:00 2001 From: Yiyun Liao Date: Fri, 24 Apr 2026 10:30:00 +0200 Subject: [PATCH 6/6] Rename file name --- .../maia-make/{maia-mcp-server.md => studio-pro-mcp-server.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/{maia-mcp-server.md => studio-pro-mcp-server.md} (100%) diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/studio-pro-mcp-server.md similarity index 100% rename from content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp-server.md rename to content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/studio-pro-mcp-server.md