Skip to content

Update MCP Server authentication (not mandatory anymore) #11756

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
liamsommer-mx wants to merge 4 commits into
base: development
Choose a base branch
from
Open

Update MCP Server authentication (not mandatory anymore) #11756

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
560d24e
Update MCP Server authentication guidance
linaaaf Aug 10, 2026
3147d0f
Enhance agent creation guide with learning path link
linaaaf Aug 19, 2026
3c74cfa
Add review
Karuna-Mendix Aug 20, 2026
55186a1
Enhance documentation on TextContent error signaling
liamsommer-mx Aug 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion content/en/docs/genai/v2/how-to/creating-agents/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ aliases:

## Introduction

This guide explains how to create an agent in your Mendix app that combines [knowledge base retrieval (RAG)](/agents/rag/) and [function calling](/agents/function-calling/) capabilities from Mendix Agents Kit.
This guide explains how to create an agent in your Mendix app that combines [knowledge base retrieval (RAG)](/agents/rag/) and [function calling](/agents/function-calling/) capabilities from Mendix Agents Kit. For a hands-on experience and a detailed explanation, see the [Create Your First Agent](https://academy.mendix.com/link/paths/175/Create-Your-First-Agent) learning path.

## Agent Use Case

Expand Down
4 changes: 3 additions & 1 deletion content/en/docs/genai/v2/reference-guide/mcp-modules/mcp-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@

The MCP Server can be publicly accessed unless you specify [path-based restrictions](/developerportal/deploy/environments-details/#path-based-restrictions) on the endpoint when running on Mendix Cloud or on your own infrastructure.

If no authentication is enabled for the MCP Server, it can be accessed by any service without being authorized specifically. Be aware that this is not recommended for applications running on the public cloud. Currently, selecting a microflow is required. For test purposes, however, you can just delete the content of the attribute after setting up the MCP Server if you do not want to enable authentication. There is a corresponding example in the [GenAI Showcase app](https://marketplace.mendix.com/link/component/220475), where the `ACT_MCPServerConfiguration_InitializeMCPServer` microflow shows how this can be done.
If no authentication is enabled for the MCP Server, it can be accessed by any service without being authorized specifically. Be aware that this is not recommended for applications running on the public cloud.

For most cases, you want to ensure that MCP clients must be authorized before using any resources from the MCP Server or even discover what resources are available. To enable authentication, you can specify a microflow in the `Create MCP Server` action. The microflow is executed each time a request is processed by the MCP Server.

Expand All @@ -78,6 +78,8 @@
* Input needs to be the same as described in the `Schema` attribute (only primitives and/or an object of type `MCPServer.Tool` are supported). If no Schema is passed in the `Add tool` action, it will be automatically created based on the microflow's input parameters, by setting all of them as required.
* The return value must be either of type `String` or `TextContent`. You can create a `TextContent` object within the microflow to return the relevant information to the model based on the outcome of the microflow.

If the tool microflow returns a `TextContent` object, you can set `IsError = True` to signal a handled error to the client — use `Content` to describe what went wrong, e.g. in a structured way, or to let the LLM know it can retry. Note: this requires the microflow to return TextContent directly; a microflow with a plain String return type has no way to set `IsError`, and will always return IsError = False. If the microflow throws an uncaught exception instead, IsError is set to True automatically, the full exception is logged server-side, and the client receives a generic error message (no internal details).

Check failure on line 81 in content/en/docs/genai/v2/reference-guide/mcp-modules/mcp-server.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Mendix.Latin] Use 'for example, ' instead of 'e.g. '.

Raw Output:
{"message": "[Mendix.Latin] Use 'for example, ' instead of 'e.g. '.", "location": {"path": "content/en/docs/genai/v2/reference-guide/mcp-modules/mcp-server.md", "range": {"start": {"line": 81, "column": 169}}}, "severity": "ERROR"}

Check failure on line 81 in content/en/docs/genai/v2/reference-guide/mcp-modules/mcp-server.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Mendix.Dashes] Remove spaces around the em dash (—). Or, to set off a list item intro or number range, use an en dash (–) instead.

Raw Output:
{"message": "[Mendix.Dashes] Remove spaces around the em dash (—). Or, to set off a list item intro or number range, use an en dash (–) instead.", "location": {"path": "content/en/docs/genai/v2/reference-guide/mcp-modules/mcp-server.md", "range": {"start": {"line": 81, "column": 123}}}, "severity": "ERROR"}

For example, see the `Example Implementations` folder inside the module.

{{% alert color="warning" %}}
Expand Down