Support
Questions, a bug, an idea: write to founder@rubanov.cloud. Please mention your macOS and Safari versions, the agent you use, and what you saw. We read every message.
Set up TabPilot
- Install TabPilot from the Mac App Store (it needs macOS 14 Sonoma or later) and open it. The app runs the local server, so keep it open while your agent works.
- The first time, TabPilot explains what is shared with the agent you connect. Choose I Understand.
- In Safari, choose Safari › Settings › Extensions and turn on TabPilot.
- Allow TabPilot on the websites you want your agent to use: click the TabPilot button in Safari’s toolbar on that site, or choose Always Allow on Every Website in the extension’s settings. TabPilot’s own Site Access still asks you per site.
- In the app, under Connect an agent, pick your client and click Copy. For Claude Code, paste the command into Terminal:
claude mcp add --transport http tabpilot http://127.0.0.1:47823/mcp --header "Authorization: Bearer <token>"(the app fills in the token). - Run
claude mcp get tabpilot. It should say ✔ Connected. Start a new Claude Code session so it loads the tools.
Want to try it somewhere safe first? Use the TabPilot Demo Store: nothing on it is real.
Troubleshooting
The agent says the Safari extension is not connected
Open the TabPilot app; it has to be running. Then check Safari › Settings › Extensions and make sure TabPilot is turned on. The app’s Status section shows whether the extension is connected.
“Safari has not given TabPilot access to this website”
Safari asks you to allow every extension on each website. Click the TabPilot button in Safari’s toolbar and allow the website, or turn on Always Allow on Every Website in Safari › Settings › Extensions › TabPilot. TabPilot’s own Site Access still asks you about each site before the agent sees it. Tabs the agent opens itself work without this.
A tab that was open before an update doesn’t respond
Tabs opened before TabPilot was installed or updated don’t have the new extension in them yet. Reload the tab (anything you typed into a form and didn’t send is lost). Your agent can also reload it for you.
I made a new token and now the agent can’t connect
That’s expected: New Token… makes every old setup stop working. Copy the new setup from the app and add the agent again. For Claude Code, remove the old entry first with claude mcp remove tabpilot (add -s user if you added it for all projects), then paste the new command. For Claude Desktop, replace the token in claude_desktop_config.json and restart Claude.
How do I stop the agent right now?
Click Stop in the “TabPilot is controlling this tab” pill, turn on Stop agent in the TabPilot toolbar popover or the app, or press Option-Shift-P in Safari. The agent can’t read or act in Safari until you resume.
The agent says TabPilot isn’t set up yet
Open the TabPilot app and choose I Understand on the data notice. The agent’s tools work after that.
A prompt in Safari went away before I answered
Prompts wait for a limited time. If nobody answers, the action doesn’t happen and the agent is told it wasn’t allowed. Ask the agent to try again when you’re at the keyboard.
Where is the activity log?
In the TabPilot toolbar popover in Safari (Activity) and in the app’s Activity section. It lists every read, click and prompt with the site and the time.
More
Connect Claude Code to Safari · Claude Desktop and other clients · Privacy policy