Codex CLI mit Guard.ch verbinden
Richte den Browser-Zugriff einmal ein. Danach kannst du Codex CLI im Chat Browser-Aufgaben geben oder eine laufende Session weitergeben.
Das brauchst du
Ein Guard.ch-Konto mit freigeschaltetem MCP-Zugang und einen App-Schlüssel aus diesem Konto. Dein Agent erhält Zugriff auf deine eigenen Sessions.
Installiere Codex CLI und melde dich an. Nutze für die Befehle unten Bash oder Zsh (macOS, Linux oder WSL).
1. App-Schlüssel erstellen
Öffne die Agenten-Seite im Dashboard und wähle «Schlüssel erstellen». Gib ihm einen Namen, zum Beispiel den deines Agenten. Kopiere den Schlüssel, bevor du das Fenster schliesst. Er wird nur einmal angezeigt.
Schlüssel erstellen2. Guard.ch in Codex CLI hinzufügen
Führe beide Befehle im selben Terminal aus und ersetze YOUR_API_KEY. Der erste stellt den Schlüssel bereit, der zweite richtet Guard.ch ein.
export GUARDCH_API_KEY="YOUR_API_KEY"
codex mcp add guardch --url https://api.guard.ch/mcp \
--bearer-token-env-var GUARDCH_API_KEYErsetze YOUR_API_KEY durch deinen eigenen Schlüssel, bevor du speicherst.
Bei einer JSON-Konfiguration: Falls du bereits andere MCP-Server nutzt, ergänze nur den Eintrag guardch unter mcpServers. Behalte deine anderen Einträge.
3. Verbindung prüfen
Starte codex aus demselben Terminal und prüfe den Server mit /mcp. Sende den Auftrag unten. Stelle GUARDCH_API_KEY auch dann bereit, wenn du später aus einem neuen Terminal startest.
Öffne example.com in einem Guard.ch-Browser und sag mir, was auf der Seite steht.Die Verbindung funktioniert, wenn dein Agent einen Guard.ch-Browser öffnet und den Seiteninhalt zurückgibt. Unter «Agenten» im Dashboard findest du die Session und kannst live zuschauen.
Eine offene Session weitergeben
Öffne in deinem Guard.ch-Viewer «An Agenten weitergeben». Kopiere den vorbereiteten Auftrag in den Chat deines verbundenen Agenten. Er enthält die Session-ID, damit dein Agent genau dort weitermacht. Nutze einen Schlüssel aus demselben Konto.
Falls es nicht klappt
Bei einem Anmeldefehler fehlt dem Codex-Prozess möglicherweise GUARDCH_API_KEY. Exportiere die Variable in diesem Terminal und starte Codex erneut. Mit codex mcp list prüfst du die Konfiguration.
Bei einem Anmeldefehler prüfst du, ob der App-Schlüssel noch gültig ist. Bei fehlendem Zugriff prüfst du deinen MCP-Zugang im Dashboard. Die Verbindung wird in deinem Agenten geprüft, Guard.ch kann dessen Einrichtung nicht automatisch erkennen.
Dein App-Schlüssel erlaubt Zugriff auf deine Sessions. Füge ihn nur in den Einstellungen deines Agenten ein, nie in einen Chat oder eine geteilte Datei. Unter Apps kannst du ihn widerrufen.