This is an automated email from the ASF dual-hosted git repository.
davsclaus pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git
The following commit(s) were added to refs/heads/main by this push:
new 3463e669c257 CAMEL-26360: Document Spring Boot MCP origin validation
(#29930)
3463e669c257 is described below
commit 3463e669c257196c2b54dbc4f88c7569ada6760f
Author: Ramu <[email protected]>
AuthorDate: Tue Nov 17 03:27:08 2026 +0530
CAMEL-26360: Document Spring Boot MCP origin validation (#29930)
---
.../ROOT/pages/camel-4x-upgrade-guide-4_24.adoc | 23 ++++++++++++++++++++--
1 file changed, 21 insertions(+), 2 deletions(-)
diff --git
a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_24.adoc
b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_24.adoc
index bceec2f62a6e..47dced636a7d 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_24.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_24.adoc
@@ -352,8 +352,27 @@ By default only loopback origins are allowed (`localhost`,
`127.0.0.1` and `[::1
client served from another origin must now be listed in the new
`camel.server.mcp-allowed-origins` option, for example
`+camel.server.mcp-allowed-origins = https://app.example.com,
http://localhost:*+`. The list replaces the loopback
default. Scheme and host are compared ignoring case and a default port may be
left out; `+*+` and other entries that are
-not of the form `scheme://host[:port]` fail the startup. Stdio mode is not
affected, and neither are the Spring Boot and
-Quarkus engines.
+not of the form `scheme://host[:port]` fail the startup. Stdio mode is not
affected.
+
+Spring Boot applications using `camel-mcp-server-starter` validate the
`Origin` header when
+`spring.ai.mcp.server.protocol=STREAMABLE`, `camel.mcp-server.enabled` is not
`false`, and Camel's Streamable HTTP
+transport is selected. `camel.mcp-server.enabled` defaults to `true`. By
default, Camel's transport is selected when
+`camel.mcp-server.tags` is set. Set `camel.mcp-server.transport-enabled=true`
to select Camel's transport without
+tags, or set it to `false` to keep Spring AI's transport even when tags are
set. When Spring AI's transport is kept,
+Camel's `Origin` validation is not installed. The check covers every request
(`POST`, the SSE `GET`, and `DELETE`).
+Requests without an `Origin` header are accepted. Requests with an `Origin`
header are accepted only when the origin
+matches the allowed list; other origins receive HTTP 403. By default, only
loopback origins are allowed. Configure
+`camel.mcp-server.allowed-origins` to allow browser clients from other
origins, for example:
+
+[source,properties]
+----
+camel.mcp-server.allowed-origins = https://app.example.com, http://localhost:*
+----
+
+The configured list replaces the loopback default. The allowed-origin entries
follow the same rules as on Camel Main:
+the wildcard entry `+*+` and entries not of the form `scheme://host[:port]`
fail startup. An application-provided
+Spring AI transport provider must configure its own `Origin` validator. This
Spring Boot transport change does not
+affect the Quarkus engine.
=== camel-oauth - the scp claim is included in scope checks