# How to Connect Claude Code to an Antidetect Browser, 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.

- Canonical URL: https://browser.softglaze.com/docs/claude-code
- Last updated 2026-11-17

---

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](https://browser.softglaze.com/docs/ai-agents).

### 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](https://browser.softglaze.com/docs/claude-code#port-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>`:

```bash
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:

```text
/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](https://browser.softglaze.com/docs/ai-install-apps#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:

```text
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:

```text
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):

```text
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](https://browser.softglaze.com/features/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>`:

```json
{
  "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](https://browser.softglaze.com/docs/ai-agents#cursor).

#### Claude Desktop and Cowork

Install the [SoftGlaze extension for Claude Desktop](https://browser.softglaze.com/downloads/softglaze-browser.mcpb) (`softglaze-browser.mcpb`) and paste your token when Claude Desktop asks. The full steps are in [Install in Claude Desktop](https://browser.softglaze.com/docs/ai-install-apps#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](https://browser.softglaze.com/docs/ai-agents#troubleshooting).

[Download for Windows](https://browser.softglaze.com/download) [Try the demo](https://browser.softglaze.com/demo) [All documentation](https://browser.softglaze.com/docs)
