Guide12 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

What You'll Get

By the end of this guide, you'll have AI agents (Claude Code, Cursor, Windsurf, or Cline) controlling real Linken Sphere sessions — opening pages, filling forms, solving CAPTCHAs, and managing multiple sessions — all through natural language commands. No Playwright scripts. No CSS selectors. Just tell the AI what to do.

This guide covers Linken Sphere specifically. If you're using Dolphin Anty, Wadex, or Vision Browser, check the browser-specific setup guides.

Prerequisites

Linken Sphere installed and running
At least one session created in Linken Sphere
Node.js 20+ installed (nodejs.org)
An AI agent: Claude Code, Cursor, Windsurf, or Cline
Basic terminal/command line familiarity

Step 1 — Enable Linken Sphere API

Linken Sphere exposes a local HTTP API that Ornold MCP uses to launch and control sessions. The API is enabled by default on port 40080.

Open Linken Sphere
Make sure the application is running
The API is automatically available at http://localhost:40080
No additional configuration needed — Linken Sphere API is always on

If you changed the default port in Linken Sphere settings, note it down — you'll need it in Step 4.

Step 2 — Create an Ornold Account

Ornold is the bridge between AI agents and antidetect browsers. You need an account to get an API token.

Go to mcp.ornold.com
Click "Sign Up" and create an account with your email
Verify your email with the 6-digit code sent to your inbox
You'll land in the dashboard — ready for the next step

🖼️

Create your Ornold account at mcp.ornold.com

Step 3 — Create an API Token

After registration, the dashboard will prompt you to create your first API token. This token authenticates the MCP connection.

Enter a name for the token (e.g., "Linken Sphere")
Click "Create"
Copy the token and save it somewhere safe — you'll need it in the next step

🖼️

Create and copy your API token

Free tier includes 1 slot, 5 CAPTCHA solves (after onboarding), and access to standard browsers. Upgrade for more capacity.

Step 4 — Generate MCP Config via Setup Wizard

The Ornold dashboard has a built-in connection wizard that generates the exact MCP configuration for your setup. No manual typing — just select your options and copy the result.

Go to the "API Tokens" tab in the dashboard. Find your token and click the "Connect" button next to it.

🖼️

Click "Connect" on your token to open the wizard

Wizard Step 1 — Select Your AI Agent

The wizard will ask which AI agent you're using. Select your agent from the list (Claude Code, Cursor, Windsurf, Cline, or Codex). Each agent gets its own config format.

🖼️

Step 1: Select your AI agent

Wizard Step 2 — Choose Interaction Mode

Choose how the AI should interact with browser pages:

DOM mode (default) — AI reads the HTML structure. Each element gets a [ref=N] marker. Free and fast. Best for forms, structured pages, and standard websites.
Vision AI mode — AI takes a screenshot and visually finds elements by appearance. Works on any page, including canvas interfaces. Each analysis costs 1 vision credit.
Both modes — All tools available. AI automatically picks the best approach for each action.

Start with DOM mode. It's free, fast, and handles 90% of tasks. You can always switch to "Both modes" if you need visual analysis.

🖼️

Step 2: Choose DOM mode for most use cases

Wizard Step 3 — Enable Linken Sphere

Toggle Linken Sphere ON and fill in the connection details:

API port (default: 40080) — use the default unless you changed it in Linken Sphere settings

You can enable multiple browsers at once. The MCP config will include all of them, and the AI agent can control whichever one is running.

🖼️

Step 3: Enable Linken Sphere and confirm the port

Wizard Step 4 — Copy and Apply Config

The wizard generates the final config based on your choices. For most AI agents, you have two options:

Option A: Terminal Command (Recommended)

Copy the one-line command and paste it into your terminal. This is a one-time setup — MCP will auto-start with your AI agent every time after.

claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --linken-port 40080

🖼️

Step 4: Copy the terminal command and run it

Option B: Project .mcp.json File

If you want to share the MCP config with your team via version control, copy the JSON and save it as .mcp.json in your project root:

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

