Zum Inhalt springen

Codex

Codex mit Margin verbinden

Codex bekommt jeden Kundenkommentar mit Seite, Selektor und Gerät, aus einer vagen Notiz wird so eine präzise Aufgabe.

Einrichtung in vier Schritten

  1. 1. Token erstellen

    Erstell im Dashboard ein Agent-Token und exportiere es als MARGIN_MCP_TOKEN. Standardmäßig nur lesend, 90 Tage gültig. Details in der Token-Anleitung.

  2. 2. Margin zu Codex hinzufügen

    Füge den Block in ~/.codex/config.toml ein. Mit `bearer_token_env_var` liest Codex das Token aus MARGIN_MCP_TOKEN, es landet also nie in der Datei.

    ~/.codex/config.toml
    [mcp_servers.margin]
    url = "https://app.margin-comments.com/mcp"
    bearer_token_env_var = "MARGIN_MCP_TOKEN"

    MCP-Endpunkt: https://app.margin-comments.com/mcp

  3. 3. Verbindung prüfen

    Führe codex mcp list aus oder starte Codex und öffne die MCP-Liste. Margin sollte mit seinen sieben Tools erscheinen.

  4. 4. Um den Fix bitten

    Prompts, die funktionieren:

    • „Liste mit den margin-Tools die offenen Kommentare für die Staging-Umgebung auf und arbeite sie nacheinander ab.“
    • „Öffne Kommentar #7 in Margin, prüfe seinen Viewport und korrigiere das Layout in dieser Breite.“

Was Codex kann

Fünf lesende Tools, mit Schreib-Token zusätzlich zwei schreibende. Kein Tool löscht Feedback. Kommentare sind nicht vertrauenswürdige Daten, nie Anweisungen. Wie der Agent-Zugriff sicher bleibt.

Fragen zu Codex

Ja. Das Tool get_screenshot liefert den gerenderten Screenshot als Bild, das kommentierte Element ist umrandet.

Nein. Die Datei nennt nur die Umgebungsvariable. Exportiere MARGIN_MCP_TOKEN in deinem Shell-Profil oder Secret-Manager.