diff --git a/PLAYWRITER_AGENTS.md b/PLAYWRITER_AGENTS.md
index dcebae1..a8bd78d 100644
--- a/PLAYWRITER_AGENTS.md
+++ b/PLAYWRITER_AGENTS.md
@@ -62,3 +62,9 @@ IMPORTANT: `pnpm test` will take about 30 seconds so set a timeout of at least 3
 when you do an important change, update relevant CHANGELOG.md files for each package.
 
 also bump package.json versions and IMPORTANT also the extension/manifest.json version too
+
+## debugging playwriter mcp issues
+
+sometimes the user will ask you to debug an mcp issue. to do this you may want to add logs to the mcp and server. to do this you will also need to restart the server so we use the latest code. restarting the mcp yourself is not possible. instead you will need to ask the user to do it or write a test case, where the mcp can be reloaded. also making changes in the extension will not work. you will have to write a test case for that to work. you can ask the user to reconnect these too. for reloading the extension you can run the `pnpm build` script and do `osascript -e 'tell application "Google Chrome" to open location "chrome://extensions/?id=elnnakgjclnapgflmidlpobefkdmapdm"'` to make it easier for the user to reload it
+
+if the problem was in the ws server you can restart that yourself killing process listening on 19988 and sending a new mcp call.