Doku › Für Entwickler

KI-Assistent (MCP)

Verbinde ProntoSite mit Claude Desktop und arbeite direkt im Chat: Status abfragen, deine Website als Datei sichern, eine neue Version hochladen und veröffentlichen – ganz ohne Terminal. Verfügbar ab dem Starter-Plan.

Technisch ist der MCP-Server ein dünner Client auf die Deploy-API – dieselben Aktionen, nur per Zuruf statt per curl.

Schritt für Schritt #

  1. Claude Desktop installieren und anmelden.
  2. Token erzeugen – im Dashboard unter Konto → API-Zugang auf Token erzeugen klicken und den Schlüssel (beginnt mit psk_) kopieren. Er wird nur einmal angezeigt.
  3. Verbindungs-Snippet einfügen – im selben Panel steht unter „Mit KI-Assistent verbinden (MCP)" ein fertiges Textstück mit deiner Website. Kopiere es und füge es in Claude Desktop ein unter Einstellungen → Entwickler → Konfiguration bearbeiten. Ersetze DEIN_TOKEN durch deinen Schlüssel:
{
  "mcpServers": {
    "prontosite": {
      "command": "npx",
      "args": ["-y", "@prontosite/mcp"],
      "env": { "PRONTOSITE_TOKEN": "DEIN_TOKEN", "PRONTOSITE_SITE": "active" }
    }
  }
}

PRONTOSITE_SITE: "active" nimmt einfach deine aktive Website – der robusteste Wert. Das Panel trägt hier alternativ deine feste Website-Kennung ein; die bleibt gleich, selbst wenn sich deine Adresse ändert. 4. Claude Desktop neu starten – fertig. Danach kennt der Assistent deine Website. Probiere es aus:

  • „Wie ist der Status meiner Website?"
  • „Exportiere die veröffentlichte Website als ZIP nach ~/Downloads."
  • „Lade diese Datei hoch und veröffentliche sie." (der Assistent fragt vor dem Veröffentlichen nach)

Windows (Claude Desktop) #

Unter Windows sind ein paar Details anders als auf macOS:

  1. Konfigurationsdatei: %APPDATA%\Claude\claude_desktop_config.json. Am schnellsten per Win + R → %APPDATA%\Claude eingeben → Enter; die Datei dort öffnen (bzw. anlegen).
  2. npx.cmd statt npx: Auf Windows heißt der Starter npx.cmd:
{
  "mcpServers": {
    "prontosite": {
      "command": "npx.cmd",
      "args": ["-y", "@prontosite/mcp"],
      "env": { "PRONTOSITE_TOKEN": "DEIN_TOKEN", "PRONTOSITE_SITE": "active" }
    }
  }
}
  1. Doppelte Backslashes in Pfaden: In JSON muss jeder Backslash verdoppelt werden – z. B. "C:\\Program Files\\nodejs\\npx.cmd". Ein einfacher \ führt zu einem Parse-Fehler.
  2. Claude Desktop komplett beenden – über die Taskleiste: Das Fenster zu schließen reicht nicht; Claude läuft im Hintergrund weiter und liest die Config nicht neu. Rechtsklick auf das Claude-Symbol in der Taskleiste (unten rechts, ggf. unter „^") → Beenden, dann neu starten.

Troubleshooting: „spawn … failed" / „spawn npx.cmd ENOENT" #

Der Fehler heißt: Windows findet npx.cmd im PATH des Claude-Prozesses nicht.

  • Prüfe, dass Node.js installiert ist (node --version in der Eingabeaufforderung).
  • Trag den absoluten Pfad zu npx.cmd als command ein (mit doppelten Backslashes), z. B. "command": "C:\\Program Files\\nodejs\\npx.cmd". Den Pfad findest du mit where npx.cmd in der Eingabeaufforderung.
  • Danach Claude Desktop wie oben über die Taskleiste beenden und neu starten.

Sicherheit #

🔒 Behandle den Schlüssel wie ein Passwort. Wer ihn hat, kann deine Website veröffentlichen. Verrate ihn niemandem und trage ihn nicht in den Chat ein. Bei Verdacht im Dashboard (Konto → API-Zugang) widerrufen und einen neuen erzeugen – das geht jederzeit. Die schreibenden Aktionen (Deploy, Veröffentlichen) sind so eingerichtet, dass der Assistent vor dem Ausführen rückfragt.

Mehrere Websites betreuen? #

Betreust du viele Kundenseiten, kannst du sie alle in einem Claude Desktop verwalten – mit je einem Schlüssel pro Website. Am übersichtlichsten ist ein Chat je Kunde. „Zeig mir alle meine Websites" nennt dir jederzeit die Liste. Jeder Schlüssel gilt nur für seine eigene Website – geht einer verloren, sind die anderen unberührt. Für Agenturen gibt es zusätzlich ein konto-übergreifendes Betreuer-Token (siehe Deploy-API).

Zuletzt aktualisiert: