Help
Troubleshooting
Fixes for the most common problems.
iPhone
ScreenTap doesn't find my iPhone+
Unlock the iPhone and tap Trust if it asks. Try another cable: some only charge and don't carry data. Plug straight into the Mac rather than through a hub.
The screen is black or frozen+
Unlock the iPhone. The screen only streams while it's unlocked, and pauses when the iPhone locks.
Bluetooth won't connect+
On the iPhone, open Settings › Bluetooth and tap your Mac under My Devices. If it was paired as headphones, tap ⓘ › Forget This Device and pair again, choosing Other Device.
Taps land in the wrong place+
Run the pointer setup again: ScreenTap › Settings › Phone › Run setup again. Leave the iPhone on the Home Screen while it measures.
Agents
My agent doesn't see the ScreenTap tools+
Make sure the ScreenTap app is open, then restart your agent or start a new session. For HTTP setups, check the address is exactly
http://127.0.0.1:47811/mcp. Each agent's guide in Connect your agent shows how to check it's connected.Claude Desktop or Codex can't start ScreenTap+
They start the app with --stdio, so the path in the config must point at the app. If ScreenTap isn't in Applications, change the path to where it is.
License
It stopped working after the trial+
Buy a license and activate it in ScreenTap › Settings › License. Agents get a message explaining this, so they'll tell you too.
“This key is already active on 3 Macs”+
Deactivate it on a Mac you no longer use (Settings › License › Deactivate this Mac), then activate again.
Still stuck? Email hello@screentap.ai.