@prontosite/mcp 0.16.0 → 0.18.0

package/CHANGELOG.md

@@ -3,6 +3,20 @@
 Alle nennenswerten Änderungen am MCP-Server für ProntoSite. Der Server ist ein dünner Client um die
 ProntoSite Deploy-API; die eigentliche Logik lebt serverseitig.
 
+## 0.18.0 – 2026-11-06
+
+- Neu: `site_badge_set` (`aktiv`, `variant` = auto | light | dark | mono) blendet das Badge „Made with ProntoSite" für die ganze Website aus oder ein und
+  setzt die Variante, auf allen Tarifen. Normale Entwurfsänderung mit einem Rückgängig-Schritt, Auto-Publish-Regeln gelten. Ohne eingebautes Badge liefert die
+  Antwort `warnung` und `snippet`.
+- `site_status`: neues Feld `badge` (`aktiv`, `variant`, `eingebaut`, `seiten`, `sichtbar`). Instructions 2d: Ausblenden nur über `site_badge_set`, nie per CSS oder HTML.
+
+## 0.17.0 – 2026-11-05
+
+- JS-Freigabe-Pflicht für Änderungen entfällt (Entscheidung 05.11.): Auf Websites mit JavaScript-Freigabe wirkt jede JS-Änderung sofort wie HTML/CSS,
+  auch Umbenennen. `jsReview` in Antworten und `site_status` entfällt, neu ist `jsExtern` bei neuer externer Adresse im Skript
+  („Externe Einbindung erkannt, Datenschutzerklärung prüfen").
+- `site_js_review` zeigt nur noch den Verlauf (lesend, Betreuer-Token); Parameter `path`, `action`, `note` entfallen. Instructions 2e angepasst.
+
 ## 0.16.0 – 2026-11-03
 
 - Formular-Anfragen per MCP (Scope `anfragen` bzw. `anfragen:schreiben`, beim Verbinden ein eigener, nie vorausgewählter Punkt;

package/README.md

@@ -101,6 +101,7 @@ sichern: `cp ~/.prontosite.json ~/.prontosite.json.bak`).
 | `site_embed_consent({ site?, host, page?, category, confirmed })` | Einbettung als `notwendig` (§ 25 Abs. 2 Nr. 2 TDDDG, Eigenverantwortung) oder wieder `gated` einstufen; `notwendig` nur mit `confirmed:true` (sonst 400 mit Verantwortungs-Text). Optional seiten-gebunden. Datenschutz/Cookie-Richtlinie passen sich beim nächsten Publish an. **Schreibend.** |
 | `site_widgets({ site? })` | Katalog der verwalteten Widgets: name, aktiv, optionen, schema (consent, a11y, notice/Pop-Ups, google-reviews, ps-impressum, ps-datenschutz). In jedem Plan verfügbar. **Lesend.** |
 | `site_widget_set({ site?, widget, aktiv?, optionen? })` | Widget aktivieren/deaktivieren und Optionen setzen – gleicher Schema-Sanitizer wie das Dashboard; Listen-Widgets (notice) via `optionen.items[]`. Greift beim nächsten Publish. Siehe [Widget-Katalog](https://prontosite.io/docs/widget-katalog). **Schreibend.** |
+| `site_badge_set({ site?, aktiv?, variant? })` | Badge „Made with ProntoSite" für die ganze Website aus-/einblenden und Variante setzen (`auto` \| `light` \| `dark` \| `mono`), auf allen Tarifen. Stand steht in `site_status.badge`. |
 
 `site_deploy` und `site_publish` sind **schreibende** Aktionen (verändern die Live-Website). Die
 Tool-Beschreibungen weisen den Assistenten an, vorher rückzufragen. Jeder Aufruf wird serverseitig auditiert.

package/api.mjs

@@ -303,6 +303,18 @@ export async function apiWidgetSet(cfg, { site, widget, aktiv, optionen } = {},
   return asJson(res);
 }
 
+/** PUT /api/badge/<site> {aktiv?, variant?} – Badge ein-/ausblenden, Variante setzen (dieselbe Op wie das Dashboard). */
+export async function apiBadgeSet(cfg, { site, aktiv, variant } = {}, fetchImpl = fetch) {
+  if (aktiv === undefined && variant === undefined) throw new Error("aktiv oder variant erwartet.");
+  const { token, slug } = resolveTarget(cfg, site);
+  const body = {};
+  if (aktiv !== undefined) body.aktiv = !!aktiv;
+  if (variant !== undefined) body.variant = variant;
+  const res = await fetchImpl(`${baseUrl(cfg)}/badge/${encodeURIComponent(slug)}`, {
+    method: "PUT", headers: { ...authHeaders(token, cfg), "content-type": "application/json" }, body: JSON.stringify(body) });
+  return asJson(res);
+}
+
 /** GET/PUT /api/legal-options/<site> – Anzeige-Optionen der Rechtstext-Widgets. Ohne impressum/datenschutz
  *  nur LESEN; sonst Teil-Update (nur echte Booleans wirken). */
 export async function apiLegalOptions(cfg, { site, impressum, datenschutz } = {}, fetchImpl = fetch) {
@@ -600,12 +612,10 @@ export async function apiLock(cfg, { site, action = null, note = null } = {}, fe
   return asJsonOr409(await fetchImpl(url, { method: "POST", headers: { ...authHeaders(token, cfg), "content-type": "application/json" }, body: JSON.stringify({ action, note }) }));
 }
 
-/** GET/POST /api/js-review/<site> – JS-Prüfungen (nur Betreuer-Token): ohne action Liste + Diff, sonst approve|reject. */
-export async function apiJsReview(cfg, { site, path: rel = null, action = null, note = null } = {}, fetchImpl = fetch) {
+/** GET /api/js-review/<site> – Verlauf der JS-Änderungen (nur lesen, nur Betreuer-Token). */
+export async function apiJsReview(cfg, { site } = {}, fetchImpl = fetch) {
   const { token, slug } = resolveTarget(cfg, site);
-  const url = `${baseUrl(cfg)}/js-review/${encodeURIComponent(slug)}`;
-  if (!action) return asJson(await fetchImpl(url, { headers: authHeaders(token, cfg) }));
-  return asJson(await fetchImpl(url, { method: "POST", headers: { ...authHeaders(token, cfg), "content-type": "application/json" }, body: JSON.stringify({ path: rel, action, note }) }));
+  return asJson(await fetchImpl(`${baseUrl(cfg)}/js-review/${encodeURIComponent(slug)}`, { headers: authHeaders(token, cfg) }));
 }
 
 /** GET /api/inbox/<site> – Formular-Anfragen: Liste (Filter), eine Anfrage (id) oder Statistik (stats). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prontosite/mcp",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "description": "MCP-Server für ProntoSite – Website-Status, Export, Deploy und Veröffentlichen direkt aus einem KI-Assistenten (Claude Desktop). Dünner Client um die ProntoSite Deploy-API.",
   "type": "module",
   "bin": {

package/tools.mjs

@@ -9,7 +9,7 @@
  *                site_domain_connect nur mit Betreuer-Token (Entscheidung 9a).
  * `z` wird vom Aufrufer übergeben (dieselbe zod-Instanz wie sein MCP-SDK).
  */
-import { apiEditText, apiEditHtml, apiPageTexts, apiPageTextsSet, apiPageCopy, apiMediaUploadBegin, apiMediaUploadFile, apiMediaCommit, apiMediaList, apiImageSet, apiUndo, apiMediaDelete, apiMediaRestore, apiFormsGet, apiFormsSet, apiMediaSearch, apiMediaImport, apiPreviewScreenshot, apiStatus, apiExport, apiExportFetch, apiDeploy, apiPublish, sitesList, apiAccountCreate, apiCompanyGet, apiCompanySet, apiLegalOptions, apiDomainStatus, apiDomainConnect, apiEmbeds, apiEmbedConsent, apiWidgets, apiWidgetSet, apiFiles, apiFileGet, apiFilePut, apiFileDelete, apiFileRename, apiLock, apiJsReview, apiInboxGet, apiInboxPost } from "./api.mjs";
+import { apiEditText, apiEditHtml, apiPageTexts, apiPageTextsSet, apiPageCopy, apiMediaUploadBegin, apiMediaUploadFile, apiMediaCommit, apiMediaList, apiImageSet, apiUndo, apiMediaDelete, apiMediaRestore, apiFormsGet, apiFormsSet, apiMediaSearch, apiMediaImport, apiPreviewScreenshot, apiStatus, apiExport, apiExportFetch, apiDeploy, apiPublish, sitesList, apiAccountCreate, apiCompanyGet, apiCompanySet, apiLegalOptions, apiDomainStatus, apiDomainConnect, apiEmbeds, apiEmbedConsent, apiWidgets, apiWidgetSet, apiBadgeSet, apiFiles, apiFileGet, apiFilePut, apiFileDelete, apiFileRename, apiLock, apiJsReview, apiInboxGet, apiInboxPost } from "./api.mjs";
 
 /**
  * Arbeitsweise (MCP-`instructions` beim Initialize – lokal UND /mcp): Weg B ist der Standard (Nick 19.10.).
@@ -29,18 +29,19 @@ const instructionLines = mode => [
   "2a. Für Text-, Link- und Kontaktdaten-Änderungen (Telefonnummer, E-Mail, Adresse, Öffnungszeiten) IMMER site_edit_text mit "
     + "scope:\"all\" (bei Bedarf region:\"footer\"/\"header\") – EIN Aufruf für alle Seiten, inkl. tel:/mailto:-Links. NIE Seite für Seite per "
     + "site_file_put. Meldet die Antwort company, zusätzlich site_company_set für die Firmendaten (Impressum/Datenschutz/Kontakt).",
-  "2e. Preise, Texte und Zahlen in Skriptdateien (.js, z. B. Preisrechner) ändert site_edit_text mit scope:\"all\" mit – ersetzt wird dort "
-    + "nur in Texten/Zahlen/Kommentaren, nie im Code. Nur-Zahlen/Texte-Änderungen wirken sofort; alles andere prüft der Betreuer. Meldet eine "
-    + "Antwort jsReview.status \"pending\" (bzw. site_status jsReview.pending), dem Nutzer sagen: Änderung gespeichert, sie wartet auf Freigabe "
-    + "durch den Betreuer, der Betreuer ist benachrichtigt – bis dahin läuft auf der Website der bisherige Stand. Nicht erneut versuchen und "
-    + "nicht umgehen (z. B. nicht ins HTML verlagern).",
+  "2e. Skriptdateien (.js): Preise, Texte und Zahlen darin (z. B. Preisrechner) ändert site_edit_text mit scope:\"all\" mit – ersetzt wird dort "
+    + "nur in Texten/Zahlen/Kommentaren, nie im Code; für Code-Änderungen site_file_get/site_file_put. Bei JavaScript-Freigabe der Website wirkt "
+    + "jede Änderung sofort wie HTML/CSS, es gibt keine Prüfung und keine Wartezeit. Meldet eine Antwort jsExtern (\"Externe Einbindung erkannt, "
+    + "Datenschutzerklärung prüfen\"), dem Nutzer das sagen und die genannten Adressen nennen: die Änderung ist gespeichert, die Datenschutzerklärung "
+    + "muss er selbst prüfen. Ohne JavaScript-Freigabe der Website kommt 403: dem Nutzer sagen, dass der Betreuer JavaScript für die Website einmalig freigeben muss.",
   "2c. Für Markup über alle Seiten (z. B. Footer-HTML) site_edit_html mit scope:\"all\" (ggf. region:\"footer\"), nie Seite für Seite per site_file_put. "
     + "Entwurfs-Limit je Website: 300 Änderungen je Stunde, davon 30 direkt hintereinander (Kunden und Betreuer gleich) – dieselbe Änderung auf vielen Seiten ist EIN Aufruf (site_edit_text scope:\"all\" bzw. site_edit_html). Bei 429 (rateLimited) NICHT aufgeben: retryAfter Sekunden warten, dann weitermachen; bisherige Änderungen bleiben gespeichert.",
   "2d. Badge „Made with ProntoSite\" NUR als dieses Snippet einbauen (Footer, letzte Zeile, bündig mit dem Copyright), nie manuell stylen: "
     + "<a data-ps=\"badge\" data-ps-variant=\"auto\" href=\"https://prontosite.io/?ref=badge&amp;site=<slug>\" rel=\"noopener noreferrer\">Made with ProntoSite</a> "
     + "(Variante auto | light für dunkle Footer | dark für helle Flächen | mono). Der Server ersetzt beim Ausliefern alles außer der Variante "
     + "(Schrift, Größe, Farbe, Icon). Ein vorhandenes Badge nie im HTML ändern, nachbauen oder entfernen (site_edit_text/site_edit_html/"
-    + "site_file_put lehnen das ab; erlaubt ist nur das Wiederherstellen des Original-Markers).",
+    + "site_file_put lehnen das ab; erlaubt ist nur das Wiederherstellen des Original-Markers). Badge ausblenden nur über site_badge_set, nie per CSS oder HTML; "
+    + "dasselbe Tool ändert die Variante für die ganze Website. Stand: badge in site_status.",
   "2b. Für Übersetzungen und Textüberarbeitung: site_page_texts → Texte übersetzen/überarbeiten → site_page_texts_set, JE SEITE ein Aufruf "
     + "(neue Sprachfassung vorher mit site_page_copy, z. B. index.html → en/index.html). NIE HTML über site_file_put umschreiben. "
     + "Rechtstext-Seiten (Impressum/Datenschutz) sind ausgenommen.",
@@ -82,7 +83,7 @@ export const SERVER_INSTRUCTIONS = instructionsFor("remote");
 // Tool-Annotationen (MCP ToolAnnotations): ChatGPT & Co. fragen sonst bei JEDEM Aufruf nach. readOnly = ändert nichts;
 // destructive = live/kundenwirksam, ersetzt Bestand oder nimmt zurück (Bestätigung sinnvoll). Entwurfs-Änderungen sind
 // rückgängig machbar und daher nicht destruktiv. openWorld = wirkt nach außen (öffentliche Website/DNS).
-const READ_ONLY = new Set(["sites_list", "site_status", "site_forms_get", "media_search", "site_page_texts", "site_media_list", "site_preview_screenshot", "site_company_get",
+const READ_ONLY = new Set(["site_js_review", "sites_list", "site_status", "site_forms_get", "media_search", "site_page_texts", "site_media_list", "site_preview_screenshot", "site_company_get",
   "site_domain_status", "site_embeds", "site_widgets", "site_files", "site_file_get", "site_inbox_list", "site_inbox_get", "site_inbox_stats"]);
 const DESTRUCTIVE = new Set(["site_publish", "site_deploy", "deploy_commit", "site_file_delete", "site_media_delete", "site_inbox_delete", "site_undo", "site_redo", "site_domain_connect"]);
 const OPEN_WORLD = new Set(["site_publish", "site_deploy", "deploy_commit", "site_domain_connect", "media_search", "media_import"]);
@@ -203,7 +204,7 @@ export function registerTools(server0, { z, cfg, mode = "local", remote = null }
       + "scope:\"all\" = alle Fundstellen auf allen Seiten sofort ersetzen (für Kontaktdaten im Kopf-/Fußbereich: plus region:\"footer\" bzw. "
       + "\"header\"); ohne scope ändert der Server bei mehr als einer Fundstelle NICHTS und liefert nur die Liste (oder pages:[…]). "
       + "Mit scope:\"all\" auch in Skriptdateien (.js, z. B. Preisrechner) – dort nur in Texten/Zahlen/Kommentaren (skripte = Fundstellen); "
-      + "jsReview.status \"pending\" = wartet auf Freigabe durch den Betreuer (dem Nutzer sagen). "
+      + "jsExtern = neue externe Adresse im Skript (dem Nutzer sagen: Datenschutzerklärung prüfen). "
       + "Telefonnummern werden unabhängig von Schreibweise gefunden (Leerzeichen, „/“, „-“, Klammern, geschütztes Leerzeichen); ersetzt "
       + "wird wörtlich durch `replace`. Antwort: treffer = getrennt nach text/linktext/linkziel/attribut; linktextNichtGefunden = tel:-Ziel "
       + "geändert, sichtbarer Linktext aber nicht (dem Nutzer sagen). pages = je Seite gefunden/geändert. Rechtstexte und geschützte Bereiche bleiben unberührt (skipped); steht der Wert in "
@@ -628,19 +629,14 @@ export function registerTools(server0, { z, cfg, mode = "local", remote = null }
       }
     );
   }
-  // JS-Prüfungen entscheiden (nur Betreuer-Token; der Server prüft die Rolle zusätzlich).
+  // JS-Verlauf lesen (nur Betreuer-Token; der Server prüft die Rolle zusätzlich).
   if (mode === "local" || remote?.isManager) {
     server.tool(
       "site_js_review",
-      "NUR BETREUER-TOKEN: ausstehende Prüfungen von Skript-Änderungen (JS) einer Website. Ohne action: Liste mit Gründen und Zeilen-Diff "
-        + "(freigegebener Stand → Entwurf; lesend). action='approve' gibt die Änderung frei (danach normaler Publish bzw. mit der nächsten "
-        + "Veröffentlichung), action='reject' setzt die Datei auf den freigegebenen Stand zurück (note = Grund, sieht der Kunde). Nur freigeben, "
-        + "was im Diff verstanden ist; im Zweifel ablehnen oder den Nutzer fragen.",
-      { site: z.string().optional().describe(SITE_DESC),
-        path: z.string().optional().describe("Datei (z. B. 'js/rechner.js') – für approve/reject Pflicht."),
-        action: z.enum(["approve", "reject"]).optional().describe("Leer = nur ansehen."),
-        note: z.string().optional().describe("Notiz/Grund (bei reject sinnvoll).") },
-      async ({ site, path, action, note }) => { try { return asText(await apiJsReview(cfg, { site, path, action, note })); } catch (e) { return asError(e); } }
+      "LESEND, NUR BETREUER-TOKEN: Verlauf der Änderungen an Skriptdateien (JS) einer Website – Zeit, Datei, von wem, Art (werte | code | neu) "
+        + "und neu eingebundene externe Adressen (extern). Reine Information: Änderungen wirken sofort, es gibt nichts freizugeben.",
+      { site: z.string().optional().describe(SITE_DESC) },
+      async ({ site }) => { try { return asText(await apiJsReview(cfg, { site })); } catch (e) { return asError(e); } }
     );
   }
   server.tool(
@@ -698,12 +694,25 @@ export function registerTools(server0, { z, cfg, mode = "local", remote = null }
     }
   );
 
+  server.tool(
+    "site_badge_set",
+    "SCHREIBEND (normale Entwurfsänderung, ein Rückgängig-Schritt, Auto-Publish-Regeln gelten): Badge „Made with ProntoSite\" für die ganze Website "
+      + "ein-/ausblenden und/oder die Variante setzen. Auf allen Tarifen möglich. DER einzige Weg zum Ausblenden: nie per CSS oder HTML. Beim Ausblenden bleibt "
+      + "der Marker im Quelltext, ausgeliefert wird ein verstecktes leeres Element; einen eigenen Trennstrich davor im Footer entfernt das nicht. "
+      + "Einbauen kann dieses Tool nicht: Meldet die Antwort eingebaut:false, das gelieferte snippet mit site_edit_html in die letzte Footer-Zeile setzen.",
+    { site: z.string().optional().describe(SITE_DESC),
+      aktiv: z.boolean().optional().describe("true = einblenden, false = ausblenden. Weglassen = unverändert."),
+      variant: z.enum(["auto", "light", "dark", "mono"]).optional().describe("Variante für alle Seiten (übersteuert data-ps-variant): auto = Textfarbe des Footers, light für dunkle Footer, dark für helle Flächen, mono = Icon einfarbig. Weglassen = unverändert.") },
+    async ({ site, aktiv, variant }) => {
+      try { return asText(await apiBadgeSet(cfg, { site, aktiv, variant })); } catch (e) { return asError(e); }
+    }
+  );
+
   // ---- Datei-API: kleine Änderungen am Entwurf direkt auf dem Server (Konzept §7) ----
   const FILE_SMALL = "STANDARDWEG: Änderungen direkt am Server-Entwurf (für reine Textänderungen am einfachsten site_edit_text); "
     + "Export + Deploy nur als Ausnahme für größere Umbauten oder auf ausdrücklichen Wunsch. "
-    + "Skriptdateien (JavaScript) nur bei JavaScript-Freigabe der Website; Kunden-Änderungen daran prüft der Server: nur Zahlen/Texte/"
-    + "Kommentare → wirkt sofort, sonst gespeichert, aber erst nach Freigabe durch den Betreuer live (Antwort jsReview.status \"pending\" – "
-    + "dem Nutzer so sagen). Preise/Texte in Skripten besser mit site_edit_text scope:\"all\". ";
+    + "Skriptdateien (JavaScript) nur bei JavaScript-Freigabe der Website; dann wirkt jede Änderung sofort wie HTML/CSS. Neue externe Adresse im "
+    + "Skript → Antwort jsExtern (dem Nutzer sagen: Datenschutzerklärung prüfen). Preise/Texte in Skripten besser mit site_edit_text scope:\"all\". ";
   server.tool(
     "site_files",
     "LESEND: Listet die Dateien des Entwurfs einer Website (Pfad, Größe, Typ, ob bearbeitbar) und die aktuelle draftRev. "