豆豆友情提示:这是一个非官方 GitHub 代理镜像,主要用于网络测试或访问加速。请勿在此进行登录、注册或处理任何敏感信息。进行这些操作请务必访问官方网站 github.com。 Raw 内容也通过此代理提供。
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

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

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)