Einen MCP-Client mit Guard.ch verbinden

Gib einem KI-Agenten über einen gehosteten Model-Context-Protocol-Endpunkt einen echten, isolierten Chrome-Browser.

Das Guard.ch-TeamProduktrecherche23. Juli 2026

Guard.ch betreibt einen gehosteten Streamable-HTTP-MCP-Server. Claude Code, Cursor, VS Code, Windsurf, Codex CLI, Gemini CLI und andere Clients mit Unterstützung für Authentifizierungs-Header verbinden sich mit einer URL und erhalten 21 Browser-Werkzeuge.

Du musst weder einen lokalen Browser-Dienst noch einen Modell-API-Schlüssel einrichten. Dein Client bringt das Modell mit; Guard.ch stellt den isolierten Browser, verwaltet die Sitzung und ermöglicht bei Bedarf die Übergabe an einen Menschen.

Was du brauchst

Endpunkt: https://api.guard.ch/mcp
Transport: Streamable HTTP
Authentifizierung: Ein Guard.ch-App-Key
Plan: Jeder aktive Guard.ch-Plan
Gleichzeitige Nutzung: Eine laufende Browser-Sitzung pro Planplatz

Endpunkt und Authentifizierung

Verbinde deinen Client mit diesem einzelnen MCP-Endpunkt:

https://api.guard.ch/mcp

Übermittle einen Guard.ch-App-Key in einem dieser Header. Schlüssel in URLs werden abgewiesen, damit sie weder im Browserverlauf noch in Proxy-Logs oder Analysedaten landen:

Authorization: Bearer YOUR_API_KEY als Bearer-Token im Authorization-Header (empfohlen)
x-api-key: YOUR_API_KEY in einem x-api-key-Header

Client verbinden

Wähle das passende Beispiel und ersetze YOUR_API_KEY durch einen App-Key aus deinem Dashboard. Clients ohne Authentifizierungs-Header unterstützt der App-Key-Endpunkt nicht.

Claude Code

claude mcp add --transport http guardch https://api.guard.ch/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "guardch": {
      "url": "https://api.guard.ch/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code

code --add-mcp '{"name":"guardch","type":"http","url":"https://api.guard.ch/mcp","headers":{"Authorization":"Bearer YOUR_API_KEY"}}'

Windsurf (~/.codeium/windsurf/mcp_config.json)

{
  "mcpServers": {
    "guardch": {
      "serverUrl": "https://api.guard.ch/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Codex CLI

codex mcp add guardch --url https://api.guard.ch/mcp \
  --bearer-token-env-var GUARDCH_API_KEY

Gemini CLI

gemini mcp add --transport http guardch https://api.guard.ch/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Verfügbare Werkzeuge

Der Server stellt 21 Werkzeuge mit strukturierten Ergebnissen und Sicherheitshinweisen bereit. Dein Agent kann direkt mit browser_navigate beginnen: Guard.ch legt automatisch eine Sitzung an und liefert einen Snapshot mit ref-Ids für die nächsten Interaktionen.

Sitzungen verwalten

Werkzeug	Beschreibung
`browser_create_session`	Startet wiederholungssicher eine Sitzung mit optionalem Timeout, Bildschirmgrösse, Exit-Standort, Proxy oder Start-URL.
`browser_list_sessions`	Listet aktive Sitzungen mit ihren Ids und Live-View-URLs auf.
`browser_stop_session`	Beendet eine Sitzung und gibt ihren gleichzeitigen Browser-Platz frei.
`browser_get_usage`	Zeigt die aktuelle Belegung und die Sitzungssummen der letzten 30 Tage.

Seite steuern

Werkzeug	Beschreibung
`browser_navigate`	Öffnet eine URL und legt bei Bedarf automatisch eine Sitzung an.
`browser_navigate_back`	Kehrt zur vorherigen Seite zurück.
`browser_snapshot`	Liefert einen barrierefreien Snapshot mit ref-Ids.
`browser_click`	Klickt ein Element über seine Snapshot-Ref an.
`browser_type`	Tippt in ein Eingabefeld und sendet auf Wunsch mit Enter ab.
`browser_press_key`	Drückt eine einzelne Taste wie Enter oder Escape.
`browser_hover`	Bewegt den Mauszeiger über ein Element mit Snapshot-Ref.
`browser_scroll`	Scrollt um eine Pixelzahl oder bringt ein Element ins Blickfeld.
`browser_wait_for`	Wartet auf Text, eine URL, einen Ladezustand oder das Verschwinden eines Texts.
`browser_handle_dialog`	Bestätigt oder verwirft den nächsten Browserdialog.
`browser_select_option`	Wählt Einträge in einem Auswahlfeld aus.
`browser_screenshot`	Erstellt einen JPEG-Screenshot des sichtbaren Bereichs oder der ganzen Seite.
`browser_evaluate`	Führt JavaScript auf der Seite aus und liefert das Ergebnis.
`browser_tab_new`	Öffnet einen neuen Tab.
`browser_tab_select`	Wechselt zu einem anderen Tab.
`browser_tab_close`	Schliesst einen Tab.
`browser_tab_list`	Listet Tabs mit stabilen Ids, Titeln und URLs auf.

So verhalten sich Sitzungen

Automatisch starten. Der erste Aufruf eines Seiten-Werkzeugs legt eine Sitzung an, falls für diesen App-Key noch keine läuft. Sind für den Schlüssel mehrere Sitzungen aktiv, verlangt Guard.ch eine session_id, statt willkürlich eine auszuwählen.
Automatisch aufräumen. Eine Sitzung endet zwei Minuten nach dem letzten Werkzeug-Aufruf oder CDP-Disconnect, spätestens aber beim absoluten Timeout. Mit browser_stop_session beendest du sie früher.
An Menschen übergeben. Über die Live-View-URL kannst du zuschauen oder mit Maus und Tastatur übernehmen, etwa für eine Anmeldung oder ein Captcha.
Standort wählen. Wähle ein Exit-Land oder eine Stadt, oder leite den Browser über deinen eigenen Proxy.
Eine Sitzung pro Planplatz. Jeder Planplatz enthält einen gleichzeitigen Browser-Platz. Solange dieser belegt ist, wird eine weitere Sitzung abgelehnt und nicht in eine Warteschlange gestellt.

REST- und CDP-Zugriff

Dieselben Browser-Sitzungen kannst du auch ohne MCP nutzen. Erstelle und verwalte sie über die Guard.ch-API und verbinde Playwright oder Puppeteer danach mit dem zurückgelieferten CDP-Websocket.

POST /v8/web/sessions erstellt wiederholungssicher eine Sitzung mit optionaler Bildschirmgrösse und liefert connectUrl sowie liveViewUrl
GET /v8/web/sessions listet aktive Sitzungen auf; status=all zeigt die 30-Tage-Historie
DELETE /v8/web/sessions/:id beendet eine Sitzung
GET /v8/web/usage liefert Nutzung und gleichzeitige Belegung

Dieses Beispiel erstellt eine Sitzung. Übergib ihre connectUrl danach wie gezeigt an Playwright.

curl -X POST https://api.guard.ch/v8/web/sessions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"timeout":900,"country":"us","screen":{"width":1440,"height":900},"idempotencyKey":"task-123"}'

const browser = await chromium.connectOverCDP(session.connectUrl);

Nächste Schritte

Erstelle unter Apps einen Schlüssel, füge den Endpunkt in deinem Client hinzu und lass ihn eine Seite öffnen. Brauchst du Hilfe mit einem Client oder einer grösseren Einführung, kontaktiere uns.