Update naming and docs for client credentials example

Author: LucaButBoring

examples/clients/simple-auth-client-client-credentials/README.md

@@ -1,28 +1,29 @@
 # Simple Auth Client Example
 
-A demonstration of how to use the MCP Python SDK with OAuth authentication over streamable HTTP or SSE transport.
+A demonstration of how to use the MCP Python SDK with OAuth authentication using client credentials over streamable HTTP or SSE transport.
+This example demonstrates integration with an authorization server that does not implement Dynamic Client Registration.
 
 ## Features
 
-- OAuth 2.0 authentication with PKCE
+- OAuth 2.0 authentication with the `client_credentials` flow
 - Support for both StreamableHTTP and SSE transports
 - Interactive command-line interface
 
 ## Installation
 
 ```bash
-cd examples/clients/simple-auth-client
-uv sync --reinstall 
+cd examples/clients/simple-auth-client-client-credentials
+uv sync --reinstall
 ```
 
 ## Usage
 
-### 1. Start an MCP server with OAuth support
+### 1. Start an MCP server with OAuth support using client credentials
 
 ```bash
-# Example with mcp-simple-auth
-cd path/to/mcp-simple-auth
-uv run mcp-simple-auth --transport streamable-http --port 3001
+# Example with mcp-simple-auth-client-credentials
+cd path/to/mcp-simple-auth-client-credentials
+uv run mcp-simple-auth-client-credentials --transport streamable-http --port 3001
 ```
 
 ### 2. Run the client
@@ -39,22 +40,32 @@ MCP_TRANSPORT_TYPE=sse uv run mcp-simple-auth-client
 
 ### 3. Complete OAuth flow
 
-The client will open your browser for authentication. After completing OAuth, you can use commands:
+The client will automatically authenticate using dummy client credentials for the demo authorization server. After completing OAuth, you can use commands:
 
 - `list` - List available tools
-- `call <tool_name> [args]` - Call a tool with optional JSON arguments  
+- `call <tool_name> [args]` - Call a tool with optional JSON arguments
 - `quit` - Exit
 
 ## Example
 
 ```
-🔐 Simple MCP Auth Client
-Connecting to: http://localhost:3001
-
-Please visit the following URL to authorize the application:
-http://localhost:3001/authorize?response_type=code&client_id=...
-
-✅ Connected to MCP server at http://localhost:3001
+🚀 Simple MCP Auth Client
+Connecting to: http://localhost:8001/mcp
+Transport type: streamable_http
+🔗 Attempting to connect to http://localhost:8001/mcp...
+📡 Opening StreamableHTTP transport connection with auth...
+🤝 Initializing MCP session...
+⚡ Starting session initialization...
+✨ Session initialization complete!
+
+✅ Connected to MCP server at http://localhost:8001/mcp
+Session ID: ...
+
+🎯 Interactive MCP Client
+Commands:
+  list - List available tools
+  call <tool_name> [args] - Call a tool
+  quit - Exit the client
 
 mcp> list
 📋 Available tools:

examples/servers/simple-auth-client-credentials/README.md

@@ -102,12 +102,3 @@ curl -v http://localhost:8001/.well-known/oauth-protected-resource
 # Test Authorization Server metadata
 curl -v http://localhost:9000/.well-known/oauth-authorization-server
 ```
-
-### Test Token Introspection
-
-```bash
-# After getting a token through OAuth flow:
-curl -X POST http://localhost:9000/introspect \
-  -H "Content-Type: application/x-www-form-urlencoded" \
-  -d "token=your_access_token"
-```

examples/servers/simple-auth-client-credentials/mcp_simple_auth_client_credentials/server.py

@@ -17,7 +17,7 @@
 from mcp.server.auth.settings import AuthSettings
 from mcp.server.fastmcp.server import FastMCP
 
-from .token_verifier import IntrospectionTokenVerifier
+from .token_verifier import PartialIntrospectionTokenVerifier
 
 logger = logging.getLogger(__name__)
 
@@ -52,8 +52,8 @@ def create_resource_server(settings: ResourceServerSettings) -> FastMCP:
     Create MCP Resource Server.
     """
 
-    # Create token verifier for introspection with RFC 8707 resource validation
-    token_verifier = IntrospectionTokenVerifier(
+    # Create partial token verifier
+    token_verifier = PartialIntrospectionTokenVerifier(
         introspection_endpoint=settings.auth_server_introspection_endpoint,
         server_url=str(settings.server_url),
     )

examples/servers/simple-auth-client-credentials/mcp_simple_auth_client_credentials/token_verifier.py

@@ -1,4 +1,4 @@
-"""Example token verifier implementation using OAuth 2.0 Token Introspection (RFC 7662)."""
+"""Example token verifier implementation."""
 
 import logging
 from datetime import datetime
@@ -9,8 +9,13 @@
 logger = logging.getLogger(__name__)
 
 
-class IntrospectionTokenVerifier(TokenVerifier):
-    """Example token verifier that uses OAuth 2.0 Token Introspection (RFC 7662)."""
+class PartialIntrospectionTokenVerifier(TokenVerifier):
+    """
+    Example token verifier.
+
+    Discord doesn't actually support token introspection, but this is required by FastMCP, so
+    we shim a non-strict verifier on top of it that leverages the "current application" endpoint.
+    """
 
     def __init__(
         self,