ref docs improvmentes

Signed-off-by: Christian Tzolov <[email protected]>

Author: tzolov

spring-ai-docs/src/main/antora/modules/ROOT/pages/api/mcp/mcp-stateless-server-boot-starter-docs.adoc

@@ -4,9 +4,9 @@
 Stateless MCP servers are designed for simplified deployments where session state is not maintained between requests. 
 These servers are ideal for microservices architectures and cloud-native deployments.
 
-NOTE: They require xref:api/mcp/mcp-client-boot-starter-docs#_streamable_http_transport_properties[streamable-HTTP clients] to support the necessary protocols for handling these features.
+TIP: Use the xref:api/mcp/mcp-client-boot-starter-docs#_streamable_http_transport_properties[Streamable-HTTP clients] to connect to the stateless servers.
 
-NOTE: Stateless servers don't support message requests to the MCP client (e.g., elicitation, sampling, ping).
+NOTE: The stateless servers don't support message requests to the MCP client (e.g., elicitation, sampling, ping).
 
 === Stateless WebMVC Server
 

spring-ai-docs/src/main/antora/modules/ROOT/pages/api/mcp/mcp-stdio-sse-server-boot-starter-docs.adoc

@@ -3,6 +3,8 @@
 
 The STDIO and SSE MCP Servers support multiple transport mechanisms, each with its dedicated starter.
 
+TIP: Use the xref:api/mcp/mcp-client-boot-starter-docs#_stdio_transport_properties[STDIO clients]  or xref:api/mcp/mcp-client-boot-starter-docs#_sse_transport_properties[SSE clients] to connect to the STDIO and SSE servers.
+
 === STDIO MCP Server
 
 Full MCP Server feature support with `STDIO` server transport.
@@ -103,6 +105,8 @@ All SSE properties are prefixed with `spring.ai.mcp.server`:
 |`keep-alive-interval` |Connection keep-alive interval |`null` (disabled)
 |===
 
+NOTE: For backward compatibility reasons, the SSE properties do not have additional suffix (like `.sse`).
+
 == Features and Capabilities
 
 The MCP Server Boot Starter allows servers to expose tools, resources, and prompts to clients.
@@ -356,12 +360,14 @@ spring:
         version: 1.0.0
         type: SYNC
         instructions: "This server provides weather information tools and resources"
-        sse-message-endpoint: /mcp/messages
         capabilities:
           tool: true
           resource: true
           prompt: true
           completion: true
+        # sse properties
+        sse-message-endpoint: /mcp/messages
+        keep-alive-interval: 30s
 ----
 
 === WebFlux Server Configuration
@@ -376,12 +382,14 @@ spring:
         version: 1.0.0
         type: ASYNC  # Recommended for reactive applications
         instructions: "This reactive server provides weather information tools and resources"
-        sse-message-endpoint: /mcp/messages
         capabilities:
           tool: true
           resource: true
           prompt: true
           completion: true
+        # sse properties
+        sse-message-endpoint: /mcp/messages
+        keep-alive-interval: 30s
 ----
 
 === Creating a Spring Boot Application with MCP Server

spring-ai-docs/src/main/antora/modules/ROOT/pages/api/mcp/mcp-streamable-http-server-boot-starter-docs.adoc

@@ -4,7 +4,7 @@
 link:https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http[Streamable-HTTP] MCP servers provide enhanced functionality with support for change notifications and persistent connections. 
 These servers, introduced with spec version link:https://modelcontextprotocol.io/specification/2025-03-26[2025-03-26], are ideal for applications that need to notify clients about dynamic changes to tools, resources, or prompts.
 
-NOTE: They require xref:api/mcp/mcp-client-boot-starter-docs#_streamable_http_transport_properties[streamable-HTTP clients] to support the necessary protocols for handling these features.
+TIP: Use the xref:api/mcp/mcp-client-boot-starter-docs#_streamable_http_transport_properties[Streamable-HTTP clients] to connect to the Streamable-HTTP servers.
 
 === Streamable-HTTP WebMVC Server