Back to blog
Guide15 min read
Claude Code + Ornold MCP: Full Setup Guide
Install Node.js, set up Claude Code, connect Ornold MCP, and automate antidetect browsers with AI. macOS and Windows.
Apr 17, 2026What You'll Build
By the end of this guide, you'll have Claude Code controlling real antidetect browser sessions — navigating pages, filling forms, solving CAPTCHAs, and managing multiple profiles — all through natural language commands. No Playwright scripts. No CSS selectors. Just tell the AI what to do.
This guide covers macOS and Windows. Linux steps are the same as macOS (use your package manager instead of Homebrew).
Prerequisites
- A computer running macOS 12+ or Windows 10/11
- An antidetect browser installed: Linken Sphere, Dolphin Anty, Wadex, or Vision Browser
- An internet connection for downloading tools and packages
- Basic comfort with the terminal (macOS) or PowerShell (Windows)
Step 1 — Install Node.js
Ornold MCP runs as a Node.js package. You need Node.js version 20 or higher.
macOS
The easiest way is Homebrew. If you don't have Homebrew, install it first from brew.sh. Then:
brew install node@22
Windows
Download the official installer from nodejs.org. Choose the LTS version (22.x). Run the installer and follow the prompts. Make sure "Add to PATH" is checked.
Verify the installation by opening Terminal (macOS) or PowerShell (Windows):
node --version
# Expected output: v22.x.x or higher
npm --version
# Expected output: 10.x.x or higher
Step 2 — Install Claude Code
Claude Code is Anthropic's AI coding agent that runs in your terminal. It supports MCP (Model Context Protocol) which lets it use external tools — like browser automation.
macOS
npm install -g @anthropic-ai/claude-code
Windows
Open PowerShell as Administrator and run:
npm install -g @anthropic-ai/claude-code
After installation, launch Claude Code to complete authentication:
claude
# Follow the prompts to sign in with your Anthropic account
Claude Code requires an Anthropic API key or a Claude Pro/Team subscription. If you don't have one yet, sign up at console.anthropic.com.
Step 3 — 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 "Register" and create an account with your email
- Verify your email with the 6-digit code sent to your inbox
- You'll land on the dashboard — you're in!
Step 4 — Create an API Token
After registration, the dashboard will prompt you to create your first API token. This token authenticates your MCP connection.
- Enter a name for your token (e.g., "Claude Code")
- Click "Create"
- Copy the token and save it somewhere safe — you'll need it in the next step
Free accounts get 1 seat, 5 captcha solves (after completing the tour), and access to standard browsers. Upgrade your plan for more capacity.
Step 5 — Generate MCP Config with the Dashboard Wizard
The Ornold dashboard has a built-in Connect Wizard that generates the exact MCP config for your setup. No manual command crafting needed — just pick 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.
Wizard Step 1 — Choose Your AI Agent
The wizard asks which AI agent you're using. Select "Claude Code" from the list. Other supported agents include Cursor, VS Code, Windsurf, Cline, and Codex — each gets a tailored config format.
Wizard Step 2 — Choose Interaction Mode
Pick how the AI should interact with browser pages:
- DOM mode (default) — The AI reads the page HTML structure. Each element gets a [ref=N] marker. Free and fast. Best for forms, structured pages, and standard websites.
- Vision AI mode — The AI takes a screenshot and visually finds elements by how they look. Works on any page, even canvas-based UIs. Each analysis costs 1 vision credit.
- Both modes — All tools available. The AI picks the best approach for each action automatically.
Start with DOM mode. It's free, fast, and handles 90% of use cases. You can always switch to "Both" later if you need visual analysis.
Wizard Step 3 — Enable Antidetect Browsers
Toggle on the browsers you use and fill in their connection details:
- Linken Sphere — Just set the API port (default: 40080). Make sure Sphere is running.
- Dolphin Anty — Set the local port (default: 3001) and paste your Dolphin API token from Settings → API.
- Wadex — Set the API port (default: 8080).
- Vision Browser — Paste your X-Token. Optionally set a local port.
You can enable multiple browsers at once. The MCP config will include all of them, and the AI agent will be able to control whichever is running.
Wizard Step 4 — Copy and Apply the Config
The wizard generates the final config based on your choices. For Claude Code, you get two options:
Option A: Terminal Command (recommended)
Copy the one-liner and paste it into your terminal. This is a one-time setup — MCP auto-starts with Claude Code every time after.
claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --linken-port 40080
Option B: Project .mcp.json file
If you want the MCP config shared 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 pre-fills your actual token and port values — just click "Copy" and paste. No manual editing needed.
Verify the MCP server was registered:
claude mcp list
# You should see "ornold-browser" in the list
Step 6 — Start Your Browser and Test
Make sure your antidetect browser is running before starting Claude Code. Quick checklist:
- Linken Sphere — Open the app. Create at least one session if you don't have any.
- Dolphin Anty — Open the app. Make sure the local API is enabled in Settings.
- Wadex — Open the app and verify the API port matches your config.
Step 7 — Your First AI Browser Command
Everything is connected. Start Claude Code in any directory:
claude
Now talk to it in natural language. Here are some commands to try:
# Start a Linken Sphere session and navigate
> Start a new 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
Available MCP Tools
Once connected, Claude Code has access to 40+ browser automation tools. Here are the most commonly used:
- linken_start_instances / dolphin_start_profiles — Start browser sessions
- browser_parallel_navigate — Open URLs 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 — Capture screenshots of all sessions
- browser_parallel_vision_analyze_grouped — AI-powered visual page analysis
- browser_solve_captcha — Auto-solve reCAPTCHA, hCaptcha, Turnstile, and more
- browser_parallel_evaluate — Run JavaScript in page context
- linken_stop_instances / dolphin_stop_profiles — Close sessions
You don't need to remember tool names. Just describe what you want in plain English and Claude Code will pick the right tools automatically.
Interaction Modes
Ornold MCP supports two interaction modes. You can choose when setting up:
DOM Mode (default, free)
The AI reads the page structure via DOM snapshots. Each element gets a [ref=N] marker. Fast and doesn't cost any 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 how they look. Works on any page, even complex SPAs or canvas-based UIs. Each analysis costs 1 vision credit.
# Enable both modes:
claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --mode both
Troubleshooting
- "npx: command not found" — Node.js not in PATH. Restart terminal after installing Node.js. On Windows, make sure you checked "Add to PATH" during installation.
- "Cannot connect to Linken Sphere" — Make sure Sphere is running and the API port is correct (default 40080). Check that no firewall blocks the port.
- "Token invalid" — Copy the token again from mcp.ornold.com dashboard. Tokens are long strings — make sure you copied the entire value.
- "MCP server not responding" — Run `claude mcp list` to verify registration. Try removing and re-adding: `claude mcp remove ornold-browser` then re-run the add command.
- "CAPTCHA solve failed" — Check your captcha credit balance on the Ornold dashboard. Free plan includes limited solves.
- "Permission denied (npm install)" — On macOS, prefix with sudo. On Windows, run PowerShell as Administrator.
What's Next?
- Read the Linken Sphere automation guide for advanced session management
- Learn about parallel browser automation for running 10+ sessions at once
- Check the CAPTCHA solving guide for handling reCAPTCHA, hCaptcha, and Turnstile
- Explore Vision AI mode for interacting with complex visual interfaces