The wizard auto-fills your token and port values — just click "Copy" and paste. No manual editing needed.

Verify the MCP server is registered:

claude mcp list
# You should see "ornold-browser" in the list

🖼️

Ornold MCP server registered successfully

Step 5 — Launch Linken Sphere and Test

Before running your AI agent, make sure Linken Sphere is open and you have at least one session created.

Open Linken Sphere
Make sure you have at least one session in the list
Keep Linken Sphere running in the background

Step 6 — First AI Browser Command

Everything is connected. Launch your AI agent (Claude Code, Cursor, Windsurf, or Cline) and talk to it in natural language. Here are some commands to get started:

# Start a Linken Sphere session and navigate
> Start a Linken Sphere session and open google.com

# Fill a form
> Go to example.com/signup, fill in email "test@mail.com" and password "SecurePass123", then click Sign Up

# Solve a CAPTCHA
> There's a CAPTCHA on this page, solve it

# Take a screenshot for visual analysis
> Take a screenshot of the current page and describe what you see

# Work with multiple sessions
> Start 3 Linken Sphere sessions and open google.com in all of them

🖼️

AI agent controlling Linken Sphere via natural language

Available MCP Tools

After connecting, your AI agent gets access to 40+ browser automation tools. Here are the most commonly used:

browser_list — List all available Linken Sphere sessions
browser_parallel_navigate — Open a URL in all active browsers
browser_parallel_snapshot — Get page DOM with clickable [ref=N] markers
browser_parallel_click — Click elements by ref or selector
browser_parallel_fill — Type text into input fields
browser_parallel_screenshot — Take screenshots of all sessions
browser_parallel_vision_analyze_grouped — Visual analysis of pages with AI
browser_solve_captcha — Auto-solve reCAPTCHA, hCaptcha, Turnstile, and more
browser_parallel_evaluate — Execute JavaScript in page context
browser_status — Check which sessions are running

You don't need to memorize tool names. Just describe what you want in plain language, and the AI agent will automatically pick the right tools.

Linken Sphere Desktops

Linken Sphere organizes sessions into "desktops" — isolated workspaces that group related sessions. When you start a session via MCP, it uses the currently active desktop in Linken Sphere.

To control which desktop is used, switch to it in Linken Sphere before running AI commands. The MCP bridge respects your active desktop selection.

Interaction Modes

Ornold MCP supports two interaction modes. You chose one during setup:

DOM Mode (Default, Free)

The AI reads page structure via DOM snapshots. Each element gets a [ref=N] marker. Fast and doesn't consume vision credits. Best for structured pages with clear HTML.

Vision AI Mode (Paid, Per Analysis)

The AI takes a screenshot and uses visual analysis to find elements by appearance. Works on any page, including complex SPAs or canvas interfaces. Each analysis costs 1 vision credit.

# Enable both modes:
claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --mode both --linken-port 40080

Troubleshooting

"No sessions found" — Make sure Linken Sphere is running and you have at least one session created.
"Connection refused" — Verify the port number (default: 40080) matches your Linken Sphere API port. Make sure no firewall is blocking localhost connections.
"MCP server not found" — Run `claude mcp list` to verify ornold-browser is registered. If not, re-run the setup command from Step 4.
"Permission denied (npm install)" — On macOS, prefix with sudo. On Windows, run PowerShell as Administrator.
"Session launch timeout" — Linken Sphere can be slow to launch sessions on first run. Wait 10-15 seconds and try again.

What's Next?

Read the Dolphin Anty automation guide (/blog/dolphin-anty-mcp-setup) for comparison with another popular antidetect browser
Learn about parallel browser automation (/blog/parallel-browser-automation) for running 10+ sessions at once
Check the CAPTCHA solving guide (/blog/captcha-solving-guide) for handling reCAPTCHA, hCaptcha, and Turnstile
Explore Vision AI mode (/blog/vision-vs-selectors) for interacting with complex visual interfaces

Explainer