Chrome DevTools for coding agents
docs: add macOS Web Bluetooth troubleshooting note (#930)
Daniel Kastl3c9528b43d9b
diff --git a/docs/troubleshooting.md b/docs/troubleshooting.mdindex 6a7e36bc..1be6efbd 100644--- a/docs/troubleshooting.md+++ b/docs/troubleshooting.md@@ -55,6 +55,16 @@ This indicates that the browser could not be started. Make sure that no Chromeinstances are running or close them. Make sure you have the latest stable Chromeinstalled and that [your system is able to run Chrome](https://support.google.com/chrome/a/answer/7100626?hl=en).+### Chrome crashes on macOS when opening Web Bluetooth++On macOS, Chrome launched by an MCP host app may crash with a macOS privacy+permission violation (TCC, "Transparency, Consent, and Control") when a native+Bluetooth chooser opens.++Grant Bluetooth permission to the MCP host app in+`System Settings > Privacy & Security > Bluetooth`, then restart the MCP host+app and Chrome MCP session.+### Remote debugging between virtual machine (VM) and host failsWhen connecting DevTools inside a VM to Chrome running on the host, any domain is rejected by Chrome because of host header validation. Tunneling the port over SSH bypasses this restriction. In the VM, run: