SoftGlaze AI

How to connect Claude Code to an antidetect browser (SoftGlaze, step by step)

Connect Claude Code to SoftGlaze Browser's built-in MCP server: turn on SoftGlaze AI, create a token, add it with one command or the plugins, approve the first change, and fix common errors.

Last updated 17 November 2026

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>"

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

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.

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.

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 ]
  • 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>" }
    }
  }
}

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 {#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 {#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 {#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.