DEV Community

Cover image for How to connect Claude Code to an antidetect browser, step by step
Azhar Ali
Azhar Ali

Posted on Originally published at browser.softglaze.com AI-assisted

How to connect Claude Code to an antidetect browser, step by step

I build SoftGlaze Browser. This is the step-by-step guide I wrote for connecting Claude Code to it. The original, kept up to date, is on our docs: https://browser.softglaze.com/docs/claude-code

SoftGlaze Browser is a multi-profile (antidetect) browser for Windows with an
MCP server built in, called SoftGlaze AI (Beta). Claude Code connects to it like
any other MCP server. It then gets 40 tools to list and start
browser profiles, check proxies, run macros and work inside the pages of a
running profile, each profile with its own proxy and fingerprint. Anything that
changes something waits for your approval inside SoftGlaze.

This page is the Claude Code route from start to finish, in about five minutes.
For every other AI app, see Connect your AI app.

What you need

  • SoftGlaze Browser 1.0.22 or later on Windows 10 or 11, with your workspace open. The 7-day trial is enough.
  • Claude Code, on the same computer as SoftGlaze. The server answers only at 127.0.0.1, so Claude Code on another computer can't reach it.
  • For the plugin route only: Node.js 18 or newer (node --version shows yours). The one-command route needs no Node.js.

Step 1: turn on SoftGlaze AI

  1. In SoftGlaze, open SoftGlaze AI in the sidebar.
  2. Switch on AI server. The Owner or an Admin can do this. It is off until someone does.
  3. The status shows Running. The address is http://127.0.0.1:8080/mcp unless the port was changed on the Settings tab.

If the status says "Not running", another program holds the port. See
the port is in use below.

Step 2: create a token for Claude Code

  1. Open the Tokens tab and create a token. Name it Claude Code, so the Activity tab and the approval requests say which app asked.
  2. Pick the team member it acts as. The token can do only what that member may do, on that member's profiles.
  3. Under What it may do, start with Read only. Move to Operate once you want Claude Code to start profiles, run macros or work inside pages.
  4. Pick an expiry (7, 30 or 90 days, or never) and create it.
  5. Copy the token now. It starts with sgai_, has 40 more characters, and SoftGlaze shows it only once.

Step 3: add SoftGlaze to Claude Code

Use one of the two ways below, not both, or Claude Code gets two sets of the
same tools.

The one-command way

Run this in a terminal, with your token in place of <YOUR_TOKEN>:

claude mcp add --transport http softglaze http://127.0.0.1:8080/mcp --header "Authorization: Bearer <YOUR_TOKEN>"
Enter fullscreen mode Exit fullscreen mode

Add --scope user to use SoftGlaze in every project, not just the current
folder. The Connect tab on the SoftGlaze AI page shows the same command with
your port filled in.

The plugin way

Run these inside Claude Code:

/plugin marketplace add softglazee/softglaze-claude-plugin
/plugin install softglaze-browser@softglaze
/plugin install softglaze-browser-connector@softglaze
Enter fullscreen mode Exit fullscreen mode

softglaze-browser adds skills only: it teaches Claude how to use the tools and
adds the 12 SoftGlaze workflows, such as
/softglaze-browser:daily-health-check. softglaze-browser-connector adds the
tools, and asks for your token and port while it installs. Details are in
Install in Claude Code.

Step 4: check the connection

Type /mcp in Claude Code. SoftGlaze should show as connected:
softglaze with the command, or
plugin:softglaze-browser-connector:softglaze with the plugins. Then ask:

Read the SoftGlaze workspace summary and list my profiles with their proxies.
Enter fullscreen mode Exit fullscreen mode

Reading doesn't ask for approval by default, so the answer comes straight back.
The SoftGlaze AI page now lists Claude Code under Connected apps.

Step 5: your first approved task

With an Operate token, ask for something that changes something:

Start the profile Store-DE-01, open https://example.com in it and tell me the page title.
Enter fullscreen mode Exit fullscreen mode

SoftGlaze shows a request, on whatever page of the app you are on. Its shape (the
profile is named by its number):

Claude Code is asking for permission
Claude Code wants to: Start profile #42
[ Deny ]   [ Allow for 1 hour ]   [ Allow once ]
Enter fullscreen mode Exit fullscreen mode
  • Allow once lets this one call run.
  • Allow for 1 hour lets the same kind of action from this token run for an hour without asking. For page actions it covers this one profile.
  • Deny, or no answer within 2 minutes, refuses it, and Claude Code is told so.

You choose how often SoftGlaze asks, per kind of tool, on the Settings tab
under "When SoftGlaze asks you". Changes always ask at least once an hour; read-only
tools don't ask unless you want them to. The full rules are on
AI approvals.

To stop everything at once, press Stop all AI at the top of the SoftGlaze AI
page.

Cursor and Claude Desktop

Cursor

Open ~/.cursor/mcp.json (or .cursor/mcp.json in one project) and add the
setup from the Connect tab, with your token in place of <YOUR_TOKEN>:

{
  "mcpServers": {
    "softglaze": {
      "url": "http://127.0.0.1:8080/mcp",
      "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

To keep the token out of the file, use "Bearer ${env:SOFTGLAZE_TOKEN}". The
full steps are in Cursor.

Claude Desktop and Cowork

Install the SoftGlaze extension for Claude Desktop
(softglaze-browser.mcpb) and paste your token when Claude Desktop asks. The
full steps are in Install in Claude Desktop.

Troubleshooting

Claude Code doesn't list SoftGlaze

SoftGlaze is closed, the AI server is switched off, or the port in the command is
not the one on the Settings tab. Open SoftGlaze, switch on AI server, then
start a new Claude Code session.

The port is in use

"Port 8080 is already in use by another program." Close that
program, or let the Owner pick another port on the Settings tab, then add
SoftGlaze to Claude Code again with the new port.

401

The token is missing, was not pasted whole, or was revoked or has expired. Tokens
can't be shown again: create a new one and add SoftGlaze again.

403

  • This token has the read scope: the tool needs Operate. Create an Operate token.
  • This token is a Developer API token: keys that start sg_ don't work on /mcp. Create a SoftGlaze AI token.
  • Outside the groups this token may use: the token is limited to some groups.

503

SoftGlaze AI is switched off. Switch AI server on again. Stop all AI switches
it off on purpose.

Claude Code says it is waiting for approval

Answer the request in SoftGlaze. If Claude Code gave up waiting before you
answered, your answer is kept, and asking Claude Code to try the same thing again
goes through.

Two sets of SoftGlaze tools

You added SoftGlaze both ways, the connector plugin and a claude mcp add entry.
Remove one: claude mcp remove softglaze, or uninstall the connector plugin with
/plugin.

More answers: SoftGlaze AI troubleshooting.

Top comments (0)