diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/_index.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/_index.md index ded9e2b8f06..b0aae17cdf9 100644 --- a/content/en/docs/refguide/modeling/mendix-ai-assistance/_index.md +++ b/content/en/docs/refguide/modeling/mendix-ai-assistance/_index.md @@ -39,6 +39,16 @@ Mendix AI Assistance (Maia) in Studio Pro has the following capabilities: Starting point for app creation: * **Start with Maia** - a starting point in Studio Pro that helps you to start the app development process. Based on a required text description and an optional image or PDF, it generates an app that includes a domain model, data management overview pages, test data, and a tailored homepage. For more information, see [Start with Maia](/refguide/start-with-maia/). +* **Maia Make** - a unified conversational UI in Studio Pro that consolidates all AI-assisted development capabilities into a single chat experience. With Maia Make, everything happens in one place. Start a conversation, describe what you need, and let Maia do the rest—generating a new domain model, overview pages, or microflows, or explaining your app logic and pages. Below is a list of Maia Make Capabilities: + + * **Domain model creation** - Describe your data structure and Maia creates the entities and associations you need. + * **Page generation** - Generate overview pages. + * **Microflow generation** - Generate microflows, enumerations, XPath constraints, and expressions. + * **MCP client** - Connect to compatible MCP Servers to leverage tools such as Playwright or Figma to improve the capabilities of Maia. + * **Document upload** - Upload a PDF or an image and you can ask Maia to use it in your app creation. + * **User story linking** - Select an existing story in Studio Pro and Maia can help you realize it. + + Maia Make is released in Studio Pro 11.8. For more information, see [Maia Make](/refguide/maia-make/). Guidance: diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-for-workflows.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-for-workflows.md index f78c2d17755..2c56237023c 100644 --- a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-for-workflows.md +++ b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-for-workflows.md @@ -12,6 +12,10 @@ description: "Describes the features in Maia for Workflows." To use Maia for Workflows, an internet connection and signing in to Studio Pro are required. {{% /alert %}} +{{% alert color="info" %}} +In Studio Pro 11.8, Maia for Workflows is not available. +{{% /alert %}} + Maia for Workflows helps you generate a [workflow](/refguide/workflows/). It can also provide explanations or further improvements based on the generated elements. The current version has some known limitations. For example, it is currently intended only for use with empty workflows. Generated elements are appended to the end of the workflow, which may result in incorrectly modeled workflows if the workflow is not empty. For more details, see the [Limitations](#limitation) section below. ## Using Maia for Workflows diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/_index.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/_index.md new file mode 100644 index 00000000000..0cebf9cc350 --- /dev/null +++ b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/_index.md @@ -0,0 +1,68 @@ +--- +title: "Maia Make" +url: /refguide/maia-make/ +weight: 4 +description: "Describes Maia Make capabilities in Mendix Studio Pro." +description_list: true +#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" %}} +Maia Make is available in Studio Pro 11.8 and above. + +To use Maia Make capabilities, an internet connection and signing in to Studio Pro are required. +{{% /alert %}} + +Maia Make is a unified conversational interface in Studio Pro that brings AI-assisted development capabilities into a single chat window. Describe your requirements in natural language, and Maia Make generates development artifacts such as data structures, overview pages, and microflows. + +You can also ask Maia Make to provide explanations of your existing logic and pages. Moreover, this interface allows you to integrate with external tools via MCP Servers (Playwright, Figma, and others) and it supports story-based development by aligning generated artifacts with user story acceptance criteria. + +The key capabilities of the Maia Make are as follows: + +* Conversational assistance for general Mendix development queries +* Logic and page explanations to clarify existing implementation details +* Domain model generation from natural language descriptions +* Overview page generation from natural language descriptions +* Microflow generation including XPath constraints and expressions +* External tool integration via compatible MCP Servers (such as Playwright, Figma) +* Story-based development to help realize existing user stories +* PDF and image support to help Maia understand your requirements better +* Add relevant logic and pages to the interface to give Maia a more desired context + +## Using Maia Make + +Maia Make is enabled by default. It is possible to disable it in Studio Pro **Preferences**, via the **Maia** tab. + +To access it, in the upper-right corner of Studio Pro, click the **Maia** pane: + +{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-make-interface.png" max-width=40% alt="Maia Make interface" >}} + +{{% todo %}}Update the screenshot when the latest build is available{{% /todo %}} + +Alternatively, you can also click **View** at the Studio Pro top bar and select **Maia** to open the interface. + +### Maia Make Interface Overview + +The Maia Make conversational interface includes the following options: + +* **New chat** - It allows you to clear the messages and start a new conversation which does not reference your current chat. +* **Configure MCP Connections** ({{% icon name="plug" %}}) icon - It allows you to connect external [MCP](https://modelcontextprotocol.io/introduction) servers to Maia, giving it access to third-party tools during chat. For more information on how to configure MCP connections, see [Maia MCP Client](/refguide/maia-mcp/). +* **Add** attachments (Image, Story, PDF) - With this option, you can attach images, PDFs, or user stories to help Maia understand your requirements better. +* **Add to Maia Context** - It allows you to add certain logic or pages to Maia as context. You can also access this option by right-clicking the documents (microflows or pages) in the **App Explorer** and it appears in the context menu. + +For more information on how some of Maia key capabilities work, refer to the following documents: + +* [Maia Chat](/refguide/maia-chat/) +* [Maia Explain](/refguide/maia-explain/) +* [Maia for Domain Model](/refguide/maia-for-domain-model/) +* [Maia for Pages](/refguide/maia-for-pages/) +* [Maia for Microflows](/refguide/maia-for-microflows/) +* [Maia MCP Client](/refguide/maia-mcp/) + +In Studio Pro 11.8 and above, most of the features described in the documents above are available only through the Maia Make interface. There are no separate entry points to these features in their respective editors. [Maia Explain](/refguide/maia-explain/) is an exception. You can still access this feature by right-clicking the documents (microflows or pages) in the **App Explorer** and the **Maia Explain** option is in the context menu. + +## Read More + +* [Mendix AI Assistance (Maia)](/refguide/mendix-ai-assistance/) diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-chat.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-chat.md similarity index 84% rename from content/en/docs/refguide/modeling/mendix-ai-assistance/maia-chat.md rename to content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-chat.md index fcf60788859..44a86f74beb 100644 --- a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-chat.md +++ b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-chat.md @@ -36,20 +36,26 @@ See below a list of Maia Chat's data sources: ## Using Maia Chat in Studio Pro -There are two ways to access Maia Chat in Studio Pro: +{{% alert color="info" %}} +In Studio Pro 11.8 and above, Maia Chat is incorporated into the unified [Maia Make](/refguide/maia-make/) interface. There is no dedicated interface only for Maia Chat. With Maia Make, you can ask questions, ask Maia to explain your logic and pages, and let it generate development artifacts such as data structures, overview pages, and microflows for you. + +Maia Make is enabled by default. It is possible to disable it in Studio Pro **Preferences**, via the **Maia** tab. +{{% /alert %}} + +In Studio Pro 11.7 and below, there are two ways to access Maia Chat in Studio Pro: * Click the **Maia** ({{% icon name="sparkles" %}}) icon to the right of the top bar. * Go to the **View** menu and click **Maia**. The chat interface appears at the right side of Studio Pro under the **Maia** pane: -{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-chat/maia-chat-interface.png" width="250px">}} +{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-chat/maia-chat-interface.png" width="250px">}} You can start using Maia Chat by clicking one of the demo questions. Alternatively, you can ask your own question, and press Enter or click **Ask** to send the question. For information on the supported shortcut keys in Maia Chat, see the [Maia Chat Shortcut Keys](/refguide/keyboard-shortcuts/#maia-chat-shortcuts) section in *Keyboard Shortcuts*. For more information on Maia Chat features in Studio Pro, see the sub-sections below. -If Maia is not giving you a good answer, check the [best practices](/portal/maia/#best-practices) in *Maia in Mendix Portal*. If you still can't get a good answer, please see [Giving Feedback](#feedback), below for information on how to let Mendix know. +If Maia is not giving you a good answer, check the [best practices](/portal/maia/#best-practices) in *Maia in Mendix Portal*. If you still can not get a good answer, please see the [Giving Feedback](#feedback) section below for information on how to let Mendix know. ### Maia Chat Features in Studio Pro @@ -72,7 +78,7 @@ There are several ways to give feedback on the generated answer: * Click the thumbs up icon ({{% icon name="thumbs-up" %}}) or the thumbs down icon ({{% icon name="thumbs-down" %}}) * To provide more detailed feedback, click the add feedback icon ({{% icon name="notes-paper-edit" %}}). A detailed **Feedback** section shows below the answer: - {{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-chat/feedback-section.png" width="250px" >}} + {{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-chat/feedback-section.png" width="250px" >}} * You can rate the **correctness**, **completeness**, and **readability** of the provided answer. * You can also provide **Additional feedback** if you want to. diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-explain.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-explain.md similarity index 76% rename from content/en/docs/refguide/modeling/mendix-ai-assistance/maia-explain.md rename to content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-explain.md index 0a75fa2bb31..ed3bce1e5d0 100644 --- a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-explain.md +++ b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-explain.md @@ -12,9 +12,15 @@ description: "Describes the features in Maia Explain." To use Maia Explain, an internet connection and signing in to Studio Pro are required. {{% /alert %}} +{{% alert color="info" %}} +In Studio Pro 11.8 and above, Maia Explain is incorporated into the unified [Maia Make](/refguide/maia-make/) interface. There is no dedicated interface only for Maia Explain. With Maia Make, you can ask questions, ask Maia to explain your logic and pages, and let it generate development artifacts such as data structures, overview pages, and microflows for you. + +Maia Make is enabled by default. It is possible to disable it in Studio Pro **Preferences**, via the **Maia** tab. +{{% /alert %}} + Maia Explain helps you easily understand a microflow or a nanoflow. It explains the general purpose of the logic and highlights specific technical details to help you understand the logic further. -## Using Maia Explain +## Using Maia Explain in Studio Pro 11.7 and Below Maia Explain is enabled by default. If you want to disable this feature, go to **Edit** > **Preferences** > the **Maia** tab and clear the **Enable Maia Explain** checkbox. @@ -25,7 +31,7 @@ There are two ways to launch Maia Explain: A message is sent to Maia and a chat interface with an initial answer appears on the right side of Studio Pro under the **Maia** tab: -{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-explain/maia-explain-interface.png" width="300px">}} +{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-explain/maia-explain-interface.png" width="300px">}} The initial answer consists of two parts: diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-for-domain-model.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-domain-model.md similarity index 85% rename from content/en/docs/refguide/modeling/mendix-ai-assistance/maia-for-domain-model.md rename to content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-domain-model.md index 67f999ee73c..5e6ecaea6ad 100644 --- a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-for-domain-model.md +++ b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-domain-model.md @@ -18,11 +18,15 @@ Maia for Domain Model helps you generate new [domain model](/refguide/domain-mod ## Using Maia for Domain Model -Maia for Domain Model is enabled by default. +{{% alert color="info" %}} +In Studio Pro 11.8 and above, Maia for Domain Model is incorporated into the unified [Maia Make](/refguide/maia-make/) interface. There is no dedicated interface only for Maia for Domain Model. With Maia Make, you can ask questions, ask Maia to explain your logic and pages, and let it generate development artifacts such as data structures, overview pages, and microflows for you. + +Maia Make is enabled by default. It is possible to disable it in Studio Pro **Preferences**, via the **Maia** tab. +{{% /alert %}} -You can find it in the the toolbar of a domain model: +In Studio Pro 11.7 and below, Maia for Domain Model is enabled by default. You can find it in the the toolbar of a domain model: -{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-for-domain-model/maia-for-domain-model.png" max-width=80% >}} +{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-domain-model/maia-for-domain-model.png" max-width=80% >}} If you want to disable this feature, go to **Edit** > **Preferences** > the **Maia** tab and clear the **Enable Maia for Domain Model** checkbox. diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-microflows.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-microflows.md new file mode 100644 index 00000000000..b2bcca65ab0 --- /dev/null +++ b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-microflows.md @@ -0,0 +1,47 @@ +--- +title: "Maia for Microflows" +url: /refguide/maia-for-microflows/ +weight: 75 +description: "Describes the features in Maia for Microflows." +--- +## Introduction + +{{% alert color="info" %}} +This feature is released as part of [Make Make](/refguide/maia-make/) capabilities in Studio Pro 11.8. +{{% /alert %}} + +Maia for Microflows is an AI-powered capability that is available when using [Maia Make](/refguide/maia-make/) in Studio Pro. Maia Make is a unified conversational interface within Studio Pro that consolidates all AI-assisted development capabilities into a single chat experience. + +With the microflow generation capability, you can leverage Maia to generate microflow logic efficiently from your text input. It is a powerful tool for quickly setting up both simple and complex microflows, with the goal of providing ready-to-use logic that minimizes the need for manual adjustments. + +## Using Maia for Microflows + +Open the Maia Make conversational interface in Studio Pro to access its microflow generation capability. Use natural language to describe your goal, Maia will generate the microflows for you, including XPath constraints and expressions. See the section below for text input best practices. + +### Best Practices for Text Input + +To achieve the best results when using Maia to generate microflows, consider the following guidelines for your text input: + +* Be specific: Clearly describe the desired outcome and the steps involved. For example, instead of using *Create a user*, use *Create a new user object, set its name attribute to 'John Doe', and commit it*. +* Use keywords: Incorporate terms relevant to microflow activities, such as *create object*, *retrieve*, *change object*, *show message*, *loop*, or *decision*. This can help with correct microflow generation. +* Provide context: If your microflow interacts with existing entities or attributes, mention them in your text input. + +## Limitations + +### Destructive Operations Are Not Supported + +Maia for Microflows can create objects and flows and change simple ("primitive") settings, but it cannot delete objects or replace complex configuration settings. For example, for existing objects, Maia can change variable names, move objects, or reconnect flows, but it cannot delete objects or flows, or change the activity types. + +### Variability in Results + +Due to the nature of AI generation, the exact microflow logic produced can vary between separate runs, even with identical input. It is recommended to review the generated output carefully. + +### Layout and Positioning + +While Maia aims to create functional logic, the visual layout and positioning of elements within the generated microflow may not always be optimally organized. You may need to adjust the arrangement of activities for better readability and structure. + +## Read More + +* [Microflows](/refguide/microflows/) +* [Mendix AI Assistance (Maia)](/refguide/mendix-ai-assistance/) +* [Maia Chat](/refguide/maia-chat/) diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-for-pages.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-pages.md similarity index 88% rename from content/en/docs/refguide/modeling/mendix-ai-assistance/maia-for-pages.md rename to content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-pages.md index 943b507ef98..286539a0c13 100644 --- a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-for-pages.md +++ b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-pages.md @@ -18,11 +18,17 @@ Maia for Pages helps you generate a [page](/refguide/page/) by adding and config ## Using Maia for Pages -To enable Maia for Pages, go to **Edit** > **Preferences** > the **Maia** tab and select **Enable Maia for Pages**. +{{% alert color="info" %}} +In Studio Pro 11.8 and above, Maia for Pages is incorporated into the unified [Maia Make](/refguide/maia-make/) interface. There is no dedicated interface only for Maia for Pages. With Maia Make, you can ask questions, ask Maia to explain your logic and pages, and let it generate development artifacts such as data structures, overview pages, and microflows for you. + +Maia Make is enabled by default. It is possible to disable it in Studio Pro **Preferences**, via the **Maia** tab. +{{% /alert %}} + +In Studio Pro 11.7 and below, to enable Maia for Pages, go to **Edit** > **Preferences** > the **Maia** tab and select **Enable Maia for Pages**. Once enabled, you can find it in the the toolbar of a page: -{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-for-pages/maia-for-pages.png" max-width=80% >}} +{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-pages/maia-for-pages.png" max-width=80% >}} {{% alert color="info" %}} Maia for Pages is available in both the **Structure mode** and **Design mode**. diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp.md new file mode 100644 index 00000000000..6b45dcee4c8 --- /dev/null +++ b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-mcp.md @@ -0,0 +1,130 @@ +--- +title: "Maia MCP Client" +linktitle: "MCP Client" +url: /refguide/maia-mcp/ +weight: 80 +description: "Describes the features in Maia MCP Client." +#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" %}} +To use Maia MCP Client, an internet connection and signing in to Studio Pro are required. +{{% /alert %}} + +Maia MCP Client, available from Studio Pro 11.8, helps you connect Maia to external [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) servers. Once connected, Maia can call tools provided by these servers during chat — for example, querying an external API, looking up design assets, or interacting with third-party services. You can find available MCP servers on the [MCP servers directory](https://modelcontextprotocol.io/examples). + +For information on the current limitations, see the [Limitations](#limitations) section below. + +## Using MCP Client {#using-mcp-client} + +To open the MCP Client panel, click the **Configure MCP Connections** ({{% icon name="plug" %}}) icon in the **Maia** toolbar. + +### Adding an MCP Server {#adding-server} + +To add a server, fill in the following fields and click **Add**: + +* **Server Name** — A display name. Must be unique among your configured servers. +* **URL** — The server endpoint. Must use `https://` or `http://`. +* **Connection type** — **HTTP (Streamable)** for most servers, or **SSE (Legacy)** for older servers that use Server-Sent Events instead of Streamable HTTP. +* **Authentication** — See the [Authentication](#authentication) section below. + +#### Authentication {#authentication} + +Choose how Studio Pro authenticates with the MCP server: + +* **No Auth** — select this for servers that do not require credentials. +* **Bearer Token** — paste an API token or personal access token. The token is stored securely and is not exposed after entry. +* **OAuth 2.1** — a browser window opens so you can authorize Studio Pro with the server's provider. Two optional fields appear: + * **Client ID** — required if the server does not support automatic client registration. + * **Client Secret** — required by some providers (for example, GitHub). + +Most major providers — including GitHub and Figma — do not support automatic client registration. For these, you must first create an OAuth application in the provider's developer portal and then enter the **Client ID** (and **Client Secret** if required). + +##### Example: Connecting to GitHub Copilot MCP {#github-example} + +1. Go to [GitHub Developer Settings](https://github.com/settings/developers) and click **New OAuth App**. +2. Fill in the following information: + * **Application name** — for example, `Mendix Studio Pro` + * **Homepage URL** — for example, `https://mendix.com` + * **Authorization callback URL** — `http://localhost:{port}/mcp/oauth/callback` (see the [Callback URL](#callback-url) section below) +3. Click **Register application**, then copy the **Client ID**. +4. Click **Generate a new client secret** and copy it — GitHub shows it only once. +5. In Studio Pro, add a server with the following details: + * **URL** — `https://api.githubcopilot.com/mcp/` + * **Authentication** — **OAuth 2.1** + * **Client ID** and **Client Secret** — from the steps above +6. Click **Add**, authorize in the browser, and the connection completes. + +{{% alert color="info" %}} +For Figma MCP, the simplest option is to generate a personal access token in Figma and use **Bearer Token** authentication. If you need OAuth, register an app at [Figma Developers](https://www.figma.com/developers), add the callback URL, and request the `mcp:connect` scope. +{{% /alert %}} + +##### Callback URL {#callback-url} + +The OAuth callback URL format is `http://localhost:{port}/mcp/oauth/callback`. The port is assigned by Studio Pro's built-in web server. You can find the actual port within the callback URL that Studio Pro generates when you add the server. + +{{% alert color="info" %}} +If your OAuth app requires a fixed callback URL, you can start Studio Pro with the `--web-server-port=45678` command-line flag to use a specific port. +{{% /alert %}} + +### Managing Connections {#managing-connections} + +Each server appears as a card in the MCP Client panel: + +* **Enable or disable** a server using the checkbox. Disabling a server disconnects it and removes its tools from Maia. +* **Expand** the card to see its tools. +* **Remove** a server from the expanded view. + +#### Connection Status {#connection-status} + +| Color | Meaning | +| --- | --- | +| Green | Connected, tools available. | +| Orange | Connecting, authenticating, or disconnecting. | +| Blue | Loading tools from the server. | +| Red | Error. Check the error message for details. | +| Grey | Disconnected or disabled. | + +If a connection drops, Studio Pro reconnects automatically. During reconnection, the status shows the retry progress (for example, **Retrying (2/5)...**). If all retries fail, disable and re-enable the server to try again. + +### Managing Tools {#managing-tools} + +After connecting, the server's tools appear in the expanded card. Each tool shows a name and description from the server. + +Tools from a new server are **disabled by default**. Select a tool's checkbox to enable it. Use the **select all** checkbox to enable or disable all tools at once. Only enabled tools are available to Maia. + +### How Maia Uses MCP Tools {#using-tools} + +During chat, Maia considers all enabled MCP tools alongside its built-in capabilities. When Maia calls a tool: + +1. The chat shows **Executing {tool} from {server}...** with a spinner. +2. The tool runs on the MCP server and returns a result. +3. Maia uses the result to formulate its answer. + +You see the answer from Maia, not the raw tool output. + +## Troubleshooting {#troubleshooting} + +| Problem | Solution | +| --- | --- | +| "This server requires manual OAuth client registration" | Register an OAuth app with the provider and enter the Client ID. See the [GitHub example](#github-example) given above. | +| "Token exchange failed" or "incorrect_client_credentials" | Verify your Client ID and Client Secret. Check that the callback URL matches. | +| Authentication stuck in "Authenticating..." | Check that no firewall blocks localhost. Remove the server and add it again to restart the flow. | +| Connection fails immediately | Verify the URL. Try switching between **HTTP (Streamable)** and **SSE (Legacy)**. | + +## Limitations {#limitations} + +Maia MCP Client has the following limitations: + +* Only MCP tools are supported. Other MCP capabilities, such as resources and prompts, are not available. +* Only remote servers (HTTP or SSE) are supported. Local stdio servers are not supported. +* Tools from new servers are disabled by default. +* OAuth requires localhost access for the [callback URL](#callback-url). +* Server configurations are stored per project and are not shared across projects. + +## Read More + +* [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 e46ee663d8e..d30a9e3bfd4 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 @@ -108,6 +108,10 @@ You can specify which repositories to use for Gradle. The content of this field ### Generative AI +* **Enable Maia** - When enabled, you can access all Maia capabilities in Studio Pro. It is enabled by default. + +In Studio Pro 11.7 and below, the **Generative AI** section contains the following settings: + The **Generative AI** section contains the following settings: * **Enable Start with Maia** – When enabled, you can use the **Start with Maia** starting point in Studio Pro to help you create an app. For more information on how to use this feature, see [Start with Maia](/refguide/start-with-maia/). It is enabled by default. diff --git a/static/attachments/refguide/modeling/mendix-ai-assistance/maia-chat/feedback-section.png b/static/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-chat/feedback-section.png similarity index 100% rename from static/attachments/refguide/modeling/mendix-ai-assistance/maia-chat/feedback-section.png rename to static/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-chat/feedback-section.png diff --git a/static/attachments/refguide/modeling/mendix-ai-assistance/maia-chat/maia-chat-interface.png b/static/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-chat/maia-chat-interface.png similarity index 100% rename from static/attachments/refguide/modeling/mendix-ai-assistance/maia-chat/maia-chat-interface.png rename to static/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-chat/maia-chat-interface.png diff --git a/static/attachments/refguide/modeling/mendix-ai-assistance/maia-explain/maia-explain-interface.png b/static/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-explain/maia-explain-interface.png similarity index 100% rename from static/attachments/refguide/modeling/mendix-ai-assistance/maia-explain/maia-explain-interface.png rename to static/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-explain/maia-explain-interface.png diff --git a/static/attachments/refguide/modeling/mendix-ai-assistance/maia-for-domain-model/chat-interface.png b/static/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-domain-model/chat-interface.png similarity index 100% rename from static/attachments/refguide/modeling/mendix-ai-assistance/maia-for-domain-model/chat-interface.png rename to static/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-domain-model/chat-interface.png diff --git a/static/attachments/refguide/modeling/mendix-ai-assistance/maia-for-domain-model/maia-for-domain-model.png b/static/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-domain-model/maia-for-domain-model.png similarity index 100% rename from static/attachments/refguide/modeling/mendix-ai-assistance/maia-for-domain-model/maia-for-domain-model.png rename to static/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-domain-model/maia-for-domain-model.png diff --git a/static/attachments/refguide/modeling/mendix-ai-assistance/maia-for-pages/chat-interface.png b/static/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-pages/chat-interface.png similarity index 100% rename from static/attachments/refguide/modeling/mendix-ai-assistance/maia-for-pages/chat-interface.png rename to static/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-pages/chat-interface.png diff --git a/static/attachments/refguide/modeling/mendix-ai-assistance/maia-for-pages/maia-for-pages.png b/static/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-pages/maia-for-pages.png similarity index 100% rename from static/attachments/refguide/modeling/mendix-ai-assistance/maia-for-pages/maia-for-pages.png rename to static/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-pages/maia-for-pages.png diff --git a/static/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-make-interface.png b/static/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-make-interface.png new file mode 100644 index 00000000000..9812c2e8a22 Binary files /dev/null and b/static/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-make-interface.png differ