Skip to content

Commit 3c9528b

Browse files
authored
docs: add macOS Web Bluetooth troubleshooting note (#930)
Docs-only change: add a troubleshooting note for macOS Web Bluetooth chooser crashes in MCP-launched Chrome and the Bluetooth permission workaround. Fixes #917
1 parent 8e2380b commit 3c9528b

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)