Zum Inhalt springen

MCP ​

prevju hat einen MCP-Server unter <APP_URL>/mcp. Damit legen Claude Code oder Codex Sites an, laden Entwürfe hoch und geben dir den Kundenlink.

Verbinden ​

Die MCP-Seite im prevju-Admin: Befehl zum Einrichten und Tokens

Leg im Admin unter API & MCP ein Token an. Dasselbe Token gilt auch für die REST-API. Die Seite erzeugt den Befehl mit deinem Token, für Claude Code oder Codex, für alle Projekte oder nur das aktuelle.

Claude Code (--scope user für alle Projekte, --scope local für das aktuelle):

bash
claude mcp add --transport http --scope user prevju https://preview.example.com/mcp --header "Authorization: Bearer <token>"

Codex: das hier in ~/.codex/config.toml (alle Projekte) oder in .codex/config.toml eines vertrauenswürdigen Projekts eintragen. Die Projektdatei gehört nicht ins Git, sie enthält das Token.

toml
[mcp_servers.prevju]
url = "https://preview.example.com/mcp"
http_headers = { "Authorization" = "Bearer <token>" }

Ein Token hat dieselben Rechte wie der Admin-Login. Leg pro Gerät eins an, dann kannst du sie einzeln widerrufen.

Tools ​

ToolWas es macht
get-compatibilityLiefert Was funktioniert. Agenten rufen es vor dem Hochladen auf
list-sites, get-siteSites mit Link, Passwortstatus und Dateien
create-siteNeue Site, optional mit Passwort und in einem Projekt
update-siteUmbenennen, Passwort setzen oder entfernen, in ein Projekt verschieben oder herausnehmen
list-projects, create-projectProjekte: ein Kunden-Link für mehrere Sites
write-filesGenerierte Textdateien (HTML, CSS, JS) direkt schreiben
get-upload-urlSignierte URL für 15 Minuten, um eine ZIP oder Binärdatei mit curl hochzuladen
list-visitsOb und wann der Kunde eine Site oder ein Projekt geöffnet hat, siehe Aufrufe
delete-file, clear-files, delete-siteDestruktiv, ohne Rückgängig

Für eine neue Version eines Entwurfs laden Agenten mit replace hoch: Die Live-Site wechselt in einem Schritt und ist zwischendurch nie leer. Ein fehlgeschlagener Upload ändert nichts. Sollen Versionen für den Kunden nebeneinander stehen, legen Agenten jede Version als eigene Site in einem Projekt an.

Grenzen ​

  • ZIPs und andere Binärdateien gehen per curl an eine signierte URL, dafür braucht der Client eine Shell (Claude Code, Codex).
  • Connectors in claude.ai und Claude Desktop brauchen OAuth, das prevju noch nicht unterstützt.