Zurück zum Blog
Leitfaden15 Min. Lesezeit
Claude Code + Ornold MCP: vollständige Einrichtung
Node.js installieren, Claude Code einrichten, Ornold MCP verbinden und Antidetect-Browser mit KI automatisieren. macOS und Windows.
17. Apr. 2026Was du aufbauen wirst
Am Ende dieser Anleitung wirst du Claude Code dabei haben, echte Antidetect-Browser-Sitzungen zu steuern — Seiten navigieren, Formulare ausfüllen, CAPTCHAs lösen und mehrere Profile verwalten — alles über natürlichsprachliche Befehle. Keine Playwright-Skripte. Keine CSS-Selektoren. Sag der KI einfach, was sie tun soll.
Diese Anleitung deckt macOS und Windows ab. Die Linux-Schritte sind dieselben wie bei macOS (verwende deinen Paketmanager anstelle von Homebrew).
Voraussetzungen
- Ein Computer mit macOS 12+ oder Windows 10/11
- Ein installierter Antidetect-Browser: Linken Sphere, Dolphin Anty, Wadex oder Vision Browser
- Eine Internetverbindung zum Herunterladen von Tools und Paketen
- Grundlegende Vertrautheit mit dem Terminal (macOS) oder PowerShell (Windows)
Schritt 1 — Node.js installieren
Ornold MCP läuft als Node.js-Paket. Du benötigst Node.js Version 20 oder höher.
macOS
Am einfachsten geht es mit Homebrew. Falls du Homebrew noch nicht hast, installiere es zuerst von brew.sh. Dann:
brew install node@22
Windows
Lade das offizielle Installationsprogramm von nodejs.org herunter. Wähle die LTS-Version (22.x). Starte das Installationsprogramm und folge den Anweisungen. Stelle sicher, dass „Zu PATH hinzufügen" aktiviert ist.
Überprüfe die Installation, indem du das Terminal (macOS) oder PowerShell (Windows) öffnest:
node --version
# Erwartete Ausgabe: v22.x.x oder höher
npm --version
# Erwartete Ausgabe: 10.x.x oder höher
Schritt 2 — Claude Code installieren
Claude Code ist Anthropics KI-Coding-Agent, der in deinem Terminal läuft. Er unterstützt MCP (Model Context Protocol), wodurch er externe Tools nutzen kann — wie Browser-Automatisierung.
macOS
npm install -g @anthropic-ai/claude-code
Windows
Öffne PowerShell als Administrator und führe aus:
npm install -g @anthropic-ai/claude-code
Starte Claude Code nach der Installation, um die Authentifizierung abzuschließen:
claude
# Folge den Anweisungen zur Anmeldung mit deinem Anthropic-Konto
Claude Code benötigt einen Anthropic API-Schlüssel oder ein Claude Pro/Team-Abonnement. Falls du noch keins hast, registriere dich unter console.anthropic.com.
Schritt 3 — Ein Ornold-Konto erstellen
Ornold ist die Brücke zwischen KI-Agenten und Antidetect-Browsern. Du benötigst ein Konto, um ein API-Token zu erhalten.
- Gehe zu mcp.ornold.com
- Klicke auf „Registrieren" und erstelle ein Konto mit deiner E-Mail-Adresse
- Bestätige deine E-Mail mit dem 6-stelligen Code, der an dein Postfach gesendet wurde
- Du landest auf dem Dashboard — du bist drin!
Schritt 4 — Ein API-Token erstellen
Nach der Registrierung fordert dich das Dashboard auf, dein erstes API-Token zu erstellen. Dieses Token authentifiziert deine MCP-Verbindung.
- Gib einen Namen für dein Token ein (z. B. „Claude Code")
- Klicke auf „Erstellen"
- Kopiere das Token und speichere es an einem sicheren Ort — du benötigst es im nächsten Schritt
Kostenlose Konten erhalten 1 Sitzungsplatz, 5 CAPTCHA-Lösungen (nach Abschluss der Tour) und Zugang zu Standard-Browsern. Upgraden Sie Ihren Plan für mehr Kapazität.
Schritt 5 — MCP-Konfiguration mit dem Dashboard-Assistenten generieren
Das Ornold-Dashboard verfügt über einen integrierten Verbindungsassistenten, der die exakte MCP-Konfiguration für dein Setup generiert. Kein manuelles Erstellen von Befehlen nötig — wähle einfach deine Optionen und kopiere das Ergebnis.
Gehe im Dashboard zum Tab „API-Tokens". Suche dein Token und klicke auf die Schaltfläche „Verbinden" daneben.
Assistent Schritt 1 — Wähle deinen KI-Agenten
Der Assistent fragt, welchen KI-Agenten du verwendest. Wähle „Claude Code" aus der Liste. Weitere unterstützte Agenten sind Cursor, VS Code, Windsurf, Cline und Codex — jeder erhält ein maßgeschneidertes Konfigurationsformat.
Assistent Schritt 2 — Interaktionsmodus wählen
Wähle aus, wie die KI mit Browser-Seiten interagieren soll:
- DOM-Modus (Standard) — Die KI liest die HTML-Struktur der Seite. Jedes Element erhält einen [ref=N]-Marker. Kostenlos und schnell. Am besten für Formulare, strukturierte Seiten und Standard-Websites.
- Vision AI-Modus — Die KI erstellt einen Screenshot und findet Elemente visuell anhand ihres Aussehens. Funktioniert auf jeder Seite, auch canvas-basierten Benutzeroberflächen. Jede Analyse kostet 1 Vision-Kredit.
- Beide Modi — Alle Tools verfügbar. Die KI wählt automatisch den besten Ansatz für jede Aktion.
Beginne mit dem DOM-Modus. Er ist kostenlos, schnell und deckt 90 % der Anwendungsfälle ab. Du kannst später jederzeit auf „Beide" umschalten, wenn du visuelle Analyse benötigst.
Assistent Schritt 3 — Antidetect-Browser aktivieren
Aktiviere die Browser, die du verwendest, und fülle ihre Verbindungsdetails aus:
- Linken Sphere — Lege einfach den API-Port fest (Standard: 40080). Stelle sicher, dass Sphere läuft.
- Dolphin Anty — Lege den lokalen Port fest (Standard: 3001) und füge deinen Dolphin API-Token aus Einstellungen → API ein.
- Wadex — Lege den API-Port fest (Standard: 8080).
- Vision Browser — Füge deinen X-Token ein. Optional einen lokalen Port festlegen.
Du kannst mehrere Browser gleichzeitig aktivieren. Die MCP-Konfiguration wird alle einschließen, und der KI-Agent kann steuern, welcher gerade läuft.
Assistent Schritt 4 — Konfiguration kopieren und anwenden
Der Assistent generiert die endgültige Konfiguration basierend auf deinen Auswahlen. Für Claude Code gibt es zwei Optionen:
Option A: Terminal-Befehl (empfohlen)
Kopiere den einzeiligen Befehl und füge ihn in dein Terminal ein. Dies ist eine einmalige Einrichtung — MCP startet danach jedes Mal automatisch mit Claude Code.
claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --linken-port 40080
Option B: Projekt .mcp.json-Datei
Wenn du die MCP-Konfiguration per Versionsverwaltung mit deinem Team teilen möchtest, kopiere das JSON und speichere es als .mcp.json im Stammverzeichnis deines Projekts:
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--linken-port", "40080"]
}
}
}
Der Assistent füllt deinen tatsächlichen Token und Port-Werte vorab aus — klicke einfach auf „Kopieren" und füge ein. Kein manuelles Bearbeiten nötig.
Überprüfe, ob der MCP-Server registriert wurde:
claude mcp list
# Du solltest "ornold-browser" in der Liste sehen
Schritt 6 — Browser starten und testen
Stelle sicher, dass dein Antidetect-Browser läuft, bevor du Claude Code startest. Kurze Checkliste:
- Linken Sphere — Öffne die App. Erstelle mindestens eine Sitzung, falls du noch keine hast.
- Dolphin Anty — Öffne die App. Stelle sicher, dass die lokale API in den Einstellungen aktiviert ist.
- Wadex — Öffne die App und überprüfe, ob der API-Port mit deiner Konfiguration übereinstimmt.
Schritt 7 — Dein erster KI-Browser-Befehl
Alles ist verbunden. Starte Claude Code in einem beliebigen Verzeichnis:
claude
Sprich jetzt in natürlicher Sprache mit ihm. Hier sind einige Befehle zum Ausprobieren:
# Eine Linken Sphere-Sitzung starten und navigieren
> Starte eine neue Linken Sphere-Sitzung und öffne google.com
# Ein Formular ausfüllen
> Gehe zu example.com/signup, fülle E-Mail "test@mail.com" und Passwort "SecurePass123" ein, dann klicke auf Registrieren
# Ein CAPTCHA lösen
> Es gibt ein CAPTCHA auf dieser Seite, löse es
# Einen Screenshot für visuelle Analyse aufnehmen
> Mache einen Screenshot der aktuellen Seite und beschreibe, was du siehst
# Mit mehreren Sitzungen arbeiten
> Starte 3 Linken Sphere-Sitzungen und öffne google.com in allen
Verfügbare MCP-Tools
Nach der Verbindung hat Claude Code Zugriff auf über 40 Browser-Automatisierungs-Tools. Hier sind die am häufigsten verwendeten:
- linken_start_instances / dolphin_start_profiles — Browser-Sitzungen starten
- browser_parallel_navigate — URLs in allen aktiven Browsern öffnen
- browser_parallel_snapshot — Seiten-DOM mit klickbaren [ref=N]-Markern abrufen
- browser_parallel_click — Elemente per Ref oder Selektor klicken
- browser_parallel_fill — Text in Eingabefelder eingeben
- browser_parallel_screenshot — Screenshots aller Sitzungen aufnehmen
- browser_parallel_vision_analyze_grouped — KI-gestützte visuelle Seitenanalyse
- browser_solve_captcha — reCAPTCHA, hCaptcha, Turnstile und mehr automatisch lösen
- browser_parallel_evaluate — JavaScript im Seitenkontext ausführen
- linken_stop_instances / dolphin_stop_profiles — Sitzungen beenden
Du musst dir keine Tool-Namen merken. Beschreibe einfach, was du auf Englisch willst, und Claude Code wählt automatisch die richtigen Tools aus.
Interaktionsmodi
Ornold MCP unterstützt zwei Interaktionsmodi. Du kannst beim Einrichten wählen:
DOM-Modus (Standard, kostenlos)
Die KI liest die Seitenstruktur über DOM-Snapshots. Jedes Element erhält einen [ref=N]-Marker. Schnell und kostet keine Vision-Kredite. Am besten für strukturierte Seiten mit klarem HTML.
Vision AI-Modus (bezahlt pro Analyse)
Die KI nimmt einen Screenshot und verwendet visuelle Analyse, um Elemente anhand ihres Aussehens zu finden. Funktioniert auf jeder Seite, auch komplexen SPAs oder canvas-basierten Benutzeroberflächen. Jede Analyse kostet 1 Vision-Kredit.
# Beide Modi aktivieren:
claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --mode both
Fehlerbehebung
- „npx: Befehl nicht gefunden" — Node.js ist nicht im PATH. Starte das Terminal nach der Installation von Node.js neu. Unter Windows stelle sicher, dass du während der Installation „Zu PATH hinzufügen" aktiviert hast.
- „Keine Verbindung zu Linken Sphere möglich" — Stelle sicher, dass Sphere läuft und der API-Port korrekt ist (Standard 40080). Überprüfe, ob eine Firewall den Port blockiert.
- „Token ungültig" — Kopiere den Token erneut vom mcp.ornold.com-Dashboard. Tokens sind lange Zeichenketten — stelle sicher, dass du den gesamten Wert kopiert hast.
- „MCP-Server antwortet nicht" — Führe `claude mcp list` aus, um die Registrierung zu überprüfen. Versuche, den Server zu entfernen und neu hinzuzufügen: `claude mcp remove ornold-browser` und führe dann den Hinzufügen-Befehl erneut aus.
- „CAPTCHA-Lösung fehlgeschlagen" — Überprüfe dein CAPTCHA-Kredit-Guthaben im Ornold-Dashboard. Der kostenlose Plan enthält begrenzte Lösungen.
- „Zugriff verweigert (npm install)" — Unter macOS mit sudo voranstellen. Unter Windows PowerShell als Administrator ausführen.
Was kommt als Nächstes?
- Lies den Linken Sphere-Automatisierungsleitfaden für erweitertes Sitzungsmanagement
- Erfahre mehr über parallele Browser-Automatisierung für den gleichzeitigen Betrieb von 10+ Sitzungen
- Lies den CAPTCHA-Lösungsleitfaden zur Handhabung von reCAPTCHA, hCaptcha und Turnstile
- Erkunde den Vision AI-Modus für die Interaktion mit komplexen visuellen Oberflächen