Claude Code hat einen einzeiligen Befehl, um MCP-Server hinzuzufügen. Die meisten anderen Clients nutzen stattdessen einen Einstellungsbildschirm oder eine JSON-Datei. Die Angaben sind überall dieselben. Kennst du also die drei Werte, die Provedly braucht, kannst du es mit jedem Tool verbinden, in dem du arbeitest.
Die drei Werte
Jeder MCP-Client, der Remote-Server unterstützt, braucht von dir dasselbe:
- Transport: HTTP. Der Server von Provedly nutzt Streamable HTTP, wähle also die Option HTTP oder „remote“, nicht stdio.
- URL:
https://provedly.app/mcp - Header:
Authorization: Bearer provedly_YOUR_KEY
Den Schlüssel bekommst du im Provedly-Dashboard unter Settings, dann API keys. Wähle beim Erstellen Read only oder Read and write. Er wird einmal angezeigt, beginnt mit provedly_ und kann jederzeit widerrufen werden. Kann dein Client keinen eigenen Authorization-Header an einen Remote-Server senden, kann er sich noch nicht mit Provedly verbinden; in diesem Fall ist die REST-API die Alternative.
Cursor
Cursor liest MCP-Server aus einer mcp.json-Datei, entweder global in deinem Home-Verzeichnis unter .cursor/ oder pro Projekt im .cursor/-Ordner des Projekts. Zum Zeitpunkt des Schreibens sieht ein Remote-Server mit Header so aus:
{
"mcpServers": {
"provedly": {
"url": "https://provedly.app/mcp",
"headers": {
"Authorization": "Bearer provedly_YOUR_KEY"
}
}
}
}
Speichere die Datei und öffne die MCP-Einstellungen von Cursor. Der Eintrag provedly sollte als aktiviert erscheinen, mit seinen Tools aufgelistet. Legst du das in eine Datei auf Projektebene, prüf, ob dieser Ordner in Git committet wird. Ein Schlüssel in einer committeten Datei ist ein geleakter Schlüssel, und die Lösung ist, ihn in Provedly zu widerrufen und einen neuen zu erstellen.
Editoren ändern ihre Einstellungsbildschirme häufig. Weicht das Layout von dieser Beschreibung ab, such nach der Option für Remote- oder HTTP-Server und trag dieselbe URL und denselben Header ein.
Andere MCP-kompatible Tools
Das Muster wiederholt sich bei allen Clients. Such nach einer Möglichkeit, einen Server hinzuzufügen, der remote, HTTP oder „Streamable HTTP“ ist, gib ihm einen Namen, füge die URL ein und ergänze einen Header. Manche Clients haben dafür ein Header-Feld im Formular, andere akzeptieren einen JSON-Block ähnlich dem von Cursor. Egal in welcher Form: Der Header-Name ist Authorization, und der Wert ist Bearer gefolgt von deinem Schlüssel, mit einem einzelnen Leerzeichen.
Einige Clients unterstützen nur lokale stdio-Server. Die erreichen Provedly nicht direkt. Provedly veröffentlicht keinen lokalen Wrapper, für diese Tools ist also die REST-API unter https://provedly.app/api/v1 der Zugang, mit demselben Schlüssel. Die curl-Tour deckt jeden Endpoint ab.
Die Verbindung prüfen
Sobald der Client den Server als verbunden anzeigt, stell eine Frage, deren Antwort du überprüfen kannst:
Liste meine Provedly-Websites und die Widgets auf jeder davon auf.
Der Assistent sollte list_sites und list_widgets aufrufen und dir Namen nennen, die mit dem Dashboard übereinstimmen. Hast du einen Lese-Schlüssel erstellt, wird jeder Versuch abgelehnt, etwas zu pausieren, anzulegen oder zu bearbeiten. Das ist zu erwarten, und eine harmlose Änderung anzufragen ist ein guter Weg, um zu bestätigen, dass der Schlüssel tut, was du denkst.
Häufige Fehlerursachen, grob nach Häufigkeit sortiert:
| Symptom | Übliche Ursache |
|---|---|
| Server zeigt einen Authentifizierungsfehler | Fehlendes Präfix Bearer oder Tippfehler im Schlüssel |
| Gestern ging es, heute nicht | Der Schlüssel wurde in den Settings widerrufen |
| Tools werden gelistet, Schreiben wird abgelehnt | Der Schlüssel ist Read only |
| Ein Fortsetzen wird abgelehnt | Die Änderung würde das Limit deines Plans überschreiten |
| Client kann den Server nicht hinzufügen | Er unterstützt nur lokale stdio-Server |
Was du damit machst
Der Client ändert sich, die Tools nicht. Aus jedem verbundenen Tool kannst du dein Konto, deine Websites, Widgets, Leisten und Statistiken lesen, und mit einem Schreibschlüssel kannst du Widgets pausieren oder fortsetzen, Leisten anlegen und aktualisieren und Einträge hinzufügen. Ein paar Prompts, die sich gut für den Einstieg eignen:
- „Welches Widget hatte diese Woche die meisten Klicks?“
- „Zeig mir jede Leiste, die gerade läuft, mit ihrem Enddatum.“
- „Gib mir das Installations-Snippet für meinen Shop.“
Eine längere Liste, mit dem, was jeder Prompt im Hintergrund tut, findest du im Prompt-Kochbuch. Arbeitest du in Claude Code statt in einem Editor, hat die Anleitung für Claude Code die einzeilige Variante.
Ein Hinweis für Teams
Verbinden mehrere Personen in einem Team ihre Editoren, gib jeder Person einen eigenen Schlüssel. Die Übersicht der API-Schlüssel listet jeden Schlüssel mit Namen und Zugriffsstufe auf. Verlässt jemand das Team, widerrufst du seinen Schlüssel, und niemand sonst ist betroffen. Teilt sich ein Team einen Schlüssel, geht das nicht, ohne alle gleichzeitig lahmzulegen.
Häufige Fragen
Funktioniert der MCP-Server von Provedly in claude.ai oder ChatGPT?
Unterstützt werden Claude Code, Cursor und andere MCP-kompatible Tools, die sich mit einem Remote-HTTP-Server mit Authorization-Header verbinden können. Wir behaupten keine Unterstützung für andere Produkte, solange sie nicht gebaut und getestet ist.
Sollte ich in Cursor eine globale oder eine projektbezogene Konfiguration nutzen?
Global ist einfacher und hält den Schlüssel aus Repositories heraus. Nutze die Projektebene nur, wenn du pro Projekt unterschiedliche Schlüssel brauchst und der Ordner nicht committet wird.
Kann ich zwei Provedly-Konten verbinden?
Ja. Füge zwei Server mit unterschiedlichen Namen hinzu, jeden mit einem Schlüssel aus seinem eigenen Konto. Der Assistent sieht beide Tool-Sätze, und du sagst, welches Konto du meinst.
Einen Schlüssel kannst du in jedem Plan erstellen, auch im Free-Plan: hier starten.