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 --versionshows yours). The one-command route needs no Node.js.
Step 1: turn on SoftGlaze AI
- In SoftGlaze, open SoftGlaze AI in the sidebar.
- Switch on AI server. The Owner or an Admin can do this. It is off until someone does.
- The status shows Running. The address is
http://127.0.0.1:8080/mcpunless 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
- Open the Tokens tab and create a token. Name it
Claude Code, so the Activity tab and the approval requests say which app asked. - Pick the team member it acts as. The token can do only what that member may do, on that member’s profiles.
- 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.
- Pick an expiry (7, 30 or 90 days, or never) and create it.
- 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.

