docs: fix configuration paths and misleading examples

- Fix Claude Desktop config paths for all platforms (macOS, Linux, Windows)
  * macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  * Linux: ~/.config/Claude/claude_desktop_config.json
  * Windows: %APPDATA%\Claude\claude_desktop_config.json
- Update server name from 'go-zero-mcp' to 'mcp-zero' for consistency
- Add GOCTL_PATH to all platform configurations
- Clarify 'Adding an Endpoint' workflow (manual edit + regenerate, not automatic)
- Remove misleading suggestion that endpoints can be added automatically

Author: kevwan

QUICKSTART.md

@@ -118,13 +118,16 @@ curl http://localhost:8080/ping
 
 ### Adding an Endpoint
 
-Ask Claude:
+To add new endpoints, you'll need to:
+
+1. Edit the `.api` file manually to add your endpoint
+2. Regenerate code from the updated spec:
 
 ```
-Add a new endpoint GET /api/user/:id to my userservice
+Generate code from the userservice.api file in ./userservice
 ```
 
-mcp-zero will update the API specification and regenerate code.
+Claude will use the `generate_api_from_spec` tool to regenerate the service with your new endpoints.
 
 ### Creating an RPC Service
 

readme.md

@@ -65,34 +65,48 @@ go build -o go-zero-mcp main.go
 
 Add this configuration to your Claude Desktop MCP settings:
 
-### macOS/Linux
-Edit `~/.config/claude/mcp_settings.json`:
+### macOS
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
 
 ```json
 {
   "mcpServers": {
-    "go-zero-mcp": {
-      "command": "/path/to/your/go-zero-mcp",
-      "args": [],
+    "mcp-zero": {
+      "command": "/path/to/your/mcp-zero",
       "env": {
-        "PATH": "/usr/local/bin:/usr/bin:/bin"
+        "GOCTL_PATH": "/Users/yourname/go/bin/goctl"
+      }
+    }
+  }
+}
+```
+
+### Linux
+Edit `~/.config/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "mcp-zero": {
+      "command": "/path/to/your/mcp-zero",
+      "env": {
+        "GOCTL_PATH": "/usr/local/bin/goctl"
       }
     }
   }
 }
 ```
 
 ### Windows
-Edit `%APPDATA%/Claude/mcp_settings.json`:
+Edit `%APPDATA%\Claude\claude_desktop_config.json`:
 
 ```json
 {
   "mcpServers": {
-    "go-zero-mcp": {
-      "command": "C:\\path\\to\\your\\go-zero-mcp.exe",
-      "args": [],
+    "mcp-zero": {
+      "command": "C:\\path\\to\\your\\mcp-zero.exe",
       "env": {
-        "PATH": "C:\\Go\\bin;C:\\Program Files\\Go\\bin"
+        "GOCTL_PATH": "C:\\Go\\bin\\goctl.exe"
       }
     }
   }

specs/quickstart.md

@@ -118,13 +118,16 @@ curl http://localhost:8080/ping
 
 ### Adding an Endpoint
 
-Ask Claude:
+To add new endpoints, you'll need to:
+
+1. Edit the `.api` file manually to add your endpoint
+2. Regenerate code from the updated spec:
 
 ```
-Add a new endpoint GET /api/user/:id to my userservice
+Generate code from the userservice.api file in ./userservice
 ```
 
-mcp-zero will update the API specification and regenerate code.
+Claude will use the `generate_api_from_spec` tool to regenerate the service with your new endpoints.
 
 ### Creating an RPC Service