Install SoftGlaze in Claude Desktop, Cowork and Claude Code

These installs connect Claude to SoftGlaze AI, the MCP server inside SoftGlaze Browser on your computer. They give Claude the same 40 tools as the manual setups, with less typing. Every change Claude asks for still waits for you to press Allow in SoftGlaze.

For Cursor, VS Code, Gemini CLI, Codex and the other AI apps, use the setups in the main guide.

Before you start

1. Open SoftGlaze Browser 1.0.22 or newer (SoftGlaze AI is a Beta), go to the SoftGlaze AI page and switch on AI server. Note the port: 8080 unless the Owner changed it.
2. On the Tokens tab, create a token for the app you are about to connect. It starts with sgai_ and is shown only once.

Make one token per app, and revoke it on the Tokens tab when you stop using that app.

Which install for which app

Which install for which app: table

Where you use Claude	What to install
Claude Desktop chats	The SoftGlaze extension for Claude Desktop (softglaze-browser.mcpb)
Cowork	The same extension for the tools, and the softglaze-browser plugin for the skills
Claude Code	Two plugins: softglaze-browser (skills) and softglaze-browser-connector (tools), or one claude mcp add command
claude.ai in a web browser	The skills load, but SoftGlaze’s tools answer only on your own computer, so a web chat can’t reach them

Install one way per app. Two ways at once give Claude two sets of SoftGlaze tools.

Claude Desktop: the .mcpb extension

Download softglaze-browser.mcpb (version 1.0.0, 68 KB, Windows). Its SHA-256 is in softglaze-browser.mcpb.sha256:

f9d4384c268054cbcda52516e3bc092a0e65cf5a9ac981d1ee8163d9097e974b

The file is not code-signed yet, so check it before you install it. In PowerShell, in the folder you saved it to:

Get-FileHash .\softglaze-browser.mcpb -Algorithm SHA256

The hash it prints must match the one above (PowerShell prints it in capital letters). Then:

1. Install it in one of three ways: double-click the file, drag it into the Claude Desktop window, or in Claude Desktop open Settings, Extensions, Advanced settings, Install Extension… and choose it.
2. Claude Desktop shows what the extension is and asks for two settings: the SoftGlaze AI token and the SoftGlaze AI port. Paste your token, keep the port at 8080 unless yours is different, and finish the install.
3. Start a new chat and ask: “Read the SoftGlaze workspace summary.” Claude calls workspace_summary and tells you what it can see.

What it runs:

• A small script, the same bridge as the Claude Code connector plugin. Claude Desktop runs it with the Node.js that comes with Claude Desktop, so you install nothing else.
• The bridge sends Claude’s requests to SoftGlaze at 127.0.0.1 and refuses any other address. It reads the token and port only from the two settings above and reads no files. The token setting is marked sensitive, so Claude Desktop masks it and stores it securely.
• It sends nothing to SoftGlaze’s servers. Claude sends what the tools return to Anthropic as part of your conversation, like any other tool.

To change the token or port later, open the extension under Settings, Extensions in Claude Desktop.

If you added SoftGlaze to claude_desktop_config.json by hand before, remove that "softglaze" entry so Claude doesn’t get two sets of SoftGlaze tools.

Cowork

Cowork runs in the Claude desktop app, so it uses the same .mcpb extension for SoftGlaze’s tools. Install that first.

For the skills (how to use the tools well, and the twelve SoftGlaze workflows), add the SoftGlaze plugins in the desktop app: open Customize, Plugins, then Add, Add marketplace, enter softglazee/softglaze-claude-plugin and install softglaze-browser. It contains only Markdown skills, so it needs no settings.

Don’t install the connector plugin in Cowork: Cowork doesn’t show plugin settings yet, so it can’t take your token. The extension does that job.

Claude Code

Run these in Claude Code:

/plugin marketplace add softglazee/softglaze-claude-plugin
/plugin install softglaze-browser@softglaze
/plugin install softglaze-browser-connector@softglaze

• softglaze-browser is skills only: no scripts and no server. It teaches Claude how to use SoftGlaze’s tools and adds the twelve SoftGlaze workflows as skills, such as /softglaze-browser:daily-health-check and /softglaze-browser:diagnose-captcha.
• softglaze-browser-connector adds the tools. It is the same small bridge, run by Node.js 18 or newer on your computer (node --version shows yours). Claude Code asks for the token and the port when you install it, and keeps the token in your system’s secure storage. To change them later: /plugin, Installed, softglaze-browser-connector, Configure.

Then run /mcp and check that plugin:softglaze-browser-connector:softglaze is connected.

From a terminal instead of a session: claude plugin marketplace add softglazee/softglaze-claude-plugin, then claude plugin install softglaze-browser@softglaze and claude plugin install softglaze-browser-connector@softglaze. That way does not ask for the token, so set it afterwards with /plugin as above.

Without Node.js

Skip the connector plugin and add SoftGlaze over HTTP, 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>"

This is the same setup as Claude Code in the main guide. The softglaze-browser skills plugin works with it too.

The SoftGlaze Proxy extension

SoftGlaze Proxy, our free proxy switcher for Chrome, Edge and Firefox, is coming soon to their add-on stores. It connects to Claude Desktop, Claude Code and other AI apps through its own bridge; the setup for each app is on the bridge page.

Troubleshooting

• SoftGlaze is not reachable: SoftGlaze is closed, the AI server is off, or the port is not the one you entered.
• 401: the token was not pasted completely, or it was revoked or has expired. Create a new one.
• Claude Code has the skills but no SoftGlaze tools: install softglaze-browser-connector too (or use the HTTP command above), then start a new session.
• Two sets of SoftGlaze tools: you connected SoftGlaze twice, for example the extension and a setup in claude_desktop_config.json, or the connector plugin and a claude mcp add entry. Keep one.
• More answers: SoftGlaze AI troubleshooting.