Gologin MCP Server

GoLogin MCP Server für KI-Agenten

Verwalten Sie GoLogin-Browserprofile, Proxys, Fingerprints, Ordner und Cloud-Browser-Sitzungen über KI-Konversationen. Dieser Model Context Protocol (MCP)-Server verbindet Ihren KI-Client mit der GoLogin-API.

Schnellstart

Sie benötigen Node.js 22 oder neuer, ein aktives GoLogin-Konto und ein GoLogin-API-Token. Node.js 22 und 24 LTS wurden auf macOS Apple Silicon getestet.

1. Melden Sie sich bei Ihrem GoLogin-Konto an, öffnen Sie API & MCP und generieren Sie ein Token im API-Tab.
2. Fügen Sie diese Konfiguration zu Ihrem MCP-Client hinzu und ersetzen Sie den Token-Platzhalter. Fügen Sie sie in eine bestehende mcpServers-Konfiguration ein.

{
  "mcpServers": {
    "gologin-mcp": {
      "command": "npx",
      "args": ["-y", "gologin-mcp"],
      "env": {
        "API_TOKEN": "your-gologin-api-token-here"
      }
    }
  }
}

3. Starten Sie die MCP-Verbindung Ihres Clients neu oder laden Sie sie neu und fragen Sie dann: "Zeig mir meine GoLogin-Profile."

Der Client startet den Server automatisch. -y ermöglicht npm, das Paket ohne interaktive Bestätigung zu installieren. Dieser Server liest API_TOKEN; die GOLOGIN_TOKEN-Variable, die von anderen GoLogin-CLIs verwendet wird, ist hier kein Alias.

Für einen Terminal-Starttest, wenn API_TOKEN bereits in Ihrer Umgebung gesetzt ist:

npx -y gologin-mcp

Der Server kommuniziert über Standard-Eingabe/Ausgabe (stdio) und wartet auf einen MCP-Client. Er öffnet keinen Browser und bietet selbst keine interaktive Eingabeaufforderung.

Was Sie tun können

• Browserprofile erstellen, lesen, aktualisieren, löschen und organisieren.
• Profil-Proxys konfigurieren und Browser-Fingerprints aktualisieren.
• Ordner und deren Profilzugehörigkeit verwalten.
• Kontoinformationen lesen.
• Browserprofile in der GoLogin-Cloud starten und stoppen.

Der Cloud-Start gibt eine Verbindungs-URL zurück. Dieser Server bietet keine Werkzeuge für Seitennavigation, Klicks, Formularausfüllung oder lokale Orbita-Startfunktionen. Für Seitenautomatisierung verwenden Sie einen separaten Browser-Automatisierungsclient oder die GoLogin Agent Browser CLI.

Der MCP-Prozess läuft lokal; GoLogin-API-Anfragen und Cloud-Browser-Sitzungen erfordern Netzwerkzugriff. Cloud-Verfügbarkeit und API-Operationen hängen von Ihren Kontoberechtigungen und Ihrem Plan ab.

Werkzeuge

Werkzeugnamen werden aus der HTTP-Methode und dem Pfad in der GoLogin-OpenAPI-Spezifikation generiert, die der Server beim Start lädt. Das Folgende ist eine Auswahl verfügbarer Werkzeuge, keine feste Liste von Aliasen. Fragen Sie tools/list in Ihrem MCP-Client nach den aktuellen Namen und Eingabeschemata.

Werkzeug	Beschreibung
get_profile_v2	Profile auflisten und durchsuchen, mit Paginierung und Ordnerfiltern
post_profile_custom	Ein Profil mit Teileinstellungen wie Name, Betriebssystem und Proxy erstellen
get_profile_id	Ein Profil nach ID lesen
put_profile_id_custom	Ausgewählte Profileinstellungen aktualisieren
delete_profile	Die in profilesToDelete aufgeführten Profile löschen
patch_profile_proxy_many_v2	Proxys für ein oder mehrere Profile konfigurieren
patch_profile_fingerprints	Fingerprints für die in browsersIds aufgeführten Profile aktualisieren
get_proxy_v2	Proxys auflisten
get_folders	Ordner auflisten
post_folders_folder	Einen Ordner nach Namen erstellen
patch_folders_folder	Profile zu einem Ordner hinzufügen oder daraus entfernen
delete_folders_folder	Einen Ordner nach Namen löschen
post_profile_id_web	Ein Profil in der Cloud starten und eine Verbindungs-URL zurückgeben
delete_profile_id_web	Ein Cloud-Profil stoppen
get_user	Kontoinformationen lesen

Zum Beispiel kann ein MCP-Client diese tools/call-Anfrage senden, um ein Profil zu lesen:

{
  "name": "get_profile_id",
  "arguments": {
    "id": "your-profile-id"
  }
}

