Skip to content

Commit a87302b

Browse files
committed
docs: add macOS Bluetooth permission troubleshooting note
1 parent caea23a commit a87302b

1 file changed

Lines changed: 10 additions & 0 deletions

File tree

docs/troubleshooting.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,16 @@ This indicates that the browser could not be started. Make sure that no Chrome
5555
instances are running or close them. Make sure you have the latest stable Chrome
5656
installed and that [your system is able to run Chrome](https://support.google.com/chrome/a/answer/7100626?hl=en).
5757

58+
### Chrome crashes on macOS when opening Web Bluetooth
59+
60+
On macOS, Chrome launched by an MCP host app may crash with a macOS privacy
61+
permission violation (TCC, "Transparency, Consent, and Control") when a native
62+
Bluetooth chooser opens.
63+
64+
Grant Bluetooth permission to the MCP host app in
65+
`System Settings > Privacy & Security > Bluetooth`, then restart the MCP host
66+
app and Chrome MCP session.
67+
5868
### Remote debugging between virtual machine (VM) and host fails
5969

6070
When 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:

0 commit comments

Comments
 (0)