Zurück zum Blog
Leitfaden12 Min. Lesezeit
Linken Sphere MCP Setup: KI-Agenten mit Antidetect-Browser verbinden
Schritt-für-Schritt-Anleitung zum Verbinden von Claude Code, Cursor, Windsurf oder Cline mit Linken Sphere. Sitzungen per natürlicher Sprache steuern, keine Skripte nötig.
18. Apr. 2026Was du erhältst
Am Ende dieses Leitfadens werden AI-Agenten (Claude Code, Cursor, Windsurf oder Cline) echte Linken Sphere-Sitzungen steuern — Seiten öffnen, Formulare ausfüllen, CAPTCHAs lösen und mehrere Sitzungen verwalten — alles durch natürlichsprachliche Befehle. Keine Playwright-Skripte. Keine CSS-Selektoren. Sag der KI einfach, was sie tun soll.
Dieser Leitfaden behandelt Linken Sphere speziell. Wenn du Dolphin Anty, Wadex oder Vision Browser verwendest, konsultiere die browserspezifischen Einrichtungsleitfäden.
Voraussetzungen
- Linken Sphere installiert und ausgeführt
- Mindestens eine Sitzung in Linken Sphere erstellt
- Node.js 20+ installiert (nodejs.org)
- Ein AI-Agent: Claude Code, Cursor, Windsurf oder Cline
- Grundlegende Vertrautheit mit Terminal/Befehlszeile
Schritt 1 — Linken Sphere API aktivieren
Linken Sphere stellt eine lokale HTTP-API bereit, die Ornold MCP zum Starten und Steuern von Sitzungen verwendet. Die API ist standardmäßig auf Port 40080 aktiviert.
- Öffne Linken Sphere
- Stelle sicher, dass die Anwendung ausgeführt wird
- Die API ist automatisch unter http://localhost:40080 verfügbar
- Keine zusätzliche Konfiguration erforderlich — Linken Sphere API ist immer aktiviert
Wenn du den Standardport in den Linken Sphere-Einstellungen geändert hast, notiere ihn — du wirst ihn in Schritt 4 benötigen.
Schritt 2 — Ornold-Konto erstellen
Ornold ist die Brücke zwischen AI-Agenten und Anti-Detect-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
- Verifiziere deine E-Mail mit dem 6-stelligen Code, der an deinen Posteingang gesendet wurde
- Du landest im Dashboard — bereit für den nächsten Schritt
Schritt 3 — API-Token erstellen
Nach der Registrierung fordert dich das Dashboard auf, dein erstes API-Token zu erstellen. Dieses Token authentifiziert die MCP-Verbindung.
- Gib einen Namen für das Token ein (z. B. "Linken Sphere")
- Klicke auf "Erstellen"
- Kopiere das Token und speichere es an einem sicheren Ort — du wirst es im nächsten Schritt benötigen
Der kostenlose Plan umfasst 1 Slot, 5 CAPTCHA-Lösungen (nach dem Onboarding) und Zugriff auf Standard-Browser. Upgrade für mehr Kapazität.
Schritt 4 — MCP-Konfiguration über Setup-Assistent generieren
Das Ornold-Dashboard hat einen integrierten Verbindungsassistenten, der die genaue MCP-Konfiguration für dein Setup generiert. Keine manuelle Eingabe — wähle einfach deine Optionen und kopiere das Ergebnis.
Gehe zur Registerkarte "API Tokens" im Dashboard. Finde dein Token und klicke auf die Schaltfläche "Connect" daneben.
Assistentenschritt 1 — Wähle deinen AI-Agent
Der Assistent fragt, welchen AI-Agent du verwendest. Wähle deinen Agent aus der Liste (Claude Code, Cursor, Windsurf, Cline oder Codex). Jeder Agent erhält sein eigenes Konfigurationsformat.
Assistentenschritt 2 — Wähle Interaktionsmodus
Wähle, wie die KI mit Browser-Seiten interagieren soll:
- DOM-Modus (Standard) — KI liest HTML-Struktur. Jedes Element erhält einen [ref=N]-Marker. Kostenlos und schnell. Am besten für Formulare, strukturierte Seiten und Standard-Websites.
- Vision AI-Modus — KI macht einen Screenshot und findet Elemente visuell nach Aussehen. Funktioniert auf jeder Seite, einschließlich Canvas-Schnittstellen. Jede Analyse kostet 1 Vision-Guthaben.
- Beide Modi — Alle Tools verfügbar. KI wählt automatisch den besten Ansatz für jede Aktion.
Beginne mit DOM-Modus. Er ist kostenlos, schnell und bewältigt 90% der Aufgaben. Du kannst jederzeit zu "Beide Modi" wechseln, wenn du visuelle Analyse benötigst.
Assistentenschritt 3 — Linken Sphere aktivieren
Aktiviere Linken Sphere und fülle die Verbindungsdetails aus:
- API-Port (Standard: 40080) — verwende den Standard, es sei denn, du hast ihn in den Linken Sphere-Einstellungen geändert
Du kannst mehrere Browser gleichzeitig aktivieren. Die MCP-Konfiguration wird alle enthalten, und der AI-Agent kann jeden steuern, der ausgeführt wird.
Assistentenschritt 4 — Konfiguration kopieren und anwenden
Der Assistent generiert die endgültige Konfiguration basierend auf deinen Auswahlen. Für die meisten AI-Agenten hast du 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 wird danach jedes Mal automatisch mit deinem AI-Agent starten.
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 über Versionskontrolle mit deinem Team teilen möchtest, kopiere das JSON und speichere es als .mcp.json im Projektstammverzeichnis:
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--linken-port", "40080"]
}
}
}
Der Assistent füllt deine Token- und Portwerte automatisch aus — klicke einfach auf "Kopieren" und füge ein. Keine manuelle Bearbeitung erforderlich.
Verifiziere, dass der MCP-Server registriert ist:
claude mcp list
# You should see "ornold-browser" in the list
Schritt 5 — Starte Linken Sphere und teste
Bevor du deinen AI-Agent ausführst, stelle sicher, dass Linken Sphere offen ist und du mindestens eine Sitzung erstellt hast.
- Öffne Linken Sphere
- Stelle sicher, dass du mindestens eine Sitzung in der Liste hast
- Halte Linken Sphere im Hintergrund ausgeführt
Schritt 6 — Erster AI-Browser-Befehl
Alles ist verbunden. Starte deinen AI-Agent (Claude Code, Cursor, Windsurf oder Cline) und sprich mit ihm in natürlicher Sprache. Hier sind einige Befehle zum Einstieg:
# 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
Verfügbare MCP-Tools
Nach der Verbindung erhält dein AI-Agent Zugriff auf 40+ Browser-Automatisierungstools. Hier sind die am häufigsten verwendeten:
- browser_list — Liste alle verfügbaren Linken Sphere-Sitzungen auf
- browser_parallel_navigate — Öffne eine URL in allen aktiven Browsern
- browser_parallel_snapshot — Erhalte Seiten-DOM mit klickbaren [ref=N]-Markern
- browser_parallel_click — Klicke auf Elemente nach ref oder Selector
- browser_parallel_fill — Gib Text in Eingabefelder ein
- browser_parallel_screenshot — Mache Screenshots aller Sitzungen
- browser_parallel_vision_analyze_grouped — Visuelle Analyse von Seiten mit KI
- browser_solve_captcha — Löse automatisch reCAPTCHA, hCaptcha, Turnstile und mehr
- browser_parallel_evaluate — Führe JavaScript im Seitenkontext aus
- browser_status — Überprüfe, welche Sitzungen ausgeführt werden
Du musst Tool-Namen nicht auswendig lernen. Beschreibe einfach in einfacher Sprache, was du tun möchtest, und der AI-Agent wählt automatisch die richtigen Tools.
Linken Sphere Desktops
Linken Sphere organisiert Sitzungen in "Desktops" — isolierte Arbeitsbereiche, die verwandte Sitzungen gruppieren. Wenn du eine Sitzung über MCP startest, verwendet sie den aktuell aktiven Desktop in Linken Sphere.
Um zu steuern, welcher Desktop verwendet wird, wechsle in Linken Sphere zu ihm, bevor du AI-Befehle ausführst. Die MCP-Brücke respektiert deine aktive Desktop-Auswahl.
Interaktionsmodi
Ornold MCP unterstützt zwei Interaktionsmodi. Du hast einen während der Einrichtung ausgewählt:
DOM-Modus (Standard, kostenlos)
KI liest Seitenstruktur über DOM-Snapshots. Jedes Element erhält einen [ref=N]-Marker. Schnell und verbraucht keine Vision-Guthaben. Am besten für strukturierte Seiten mit klarem HTML.
Vision AI-Modus (bezahlt, pro Analyse)
KI macht einen Screenshot und nutzt visuelle Analyse, um Elemente nach Aussehen zu finden. Funktioniert auf jeder Seite, einschließlich komplexer SPAs oder Canvas-Schnittstellen. Jede Analyse kostet 1 Vision-Guthaben.
# Enable both modes:
claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --mode both --linken-port 40080
Fehlerbehebung
- "No sessions found" — Stelle sicher, dass Linken Sphere ausgeführt wird und du mindestens eine Sitzung erstellt hast.
- "Connection refused" — Verifiziere, dass die Portnummer (Standard: 40080) mit deinem Linken Sphere API-Port übereinstimmt. Stelle sicher, dass die Firewall localhost-Verbindungen nicht blockiert.
- "MCP server not found" — Führe `claude mcp list` aus, um zu überprüfen, dass ornold-browser registriert ist. Wenn nicht, führe den Setup-Befehl aus Schritt 4 erneut aus.
- "Permission denied (npm install)" — Auf macOS füge sudo-Präfix hinzu. Auf Windows führe PowerShell als Administrator aus.
- "Session launch timeout" — Linken Sphere kann beim ersten Ausführen langsam sein, um Sitzungen zu starten. Warte 10-15 Sekunden und versuche es erneut.
Was kommt als nächstes?
- Lese den Dolphin Anty-Automatisierungsleitfaden (/blog/dolphin-anty-mcp-setup) zum Vergleich mit einem anderen beliebten Anti-Detect-Browser
- Erfahre mehr über parallele Browser-Automatisierung (/blog/parallel-browser-automation) zum Ausführen von 10+ Sitzungen gleichzeitig
- Konsultiere den CAPTCHA-Lösungsleitfaden (/blog/captcha-solving-guide) für die Handhabung von reCAPTCHA, hCaptcha und Turnstile
- Erkunde den Vision AI-Modus (/blog/vision-vs-selectors) für die Interaktion mit komplexen visuellen Schnittstellen