Environment

Spring AI: 1.0.1

Spring Boot: 3.5.0

Java: 21

Transport: STDIO

Steps to reproduce

Configure server with both names:

yaml spring: application: name: my-spring-app ai: mcp: server: name: my-mcp-server transport: stdio Start server and client applications

Client fails to connect with timeout or protocol errors

Server tools are not discoverable by client

Expected behavior

Client should successfully connect to server using configured name

Server tools should be discoverable and callable from client

Clear documentation on proper name configuration

Minimal example

Server config (problematic):

yaml

application.yml

spring: application: name: app-server ai: mcp: server: name: mcp-server # Conflict causes client connection failure

Client config:

yaml spring: ai: mcp: client: servers: mcp-server: # Cannot resolve due to server name conflict command: "java" args: ["-jar", "server.jar"] Observed behavior:

Client timeout during connection attempt

Mono.deferContextual timeout errors

Server tools not registered in client tool registry

No protocol handshake completion

Workaround: Use only one name configuration in server:

yaml

Option A: Use only MCP server name

spring: ai: mcp: server: name: mcp-server # Client uses this name

Option B: Use only Spring app name

spring: application: name: mcp-server # Client uses this name