SoftGlaze Proxy Bridge 1.0.0
============================

Lets AI apps on your computer (Claude Desktop, Claude Code, Codex CLI, Antigravity CLI,
VS Code with GitHub Copilot, Cursor, Gemini CLI) use the SoftGlaze Proxy browser extension
through MCP (Model Context Protocol). It runs only on your computer: it talks to the AI
app over stdio and to the extension on 127.0.0.1. Nothing goes to SoftGlaze.

The AI app runs on your own AI plan or key; the extension needs none. This is also the
way to use a plan you pay for (Claude, ChatGPT, Gemini, GitHub Copilot, Cursor): a plan
works in that company's own app, and Anthropic does not allow other products to sign in
with a Claude plan, so the extension's built-in assistant takes API keys only.

Every change an AI app asks for (switching a proxy, adding a site rule...) opens an
approval window in the extension first: Allow once, Allow for 1 hour, or Deny.


REQUIREMENTS
------------
- Node.js 20 or newer (https://nodejs.org). Check with:  node --version
- The SoftGlaze Proxy extension in Chrome, Edge or Firefox.
- Nothing else: the packages the bridge needs are already in node_modules,
  so you do not run "npm install".


1. UNZIP
--------
Unzip this file somewhere that stays put, for example C:\SoftGlaze on Windows or
~/SoftGlaze on macOS and Linux. You get a folder named "softglaze-proxy-bridge".
To update later, delete that folder and unzip the newer version in the same place: the
folder name stays the same, so your pairing and your AI app settings keep working.


2. PAIR IT WITH THE EXTENSION (once)
------------------------------------
a. In the extension: Settings, "AI apps (MCP)", turn on "Let AI apps connect".
b. Type where the softglaze-proxy-bridge folder is, for example
   C:\SoftGlaze\softglaze-proxy-bridge
   The page fills in the commands and the settings below with your folder.
c. Press Pair. The page shows a one-time code and the command to run, for example:

   node "C:\SoftGlaze\softglaze-proxy-bridge\bin\softglaze-proxy-bridge.js" pair ABCDE-FGHJK

d. Run that command in a terminal (Command Prompt, PowerShell or Terminal). It waits until
   the extension has paired, then ends. The code works once, for 10 minutes.


3. ADD IT TO YOUR AI APP
------------------------
Replace C:/SoftGlaze/softglaze-proxy-bridge with your own folder (forward slashes work on
Windows too). The extension's setup page shows these with your folder filled in. If a
settings file already has an "mcpServers" list, add only the "softglaze-proxy" part
inside it. Which app goes with which plan:

  Claude Pro, Max or Ultra ............. Claude Desktop or Claude Code
  ChatGPT Plus, Pro, Business, Edu,
    Enterprise ......................... Codex CLI
  Gemini with a Google account (Free,
    Google AI Pro or Ultra) ............ Antigravity CLI
  GitHub Copilot, any plan ............. VS Code
  Cursor ............................... Cursor
  A paid Gemini API key ................ Gemini CLI

Claude Desktop
  Settings, Developer, Edit Config. That opens claude_desktop_config.json
  (Windows: %APPDATA%\Claude\claude_desktop_config.json,
   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json).
  Add this, save, then quit Claude Desktop completely and start it again:

  {
    "mcpServers": {
      "softglaze-proxy": {
        "command": "node",
        "args": ["C:/SoftGlaze/softglaze-proxy-bridge/bin/softglaze-proxy-bridge.js"]
      }
    }
  }

Claude Code
  Run this once in a terminal ("--scope user" makes it available in all your projects):

  claude mcp add --transport stdio --scope user softglaze-proxy -- node "C:/SoftGlaze/softglaze-proxy-bridge/bin/softglaze-proxy-bridge.js"

Codex CLI (OpenAI, signed in with ChatGPT: "codex login")
  Run this once in a terminal:

  codex mcp add softglaze-proxy -- node "C:/SoftGlaze/softglaze-proxy-bridge/bin/softglaze-proxy-bridge.js"

  Or add these lines to ~/.codex/config.toml
  (Windows: %USERPROFILE%\.codex\config.toml):

  [mcp_servers.softglaze-proxy]
  command = "node"
  args = ["C:/SoftGlaze/softglaze-proxy-bridge/bin/softglaze-proxy-bridge.js"]

Antigravity CLI (Google, the "agy" command, signed in with your Google account)
  Since 18 June 2026 it replaces Gemini CLI for Google accounts. Put the same
  "mcpServers" JSON as Claude Desktop in ~/.gemini/config/mcp_config.json
  (Windows: %USERPROFILE%\.gemini\config\mcp_config.json; make the file if it is not
  there), then type /mcp in agy to see it connected.

VS Code with GitHub Copilot
  Run "MCP: Add Server" from the Command Palette, choose Command (stdio), paste this
  command, name it softglaze-proxy and choose Global:

  node "C:/SoftGlaze/softglaze-proxy-bridge/bin/softglaze-proxy-bridge.js"

  Or put this in .vscode/mcp.json of a workspace (VS Code uses "servers" there, not
  "mcpServers"). Then ask Copilot Chat in Agent mode. On Copilot Business or Enterprise,
  your organisation must allow MCP servers.

  {
    "servers": {
      "softglaze-proxy": {
        "type": "stdio",
        "command": "node",
        "args": ["C:/SoftGlaze/softglaze-proxy-bridge/bin/softglaze-proxy-bridge.js"]
      }
    }
  }

Cursor
  The same "mcpServers" JSON as Claude Desktop, in ~/.cursor/mcp.json (all projects)
  or .cursor/mcp.json in one project.

Gemini CLI (with a paid Gemini API key)
  Since 18 June 2026 Gemini CLI works only with a paid Gemini API key or a Gemini Code
  Assist Standard or Enterprise licence. Run this once ("-s user" makes it available in
  every folder):

  gemini mcp add -s user softglaze-proxy node "C:/SoftGlaze/softglaze-proxy-bridge/bin/softglaze-proxy-bridge.js"

If the AI app cannot find "node", put its full path in "command". Find it with
"where node" (Windows) or "which node" (macOS and Linux).

n8n: its MCP nodes connect to a web address (HTTP or SSE). This bridge talks over stdio
only, so n8n cannot use it yet.


OTHER COMMANDS
--------------
  node bin/softglaze-proxy-bridge.js help     what it can do
  node bin/softglaze-proxy-bridge.js status   where the pairing is kept, and whether it is paired
  node bin/softglaze-proxy-bridge.js unpair   forget the pairing


SECURITY IN SHORT
-----------------
- Listens on 127.0.0.1 only (ports 47615 to 47617). Only a browser extension can connect,
  never a web page, and after pairing only the paired extension.
- The pairing code never crosses the connection: both sides derive the same secret from
  it, and every connection proves that secret in both directions before any call.
- The pairing is kept in %APPDATA%\SoftGlaze\proxy-bridge.json (Windows),
  ~/Library/Application Support/SoftGlaze/proxy-bridge.json (macOS) or
  ~/.config/softglaze/proxy-bridge.json (Linux).
- Results never contain passwords, proxy usernames or API keys. The AI app's own AI
  provider receives what the app asks and the tool results (proxy names, addresses,
  countries, test results).

Check the download: the SHA-256 of the zip is on
https://browser.softglaze.com/proxy-extension/bridge and in the .sha256 file next to it.

Privacy: https://browser.softglaze.com/proxy-extension/privacy
Help: support@softglaze.com
