Merge branch 'main' into wils/auth-cleanup

Author: localden

CONTRIBUTING.md

@@ -70,6 +70,24 @@ When contributing to the documentation:
 - Follow existing file naming conventions (kebab-case.mdx)
 - Include proper frontmatter in MDX files
 
+### Specification Proposal Guidelines
+
+#### Principles of MCP
+
+1. **Simple + Minimal**: It is much easier to add things to a specification than it is to
+   remove them. To maintain simplicity, we keep a high bar for adding new concepts and
+   primitives as each addition requires maintenance and compatibility consideration.
+2. **Concrete**: Specification changes need to be based on specific implementation
+   challenges and not on speculative ideas.
+
+### Stages of a specification proposal
+
+1. **Define**: Explore the problem space, validate that other MCP users face a similar
+   issue, and then clearly define the problem.
+2. **Prototype**: Build an example solution to the problem and demonstrate its practical
+   application.
+3. **Write**: Based on the prototype, write a specification proposal.
+
 ## Submitting Changes
 
 1. Push your changes to your fork

docs/quickstart/client.mdx

@@ -919,17 +919,22 @@ The chatbot is implemented using Spring AI's ChatClient with MCP tool integratio
 ```java
 var chatClient = chatClientBuilder
     .defaultSystem("You are useful assistant, expert in AI and Java.")
-    .defaultTools((Object[]) mcpToolAdapter.toolCallbacks())
+    .defaultToolCallbacks((Object[]) mcpToolAdapter.toolCallbacks())
     .defaultAdvisors(new MessageChatMemoryAdvisor(new InMemoryChatMemory()))
     .build();
 ```
 
+<Warning>
+Breaking change: From SpringAI 1.0.0-M8 onwards, use `.defaultToolCallbacks(...)` instead of `.defaultTool(...)` to register MCP tools.
+</Warning>
+
 Key features:
 - Uses Claude AI model for natural language understanding
 - Integrates Brave Search through MCP for real-time web search capabilities
 - Maintains conversation memory using InMemoryChatMemory
 - Runs as an interactive command-line application
 
+
 ### Build and run
 
 ```bash