Docs

Getting started

About five minutes. At the end an agent can open a tab in your own signed-in Chrome and tell you what is on it.

What do you want to do?

  • Let an AI assistant use your browser — Claude, ChatGPT, Cursor and similar. Follow the four steps below.
  • Drive it from your own code. Do steps 1 and 2 below, then read Write your own client.
  • Run Playwright tests in a real, signed-in Chrome. This needs a business account with CDP on your plan. Do steps 1 and 2, then read Run Playwright tests.

1. Create an account

Sign up with an email address, Google or GitHub. Personal accounts are free. Setting this up for a team? Create a business account instead, so you can share browsers and set rules for everyone.

2. Install the extension

Add the TabTunnel extension to the Chrome you want your agent to use. It opens a setup page that asks you three things:

  • When an agent should ask you first. Allow local sites, ask about the rest is selected for you and suits most people. Pick Ask about every site if you want to approve each one. You can change this later from the extension.
  • A name for this browser. Your agent sees this name when it lists your browsers.
  • Sign in. A TabTunnel tab opens; approve it and you are done.

While an agent is working, Chrome shows a bar saying “started debugging this browser”. That is expected, and Chrome does not let anyone hide it.

3. Connect your app

Every app uses the same address:

MCP server URL
https://tabtunnel.dev/v1/mcp

What you do next depends on the app.

Apps that sign you in: Claude.ai, Claude Desktop, ChatGPT

Add a custom connector, paste the address above, and approve it when a TabTunnel page opens. There is no token to create. Step by step.

Apps that take a token: Claude Code, Cursor, Windsurf, Cline

Open Tokens in the dashboard and create one, named for the app that will use it. Copy it straight away — you will only see it once. Treat it like a password: anyone who has it can use your browsers.

Then add it to your app: one command for Claude Code, or a block of JSON for Cursor, Windsurf and Cline.

4. Check it worked

Ask your agent to list your browsers. If the name you gave yours comes back, you are done. If not, each app's page has a short list of what to check.

The first command can take a few seconds

When your browser has not been used for a while, the first command waits a few seconds while it reconnects. Everything after that is immediate.

Is something here wrong, or missing? Tell us.