Diese Anleitung bringt dich von „kein Schlüssel“ zu einer funktionierenden Provedly-Verbindung in Claude Code. Sie setzt voraus, dass du bereits ein Provedly-Konto mit mindestens einer Website hast und Claude Code in einem Terminal installiert ist. Das Ganze besteht aus einem Schlüssel, einem Befehl und einem Test-Prompt.
Hast du die Übersicht noch nicht gelesen, erklärt der Launch-Beitrag, was der MCP-Server kann und was nicht.
Schritt 1: Account-API-Schlüssel erstellen
Öffne im Provedly-Dashboard Settings und dann API keys. Wähle Create key, gib ihm einen Namen, den du später wiedererkennst, etwa „Claude Code auf meinem Laptop“, und wähle eine Zugriffsstufe.
- Read only lässt Claude dein Konto, deine Websites, Widgets, Leisten und Statistiken ansehen.
- Read and write lässt es außerdem Widgets pausieren und fortsetzen, Leisten anlegen und bearbeiten und Einträge hinzufügen.
Probierst du das zum ersten Mal aus, beginne mit Read only. Einen zweiten Schlüssel kannst du später jederzeit erstellen. Der Schlüssel beginnt mit provedly_ und wird einmal angezeigt, kopiere ihn also, bevor du den Dialog schließt. Verlierst du ihn, widerrufe ihn und erstelle einen neuen; er lässt sich nicht noch einmal anzeigen.
Schritt 2: Den Server hinzufügen
Führe in einem Terminal aus:
claude mcp add --transport http provedly https://provedly.app/mcp \
--header "Authorization: Bearer provedly_YOUR_KEY"
Ersetze provedly_YOUR_KEY durch den Schlüssel, den du gerade kopiert hast. Die Teile des Befehls:
| Teil | Was er tut |
|---|---|
--transport http |
Der Server von Provedly nutzt Streamable HTTP |
provedly |
Der Name, unter dem Claude Code diesen Server zeigt |
https://provedly.app/mcp |
Die Serveradresse |
--header "..." |
Sendet deinen Schlüssel mit jeder Anfrage |
Claude Code speichert das in seiner MCP-Konfiguration. Behandle diese Konfiguration wie eine .env-Datei: Sie enthält jetzt ein Secret. Fügst du den Server im Projektbereich hinzu und committest die Konfiguration, geht der Schlüssel mit. Bei einem geteilten Repository bleib also im Benutzerbereich oder halte den Schlüssel aus der Versionskontrolle heraus.
Schritt 3: Die Verbindung prüfen
Starte Claude Code und führe /mcp aus. Du solltest provedly mit Status „connected“ in der Liste sehen und darunter die Provedly-Tools: get_account, list_sites, list_widgets, list_bars, get_stats, get_install_snippet und, mit einem Schreibschlüssel, set_widget_status, set_bar_status, create_bar, update_bar und add_record.
Zeigt der Server einen Fehler, sind die üblichen Ursachen ein Tippfehler im Schlüssel, ein fehlendes Präfix Bearer im Header oder ein widerrufener Schlüssel. Widerrufene Schlüssel schlagen sofort fehl, und genau das willst du.
Schritt 4: Ein erster Prompt
Frag etwas, das nur Lesezugriff braucht und dessen Antwort du mit dem Dashboard abgleichen kannst:
Welchen Plan habe ich, und wie viel meiner Impressionen für diesen Monat habe ich verbraucht?
Claude sollte get_account aufrufen und mit deinem Plan, seinen Limits und dem aktuellen Verbrauch antworten. Öffne das Dashboard und vergleiche. Stimmen die Zahlen, funktioniert die Verbindung.
Ein zweiter guter Test sind die Statistiken:
Wie viele Bestellungen haben meine Widgets in den letzten 30 Tagen unterstützt?
Das ruft get_stats auf und meldet die durch Proof unterstützten Bestellungen und den Umsatz für den Zeitraum. Die Definition einer unterstützten Bestellung ist dieselbe wie im Dashboard, beschrieben in durch Proof unterstützte Bestellungen messen.
Schritt 5: Vorsichtig eine Änderung ausprobieren
Probier mit einem Schlüssel mit Lese- und Schreibzugriff etwas, das sich leicht rückgängig machen lässt:
Pausiere die Leiste namens „Free shipping“ und sag mir, was sich geändert hat.
Claude listet typischerweise deine Leisten auf, findet die passende, ruft set_bar_status auf und meldet den neuen Zustand. Claude Code fragt dich nach einer Freigabe für Tool-Aufrufe, sofern du sie nicht erlaubt hast, und diesen Freigabeschritt solltest du für alles, was schreibt, eingeschaltet lassen. Lies den Tool-Aufruf, bevor du ihn freigibst: Er nennt die Leiste und die Aktion.
Setz sie auf dieselbe Weise fort. Bittest du darum, etwas fortzusetzen, das dich über das Limit deines Plans bringen würde, wird die Anfrage abgelehnt, und Claude sagt dir, warum. Es ist dieselbe Ablehnung, die auch das Dashboard ausgibt.
Ordnung halten
Ein paar Gewohnheiten, die helfen, sobald das Teil deiner Routine wird:
- Ein Schlüssel pro Rechner oder pro Tool, klar benannt, damit der Widerruf eines Schlüssels die anderen nicht lahmlegt.
- Lese-Schlüssel überall dort, wo du nur Berichte willst. Mehr dazu in Lese- vs. Schreibschlüssel.
- Widerrufe Schlüssel, die du nicht mehr nutzt. Die Übersicht der API-Schlüssel listet sie alle auf.
Bittest du Claude, eine Leiste anzulegen, rechne damit, dass sie pausiert zurückkommt. Neue Leisten aus der API oder MCP starten immer so, damit du zuerst Wortlaut und Daten prüfen kannst; Claude zu sagen, dass es sie einschalten soll, ist der zweite Schritt.
Bist du bereit für mehr, hat das Prompt-Kochbuch Beispiele für jedes Tool.
Häufige Fragen
Kann ich denselben Schlüssel in Claude Code und in einem Skript verwenden?
Ja, ein Schlüssel funktioniert sowohl für den MCP-Server als auch für die REST-API. Getrennte Schlüssel sind trotzdem einfacher zu verwalten, weil du einen widerrufen kannst, ohne den anderen anzufassen.
Was passiert, wenn ich den Server aus Claude Code entferne?
Claude Code ruft Provedly nicht mehr auf, und an deinem Konto ändert sich nichts. Der Schlüssel bleibt gültig, bis du ihn in den Settings widerrufst, also widerrufe ihn, wenn du ihn nicht mehr brauchst.
Sieht Claude die persönlichen Daten meiner Kunden?
Es sieht, was die Tools zurückgeben: Kontodetails, Websites, Widgets, Leisten und Statistiken und, beim Hinzufügen eines Eintrags, den Eintrag, den du hinzufügen lässt. Behandle die Sitzung wie jeden anderen Ort, an dem Geschäftsdaten durchlaufen.
Konten und Schlüssel sind zum Start kostenlos: hier registrieren.