Die meisten Änderungen an einem Social-Proof-Setup sind klein. Die Black-Friday-Leiste pausieren, weil der Sale vorbei ist. Einen Launch-Countdown um einen Tag verschieben. Prüfen, ob die Toasts der letzten Woche jemandem beim Kauf geholfen haben. Für jede davon musstest du bisher das Dashboard öffnen, die richtige Website finden, die richtige Leiste finden und dich durch ein Formular klicken. Ab heute kannst du sie mit einem Satz anfragen, aus dem KI-Tool, das du ohnehin offen hast.
Provedly liefert jetzt drei Dinge, die zusammenspielen: Account-API-Schlüssel, eine REST-API für dein ganzes Konto und einen MCP-Server, mit dem Claude Code, Cursor und andere MCP-kompatible Tools sprechen können. Alle drei sind in jedem Plan verfügbar, auch im Free-Plan.
Was du aus einem Chat heraus tun kannst
Sobald der MCP-Server verbunden ist, sieht dein Assistent dein Konto so wie das Dashboard und kann innerhalb der Grenzen deines Schlüssels darauf handeln. In der Praxis heißt das Prompts wie diese:
- „Pausiere die Black-Friday-Leiste.“
- „Erstelle eine Countdown-Leiste für unseren Winter-Launch mit Ende am 1. Dez. um 9 Uhr.“
- „Wie viele Bestellungen haben meine Widgets in den letzten 30 Tagen unterstützt?“
- „Welches Widget hatte diese Woche die meisten Klicks?“
- „Gib mir das Installations-Snippet für meinen Shop.“
Hinter jedem davon ruft der Assistent ein Provedly-Tool auf: list_bars und set_bar_status für den ersten, create_bar für den zweiten, get_stats für die nächsten beiden, get_install_snippet für den letzten. Du siehst den Tool-Aufruf und das Ergebnis.
Beim zweiten Prompt ist ein Detail wichtig. Eine aus dem Chat angelegte Leiste startet pausiert, damit du sie ansehen kannst, bevor irgendein Besucher sie sieht. Der Livegang ist ein eigener Schritt: Sag „sieht gut aus, schalte sie ein“, und der Assistent ruft set_bar_status auf, um sie zu aktivieren, wobei wie im Dashboard das Leistenlimit deines Plans gilt. Das Pausieren und Fortsetzen bestehender Leisten und Widgets wirkt sofort.
Die vollständige Tool-Liste lautet get_account, list_sites, list_widgets, list_bars, get_stats, set_widget_status, set_bar_status, create_bar, update_bar, add_record und get_install_snippet. Beispiele zu jedem findest du im Prompt-Kochbuch.
Account-API-Schlüssel
Alles beginnt mit einem Schlüssel. In den Settings, im Bereich API keys, erstellst du einen und wählst eine Zugriffsstufe: Read only oder Read and write. Schlüssel beginnen mit provedly_, werden beim Erstellen einmal angezeigt und lassen sich jederzeit auf demselben Bildschirm widerrufen.
Ein Lese-Schlüssel kann dein Konto, deine Websites, Widgets, Leisten und Statistiken ansehen. Ändern kann er nichts. Ein Schlüssel mit Lese- und Schreibzugriff kann außerdem Widgets pausieren und fortsetzen, Leisten anlegen und bearbeiten und Einträge hinzufügen. Soll ein Assistent nur Fragen zur Performance beantworten, gib ihm einen Lese-Schlüssel und belass es dabei. Die Abwägungen stehen in Lese- vs. Schreibschlüssel.
Die REST-API
Derselbe Schlüssel funktioniert mit einer schlichten HTTP-API unter https://provedly.app/api/v1, gesendet als Authorization: Bearer provedly_…. Sie deckt dein Konto (Plan, Limits und Verbrauch), Websites, Widgets, Leisten und Statistiken ab, dazu das Anlegen und Bearbeiten von Leisten und das Pausieren oder Fortsetzen von Widgets. Die bestehende Records-API zum Hinzufügen von Käufen akzeptiert jetzt ebenfalls einen Account-Schlüssel, ein Backend braucht also keinen eigenen Schlüssel pro Widget mehr.
Willst du lieber selbst skripten, statt über einen Assistenten zu gehen, zeigt die curl-Tour jeden Endpoint mit einer echten Anfrage.
Claude Code verbinden
Der MCP-Server liegt unter https://provedly.app/mcp und nutzt Streamable HTTP. In Claude Code ist es ein Befehl:
claude mcp add --transport http provedly https://provedly.app/mcp \
--header "Authorization: Bearer provedly_YOUR_KEY"
Cursor und andere MCP-Clients nehmen dieselbe URL und denselben Header in ihren Server-Einstellungen. Schritt-für-Schritt-Anleitungen: Einrichtung in Claude Code und Cursor und andere Clients.
Dieselben Regeln wie im Dashboard
Ein mit Provedly verbundener Assistent kann nichts tun, was du nicht auch selbst im Dashboard tun könntest, und an einigen Stellen kann er weniger.
Plan-Limits gelten. Erlaubt dein Plan zwei aktive Widgets und du bittest darum, ein drittes fortzusetzen, wird die Anfrage mit derselben Begründung abgelehnt, die auch das Dashboard nennen würde. Lese-Schlüssel können nur lesen, ohne Ausnahme.
Vor allem kann der Assistent niemals einen Eintrag als verifiziert markieren. Ein Eintrag erhält die Kennzeichnung „Verifiziert“ nur, wenn er über einen signierten Webhook von Stripe, Shopify oder WooCommerce ankommt und die Signatur stimmt. Über die API hinzugefügte Einträge, ob von deinem Backend oder von einem Assistenten über add_record, erscheinen mit einem sichtbaren „Imported“-Label und ohne die Kennzeichnung „Verifiziert“, und deine öffentliche Verifizierungsseite führt sie unter „Site owner's backend (API)“. Diese Grenze ist der Grund, warum es Provedly gibt, und eine KI anzuschließen verschiebt sie nicht. Die Überlegung dahinter steht in warum dein Assistent keinen Kauf verifizieren kann.
Ein Snippet pro Website, wird gerade ausgerollt
Ein weiteres Teil rollen wir parallel dazu aus: ein einziges Website-Snippet, /w/site.js, das jedes aktive Widget und jede aktive Leiste einer Website lädt. Ist es installiert, wirkt das Ein- und Ausschalten einer Leiste aus Claude direkt auf der Seite, ohne Codeänderung auf deiner Seite. Es läuft gerade als Pilot, die Details stehen in das einzeilige Website-Snippet.
Häufige Fragen
Brauche ich einen bezahlten Plan, um die API oder den MCP-Server zu nutzen?
Nein. Account-API-Schlüssel, die REST-API und der MCP-Server sind in jedem Plan verfügbar, auch im Free-Plan. Die üblichen Limits deines Plans für Widgets, Leisten und Impressionen gelten weiterhin.
Mit welchen KI-Tools funktioniert es?
Mit Claude Code, Cursor und anderen MCP-kompatiblen Tools, die sich mit einem HTTP-MCP-Server mit eigenem Authorization-Header verbinden können. Spricht dein Tool kein MCP, deckt die REST-API dasselbe ab.
Kann der Assistent Dinge ändern, um die ich nicht gebeten habe?
Er kann nur die Tools aufrufen, die du siehst, mit der Zugriffsstufe des Schlüssels, den du ihm gegeben hast. Nutze einen Lese-Schlüssel, wenn Fragen beantwortet, aber nichts geändert werden soll, und widerrufe den Schlüssel in den Settings, wenn du ihn nicht mehr nutzt.
Zum Ausprobieren erstelle ein kostenloses Konto, leg in den Settings einen Schlüssel an und verbinde ihn mit dem Assistenten, den du schon nutzt.