diff --git a/.vscode/mcp.json b/.vscode/mcp.json
index cef32e8f3d1..f798c6131b2 100644
--- a/.vscode/mcp.json
+++ b/.vscode/mcp.json
@@ -3,6 +3,7 @@
 		"vscode-playwright-mcp": {
 			"type": "stdio",
 			"command": "npm",
+			// Look at the [README](../test/mcp/README.md) to see what arguments are supported
 			"args": ["run", "start-stdio"],
 			"cwd": "${workspaceFolder}/test/mcp"
 		}
diff --git a/test/mcp/README.md b/test/mcp/README.md
index f6dac03cb9b..aef4bc58435 100644
--- a/test/mcp/README.md
+++ b/test/mcp/README.md
@@ -59,6 +59,24 @@ Open the [mcp.json](../../.vscode/mcp.json) and modify the `args`:
 
 > *NOTE: `--web` requires running `npm run install-playwright` from root*
 
+## Debugging the server
+
+You can modify the mcp.json to debug the server:
+```JSON
+"vscode-playwright-mcp": {
+	"type": "stdio",
+	"command": "node",
+	"args": ["./out/stdio.js"],
+	"cwd": "${workspaceFolder}/test/mcp",
+	"dev": {
+		"watch": "test/mcp/**/*.ts",
+		"debug": {
+			"type": "node"
+		}
+	}
+}
+```
+
 ## What the Server Provides
 
 The MCP server exposes a comprehensive set of browser automation tools through the MCP protocol: