Zum Inhalt springen

Claude Code, Codex, Cursor und andere Agents per Token verbinden

Ein Token pro Website, nur lesend, und die Konfiguration für sechs Coding-Agents.

Etwa 4 Minuten · 4 Schritte · KI-Agents

  1. Einen Agent-Token anlegen

    Öffne KI-Agenten und wähle Agenten-Token erstellen. Kopiere den Token einmal, denn Margin speichert nur einen Hash davon. Ein Token erreicht eine Website, ist nur lesend, solange du Schreiben nicht erlaubst, und läuft nach 90 Tagen ab.

  2. Als MARGIN_MCP_TOKEN speichern

    Leg den Token in eine Umgebungsvariable auf deinem Rechner. Füge ihn nicht in eine Konfigurationsdatei ein, die du committest, und nie in deine Website.

    Shell
    export MARGIN_MCP_TOKEN="margin_..."

  3. Margin zu deinem Agent hinzufügen

    Jeder Agent hat seinen eigenen Weg, einen Bearer-Header zu senden, ohne den Token in die Datei zu schreiben. Nimm den Block für deinen.

    Claude Code: Terminal
    claude mcp add --transport http margin \
  https://app.margin-comments.com/mcp \
  --header "Authorization: Bearer $MARGIN_MCP_TOKEN"
    Codex: ~/.codex/config.toml
    [mcp_servers.margin]
url = "https://app.margin-comments.com/mcp"
bearer_token_env_var = "MARGIN_MCP_TOKEN"
    Cursor: .cursor/mcp.json
    {
  "mcpServers": {
    "margin": {
      "url": "https://app.margin-comments.com/mcp",
      "headers": { "Authorization": "Bearer ${env:MARGIN_MCP_TOKEN}" }
    }
  }
}
    GitHub Copilot: .vscode/mcp.json
    {
  "inputs": [
    { "type": "promptString", "id": "margin-token", "description": "Margin token", "password": true }
  ],
  "servers": {
    "margin": {
      "type": "http",
      "url": "https://app.margin-comments.com/mcp",
      "headers": { "Authorization": "Bearer ${input:margin-token}" }
    }
  }
}
    Windsurf: ~/.codeium/windsurf/mcp_config.json
    {
  "mcpServers": {
    "margin": {
      "serverUrl": "https://app.margin-comments.com/mcp",
      "headers": { "Authorization": "Bearer ${env:MARGIN_MCP_TOKEN}" }
    }
  }
}
    Gemini CLI: ~/.gemini/settings.json
    {
  "mcpServers": {
    "margin": {
      "httpUrl": "https://app.margin-comments.com/mcp",
      "headers": { "Authorization": "Bearer $MARGIN_MCP_TOKEN" }
    }
  }
}

  4. Den Agent die Projekte auflisten lassen

    Ein guter erster Prompt: „Nutze die Margin-Tools, liste meine Projekte und zeige die offenen Kommentare.“ Wenn der Agent deine Website sieht, funktioniert die Verbindung.

Gut zu wissen

  • Lese-Tools: list_projects, list_comments, get_comment, get_screenshot, get_asset und show_feedback für das Board in Claude. Schreib-Tools, nur mit Schreibzugriff: add_reply, update_comment und resolve_comments. Agenten im Terminal bekommen die Kommentare als Text.
  • Claude Code kann sich auch wie die Claude-App ohne Token anmelden: Führe „claude mcp add --transport http margin https://app.margin-comments.com/mcp“ aus, tippe dann in Claude Code /mcp und melde dich an. Diese Verbindung erreicht den Workspace, den du wählst.
  • Kein Token kann Feedback löschen, Projekte anlegen oder ändern, welche Seiten das Widget laden dürfen.
  • Widerrufe einen Token jederzeit unter KI-Agenten. Er funktioniert ab der nächsten Anfrage nicht mehr.

Als Nächstes

Zurück zum Help Center. Noch kein Konto?