Argumente folgen dem Eingabeschema jedes Werkzeugs. Pfad- und Abfrageparameter sowie Anforderungstextfelder werden als Argumente auf oberster Ebene übergeben.

Beispiel-Prompts

• "Zeig mir meine GoLogin-Profile."
• "Erstelle ein Linux-Profil namens 'Research'."
• "Benenne Profil PROFILE_ID in 'Research US' um."
• "Aktualisiere Profil PROFILE_ID mit diesen Proxy-Einstellungen."
• "Aktualisiere den Fingerprint für Profil PROFILE_ID."
• "Erstelle einen Ordner namens 'Research' und füge Profil PROFILE_ID hinzu."
• "Starte Profil PROFILE_ID in der Cloud und gib mir die Verbindungs-URL."
• "Stoppe die Cloud-Sitzung für Profil PROFILE_ID."
• "Zeig mir meine GoLogin-Kontoinformationen."

Einrichtung für MCP-Clients

Claude Desktop

Öffnen Sie Einstellungen > Entwickler > Konfiguration bearbeiten und fügen Sie die Schnellstart-Konfiguration zu claude_desktop_config.json hinzu. Beenden Sie Claude Desktop vollständig und starten Sie es neu, dann prüfen Sie, ob gologin-mcp und seine Werkzeuge verfügbar sind.

Siehe die offizielle lokale MCP-Einrichtungsanleitung für Konfigurationspfade und Fehlerbehebung.

Cursor

Fügen Sie die Schnellstart-Konfiguration zu ~/.cursor/mcp.json für Ihr Benutzerkonto oder .cursor/mcp.json für ein Projekt hinzu. Laden Sie die MCP-Verbindung neu und aktivieren Sie die Werkzeuge des Servers. Halten Sie Konfigurationen mit API-Tokens aus der Versionskontrolle heraus.

Siehe Cursors MCP-Dokumentation für aktuelle Client-Einstellungen.

Andere MCP-Clients

Verwenden Sie einen Client, der lokale stdio-MCP-Server unterstützt. Konfigurieren Sie npx als Befehl, -y und gologin-mcp als dessen Argumente und API_TOKEN in der Serverumgebung. Das Konfigurationsformat und der Speicherort hängen vom Client ab.

Fehlerbehebung

• Server verbindet nicht: Prüfen Sie, ob Node.js und npx für den Client verfügbar sind, und starten Sie dann dessen MCP-Verbindung neu. Der Server benötigt auch Zugriff auf docs-download.gologin.com, um seine Werkzeugdefinitionen zu laden.
• API gibt 401 Unauthorized zurück: Prüfen Sie das API_TOKEN, das an den Server übergeben wurde, und die Gültigkeit des Tokens in GoLogin. Starten Sie die Verbindung nach einer Änderung neu.
• Werkzeugname nicht gefunden: Aktualisieren Sie die Werkzeugliste und verwenden Sie die von tools/list zurückgegebenen Namen; Namen wie list_profiles und start_browser sind keine eingebauten Aliase.
• Cloud-Start schlägt fehl: Prüfen Sie die API-Antwort und den Cloud-Zugriff Ihres Kontos. Der lokale MCP-Start startet Orbita nicht selbst auf Ihrem Computer.

Entwicklung

git clone https://github.com/gologinapp/gologin-mcp.git
cd gologin-mcp
npm ci
npm run build

Um Ihren lokalen Build mit bereits konfiguriertem API_TOKEN auszuführen:

node dist/index.js

Vor der Veröffentlichung ausführen:

npm run release:check

Das Paket enthält nur den gebauten Server, Paketmetadaten, README und Lizenz. Die Release-Prüfung verifiziert diese Whitelist, sodass lokale Zustände, Datenbanken, Anmeldedaten und Entwicklungsdateien nicht als zusätzliche Dateien enthalten sein können. npm publish führt dieselbe Prüfung automatisch aus.

MCP-Registry-Releases

server.json beschreibt diesen Server für die offizielle MCP-Registry unter io.github.gologinapp/gologin-mcp. Das npm-Paket deklariert dieselbe Kennung in mcpName.

Halten Sie die Versionen in package.json, package-lock.json und server.json synchron. Veröffentlichen Sie zuerst das geprüfte npm-Paket und führen Sie dann Publish to MCP Registry aus dem Actions-Tab des Repositorys auf main aus. Der Workflow verifiziert, dass die npm-Veröffentlichung die korrekte Registry-Kennung enthält, und authentifiziert sich über GitHub OIDC, ohne ein separates Registry-Token. Er veröffentlicht nicht auf npm.

Links

• GoLogin
• GoLogin-API-Dokumentation
• npm-Paket
• Glama-Verzeichnis

Lizenz

MIT, Urheberrecht GoLogin.