Update Cursor setup guidance

Author: cameroncooke

.axe-version

@@ -1 +1 @@
-1.3.0
+1.4.0

README.md

@@ -29,7 +29,7 @@ Add XcodeBuildMCP to your MCP client configuration. Most clients use JSON config
   <summary>Cursor</summary>
   <br />
 
-  Add to `~/.cursor/mcp.json`:
+  Recommended (project-scoped): add `.cursor/mcp.json` in your workspace root:
   ```json
   {
     "mcpServers": {
@@ -41,9 +41,24 @@ Add XcodeBuildMCP to your MCP client configuration. Most clients use JSON config
   }
   ```
 
+  For global Cursor config (`~/.cursor/mcp.json`), use this variant so startup is aligned with the active workspace:
+  ```json
+  {
+    "mcpServers": {
+      "XcodeBuildMCP": {
+        "command": "/bin/zsh",
+        "args": [
+          "-lc",
+          "cd \"${workspaceFolder}\" && exec npx -y xcodebuildmcp@beta mcp"
+        ]
+      }
+    }
+  }
+  ```
+
   Or use the quick install link:
 
-[![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/en-US/install-mcp?name=XcodeBuildMCP&config=eyJjb21tYW5kIjoibnB4IC15IHhjb2RlYnVpbGRtY3BAYmV0YSBtY3AifQ%3D%3D)
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/en-US/install-mcp?name=XcodeBuildMCP&config=eyJjb21tYW5kIjoiL2Jpbi96c2giLCJhcmdzIjpbIi1sYyIsImNkIFwiJHt3b3Jrc3BhY2VGb2xkZXJ9XCIgJiYgZXhlYyBucHggLXkgeGNvZGVidWlsZG1jcEBiZXRhIG1jcCJdfQ%3D%3D)
   <br />
 </details>
 

docs/GETTING_STARTED.md

@@ -63,6 +63,36 @@ See [CONFIGURATION.md](CONFIGURATION.md) for the full schema and examples.
 
 ## Client-specific configuration
 
+### Cursor
+Recommended (project-scoped): create `.cursor/mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "XcodeBuildMCP": {
+      "command": "npx",
+      "args": ["-y", "xcodebuildmcp@beta", "mcp"]
+    }
+  }
+}
+```
+
+If you use a global Cursor config at `~/.cursor/mcp.json`, use this variant to align startup with the active workspace:
+
+```json
+{
+  "mcpServers": {
+    "XcodeBuildMCP": {
+      "command": "/bin/zsh",
+      "args": [
+        "-lc",
+        "cd \"${workspaceFolder}\" && exec npx -y xcodebuildmcp@beta mcp"
+      ]
+    }
+  }
+}
+```
+
 ### OpenAI Codex CLI
 Codex uses TOML for MCP configuration. Add this to `~/.codex/config.toml`: