Guide3 min read

Linken Sphere MCP Setup: Connect AI Agents to Your Antidetect Browser

Step-by-step guide to connect Claude Code, Cursor, Windsurf, or Cline to Linken Sphere. Control sessions with natural language, no scripts needed.

Apr 18, 2026

One Prompt — Your AI Agent Connects to Linken Sphere

You don't need to edit configs, find ports, or pick flags. Paste one prompt with your token. Your AI agent (Claude Code, Cursor, Codex, Windsurf, Cline) reads the public install guide on GitHub, asks you 1-2 questions, then connects to Linken Sphere via CDP automatically.

How it works: Ornold publishes a public agent guide at github.com/ornold-ai/ornold-mcp. Any AI agent can read `AGENTS.md` and figure out how to install correctly for Linken Sphere.

Step 1 — Start Linken Sphere

Open the Linken Sphere desktop app
Make sure at least one session exists (create one if needed)
Note the API port — default is `40080` (Settings → API). Change it only if it conflicts with another app.

Linken Sphere's API is always on — no toggle needed. Ornold connects via CDP automatically once the port matches.

Step 2 — Get Your Ornold Token

Sign up at mcp.ornold.com
Open the Tokens page
Click Create token, copy the value (starts with `orn_sk_`)

Step 3 — Paste This Prompt into Your AI Agent

Open your agent (Claude Code, Cursor in Agent mode, Codex, Windsurf, Cline) and paste this whole block:

Install Ornold MCP for Linken Sphere automation. I'm new to this, so guide me.

1. Fetch and read the official install guide:
   https://raw.githubusercontent.com/ornold-ai/ornold-mcp/main/AGENTS.md

2. Detect which AI agent I'm running in (Claude Code, Cursor, Codex, Windsurf, Cline, VS Code) and use the correct install method from AGENTS.md.

3. Then ask me:
   a) What port is Linken Sphere using? (Default 40080. If I changed it in Settings → API, I'll tell you.)
   b) Which interaction mode do I want? Briefly explain "vision" (AI sees the page like a human, recommended for antidetect — required for flow recording) vs "dom" (faster but easier to detect). Recommend vision.

4. After I answer, install with these flags: --linken-port <my port> --mode <my mode> and my Ornold token: YOUR_TOKEN

5. If I'm using Claude Code, also install the AI skill: npx mcp-ornold-browser --install-skill

6. Verify by calling browser_list. Tell me how many sessions are detected.

If anything fails, explain in plain language.

Replace `YOUR_TOKEN` with your token. The agent will fetch the guide, ask 1-2 questions, install, and confirm.

Why Vision Mode for Linken Sphere?

Linken Sphere is built for stealth — every profile has a unique fingerprint, behavioral profile, and TLS signature. If your AI clicks via DOM selectors, anti-fraud systems detect the automation pattern and burn the profile, defeating the whole point of antidetect.

`--mode vision` makes the AI take screenshots, identify elements visually, then click by coordinates with Bezier mouse curves. The fingerprint stays clean. Bonus: vision mode is required for flow recording — record actions once on one profile, replay across many.

Step 4 — Verify

Ask the agent:

List my connected Linken Sphere sessions using browser_list

You'll see your sessions. Try a real action:

Open google.com in all my sessions and take a screenshot

Already Know What You Want? Skip the Questions

Pick your agent and run the exact command. Replace `YOUR_TOKEN` with the value from your dashboard.

Claude Code

claude mcp add --transport stdio ornold-browser -- npx mcp-ornold-browser --token YOUR_TOKEN --linken-port 40080 --mode vision
npx mcp-ornold-browser --install-skill

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "ornold-browser": {
      "command": "npx",
      "args": ["mcp-ornold-browser", "--token", "YOUR_TOKEN", "--linken-port", "40080", "--mode", "vision"]
    }
  }
}

Codex (~/.codex/config.toml)

[mcp_servers.ornold-browser]
command = "npx"
args = ["-y", "mcp-ornold-browser", "--token", "YOUR_TOKEN", "--linken-port", "40080", "--mode", "vision"]

Public Resources

**GitHub** — github.com/ornold-ai/ornold-mcp — public agent install guide.
**npm** — mcp-ornold-browser
**Dashboard** — mcp.ornold.com

Troubleshooting

**`browser_list` returns empty** — Linken Sphere must be open with at least one session running. Create a session in the app first.
**Wrong port** — default is `40080`. If you changed it in Settings → API, update the `--linken-port` value to match.
**Token invalid** — re-copy from mcp.ornold.com (full string, including `orn_sk_`).
**Connection refused** — another app may be using port 40080. Change Linken Sphere's port in settings, then update the flag.
**npx: command not found** — install Node.js 18+ from nodejs.org.

What's Next?

Parallel browser automation — run actions across many Sphere sessions at once
CAPTCHA solving guide — reCAPTCHA, hCaptcha, Turnstile in Linken Sphere
Vision AI vs CSS selectors — why this matters for antidetect
Scaling account registration to 50 profiles

Explainer