@prontosite/mcp 0.8.0 → 0.9.1

package/CHANGELOG.md

@@ -3,6 +3,23 @@
 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.9.0 – 2026-09-27
+
+- **Neu: `site_widgets`** (lesend) – Katalog der verwalteten Widgets einer Website inkl. `aktiv`, `optionen`
+  und `schema` je Widget (consent, a11y, notice/Pop-Ups, google-reviews, ps-impressum, ps-datenschutz).
+- **Neu: `site_widget_set`** (schreibend) – Widget aktivieren/deaktivieren und Optionen setzen, mit DEMSELBEN
+  Schema-Sanitizer wie das Dashboard (ungültige Felder werden abgewiesen). Listen-Widgets (notice) via
+  `optionen.items[]`. So läuft z. B. „Aktiviere das Pop-up auf der Startseite mit diesem Text, einmal je 3 Tage"
+  per Zuruf. Ergänzt `site_legal_options`/`site_embed_consent`, ersetzt sie nicht. Betreuer-Token für betreute
+  Kunden. Greift beim nächsten Veröffentlichen.
+
+## 0.8.1 – 2026-09-26
+
+- **Marker-Kurzverweis in den Tool-Beschreibungen** von `site_deploy` und `site_legal_options`: Wer ein
+  Template lokal baut, sieht jetzt direkt die Marker-Syntax (`data-ps="formular:kontakt"`,
+  `data-ps="impressum"`/`"datenschutz"`, `data-ps="link-impressum"`/`"link-datenschutz"` für Footer-Links)
+  plus Link auf die Referenz https://prontosite.io/docs/marker-shortcodes – ohne dass der Nutzer sie nachschlagen muss.
+
 ## 0.8.0 – 2026-09-23
 
 - **Neu: `site_embeds`** – listet alle externen Einbettungen (Host, Seite(n), Kategorie `gated`/`notwendig`). Lesend.

package/README.md

@@ -84,15 +84,17 @@ sichern: `cp ~/.prontosite.json ~/.prontosite.json.bak`).
 | `sites_list` | Alle erreichbaren Websites (Slug, Plan, letzte Änderung, Publish-Bedarf). **Lesend.** |
 | `site_status({ site? })` | Plan, Slug, Live-URL, Publish-Bedarf. **Lesend.** |
 | `site_export({ site?, which, outDir })` | ZIP (`published`\|`draft`\|`original`) lokal speichern. **Lesend.** |
-| `site_deploy({ site?, zipPath, publish?, resetOverlay?, legal?, company?, siteOverride? })` | ZIP importieren, optional live; optional Firmendaten im selben Aufruf setzen. **Schreibend.** |
+| `site_deploy({ site?, zipPath, publish?, resetOverlay?, legal?, company?, siteOverride? })` | ZIP importieren, optional live; optional Firmendaten im selben Aufruf setzen. Beim lokalen Bauen Bausteine im HTML per `data-ps` markieren (`formular:kontakt`, `impressum`/`datenschutz`, `link-impressum`/`link-datenschutz`) → [Marker-Syntax](https://prontosite.io/docs/marker-shortcodes). **Schreibend.** |
 | `site_publish({ site? })` | Aktuellen Stand erneut veröffentlichen. **Schreibend.** |
 | `site_company_get({ site? })` | Firmendaten (Impressum/Footer) lesen. **Lesend.** |
 | `site_company_set({ site?, company, siteOverride? })` | Firmendaten setzen/ergänzen (Teil-Update); füllen Impressum/Datenschutz beim Deploy. **Schreibend.** |
-| `site_legal_options({ site?, impressum?, datenschutz? })` | Anzeige-Optionen der Rechtstexte (showTitle, showDate, draftNotice); ohne Rolle nur lesen. **Schreibend.** |
+| `site_legal_options({ site?, impressum?, datenschutz? })` | Anzeige-Optionen der Rechtstexte (showTitle, showDate, draftNotice); ohne Rolle nur lesen. Rechts-Seiten/-Links im Template per `data-ps="impressum"`/`"datenschutz"` bzw. `link-impressum`/`link-datenschutz` markieren → [Marker-Syntax](https://prontosite.io/docs/marker-shortcodes). **Schreibend.** |
 | `site_domain_status({ site?, check? })` | Kundendomain-Status (verbunden/kanonisch/Zert-bis) + offene Jobs; mit `check` nur Live-DNS-Prüfung. **Lesend.** |
 | `site_domain_connect({ site?, domain, canonical?, action? })` | Eigene Domain verbinden (nginx + HTTPS automatisch, `www`/`apex`) oder trennen; DNS muss auf den Server zeigen; ab Starter-Plan. **Schreibend.** |
 | `site_embeds({ site? })` | Externe Einbettungen der Website: Host, Seite(n), aktuelle Einwilligungs-Kategorie (`gated` = Zwei-Klick \| `notwendig`). **Lesend.** |
 | `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_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

@@ -69,7 +69,9 @@ export function resolveTarget(cfg, site) {
       if (!key) throw new Error(`„${label}" ist kein Profil in deiner sites-Map. Verfügbar: ${keys.join(", ")}.`);
       return { token: needToken(cfg.sites[key].token, key), slug: "new" };
     }
-    return { token: needToken(cfg.token, "new"), slug: "new" };
+    // Einzel-/Betreuer-Token: „<Konto-ID>:new" trägt die Ziel-Konto-ID (k-…) im Label → als customer
+    // durchreichen (Betreuer-Erst-Import ohne separaten customer-Parameter). Bare „new" hat keine.
+    return { token: needToken(cfg.token, "new"), slug: "new", customer: newMatch ? newMatch[1] : null };
   }
   if (cfg.sites) {
     const keys = Object.keys(cfg.sites);
@@ -125,20 +127,36 @@ export async function apiExport(cfg, { site, which = "published", outDir = "." }
 /** POST /api/deploy/<site> – ZIP übergeben (+ optional publish/resetOverlay/legal). site="new" = anlegen. */
 export async function apiDeploy(cfg, { site, customer = null, slug: wishSlug = null, zipPath, publish = false, resetOverlay = false, legal = null, company = null, siteOverride = false } = {}, fetchImpl = fetch) {
   if (!zipPath || !fs.existsSync(zipPath)) throw new Error(`ZIP nicht gefunden: ${zipPath}`);
-  // Optional: Firmendaten VOR dem Deploy setzen (ein Schritt) → Rechtstext-Automatik nutzt sie direkt.
-  if (company && typeof company === "object") await apiCompanySet(cfg, { site, company, siteOverride }, fetchImpl);
-  const { token, slug } = resolveTarget(cfg, site);
+  const target = resolveTarget(cfg, site);
+  const { token, slug } = target;
+  const isNew = slug === "new";
+  const effCustomer = customer || target.customer || null;   // „<Konto-ID>:new" liefert customer; sonst Parameter
+  const hasCompany = company && typeof company === "object";
+  // Bestandssite: Firmendaten VOR dem Deploy (Rechtstext-Automatik nutzt sie sofort). ERST-Import: NICHT vorab –
+  // die Website existiert noch nicht (company-/legal-Gate → 404); Firmendaten kommen NACH dem Anlegen (unten).
+  if (hasCompany && !isNew) await apiCompanySet(cfg, { site, company, siteOverride }, fetchImpl);
   const q = new URLSearchParams();
   if (publish) q.set("publish", "1");
   if (resetOverlay) q.set("resetOverlay", "1");
   if (legal === true) q.set("legal", "1");
   if (legal === false) q.set("legal", "0");
-  if (customer) q.set("customer", customer);   // Betreuer-Token + site="new": Ziel-Konto für den Erst-Import
+  if (effCustomer) q.set("customer", effCustomer);   // Betreuer-Token + „new": Ziel-Konto für den Erst-Import
   if (wishSlug) q.set("slug", String(wishSlug));   // Erst-Import: Wunsch-Adresse (sonst wird sie abgeleitet)
   const qs = q.toString() ? `?${q}` : "";
   const res = await fetchImpl(`${baseUrl(cfg)}/deploy/${encodeURIComponent(slug)}${qs}`, {
     method: "POST", headers: { ...authHeaders(token), "content-type": "application/zip" }, body: fs.readFileSync(zipPath) });
-  return asJson(res);
+  const out = await asJson(res);
+  // ERST-Import + Firmendaten: jetzt auf die ERSTELLTE Website setzen (out.slug/out.site). Hinweis: die beim
+  // Erst-Import automatisch erzeugten Rechtstexte kennen diese Daten noch nicht – ein erneuter Rechts-Lauf/
+  // Publish übernimmt sie. Das melden wir als companyApplied/companyNote statt still zu lassen.
+  if (hasCompany && isNew && out && (out.slug || out.site)) {
+    try {
+      await apiCompanySet(cfg, { site: out.slug || out.site, company, siteOverride }, fetchImpl);
+      out.companyApplied = true;
+      if (out.legal && !out.legal.disabled) out.companyNote = "Firmendaten wurden NACH dem Erst-Import gesetzt – die automatisch erzeugten Rechtstexte übernehmen sie erst beim nächsten Rechts-Lauf/Publish.";
+    } catch (e) { out.companyApplied = false; out.companyError = e.message; }
+  }
+  return out;
 }
 
 /** POST /api/publish/<site> – erneut veröffentlichen (ohne ZIP). force=true = „trotzdem veröffentlichen"
@@ -208,6 +226,24 @@ export async function apiEmbedConsent(cfg, { site, host, page, category = "notwe
   return asJson(res);
 }
 
+/** GET /api/widgets/<site> – Katalog aller verwalteten Widgets (name, aktiv, optionen, schema). Lesend. */
+export async function apiWidgets(cfg, { site } = {}, fetchImpl = fetch) {
+  const { token, slug } = resolveTarget(cfg, site);
+  const res = await fetchImpl(`${baseUrl(cfg)}/widgets/${encodeURIComponent(slug)}`, { headers: authHeaders(token) });
+  return asJson(res);
+}
+/** PUT /api/widgets/<site>/<widget> {aktiv, optionen} – Widget setzen (gleicher Schema-Sanitizer wie das Dashboard). */
+export async function apiWidgetSet(cfg, { site, widget, aktiv, optionen } = {}, fetchImpl = fetch) {
+  if (!widget) throw new Error("widget erwartet (z. B. notice, consent, a11y, google-reviews, ps-impressum, ps-datenschutz).");
+  const { token, slug } = resolveTarget(cfg, site);
+  const body = {};
+  if (aktiv !== undefined) body.aktiv = !!aktiv;
+  if (optionen !== undefined) body.optionen = optionen;
+  const res = await fetchImpl(`${baseUrl(cfg)}/widgets/${encodeURIComponent(slug)}/${encodeURIComponent(widget)}`, {
+    method: "PUT", headers: { ...authHeaders(token), "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) {
@@ -228,9 +264,10 @@ export async function apiLegalOptions(cfg, { site, impressum, datenschutz } = {}
 // GET /api/sites mit EINEM Token → normalisierte Liste (Betreuer-Token: alle betreuten Kunden).
 async function apiSitesWithToken(cfg, token, fetchImpl) {
   const body = await asJson(await fetchImpl(`${baseUrl(cfg)}/sites`, { headers: authHeaders(token) }));
-  const sites = (body.sites || []).map(s => ({ label: s.slug || s.site, slug: s.slug || null, id: s.site || null,
+  const sites = (body.sites || []).map(s => ({ label: s.slug || s.site || s.customer, slug: s.slug || null, id: s.site || null,
     name: s.name || null, plan: s.plan, everPublished: s.everPublished, publishNeeded: s.publishNeeded,
-    lastChangeAt: s.lastChangeAt || null, liveUrl: s.liveUrl || null, customer: s.customer }));
+    lastChangeAt: s.lastChangeAt || null, liveUrl: s.liveUrl || null, customer: s.customer,
+    ...(s.needsFirstImport ? { needsFirstImport: true, hint: s.hint || null } : {}) }));
   return { count: sites.length, manager: !!body.manager, hint: body.hint || null, sites };
 }
 // sites-Map abfragen: jeden Eintrag einzeln (jeder Token → seine Site).

package/index.mjs

@@ -11,13 +11,13 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
-import { loadConfig, apiStatus, apiExport, apiDeploy, apiPublish, sitesList, apiCompanyGet, apiCompanySet, apiLegalOptions, apiDomainStatus, apiDomainConnect, apiEmbeds, apiEmbedConsent } from "./api.mjs";
+import { loadConfig, apiStatus, apiExport, apiDeploy, apiPublish, sitesList, apiCompanyGet, apiCompanySet, apiLegalOptions, apiDomainStatus, apiDomainConnect, apiEmbeds, apiEmbedConsent, apiWidgets, apiWidgetSet } from "./api.mjs";
 
 const cfg = loadConfig();
 // Deutliche Startwarnung bei ambiger Konfiguration (Top-Level-Token NEBEN sites-Map). Nach stderr, damit
 // es im MCP-Log/Terminal auffällt; die endgültige Auflösung (Betreuer-Token-Vorrang vs. Map) klärt sites_list.
 for (const w of (cfg.warnings || [])) process.stderr.write("[prontosite-mcp] ⚠ " + w + "\n");
-const server = new McpServer({ name: "prontosite", version: "0.8.0" });
+const server = new McpServer({ name: "prontosite", version: "0.9.1" });
 const asText = obj => ({ content: [{ type: "text", text: JSON.stringify(obj, null, 2) }] });
 const asError = e => ({ isError: true, content: [{ type: "text", text: "Fehler: " + (e?.message || String(e)) }] });
 const SITE_DESC = "Website-Slug (z. B. 'mas-monti'). Ohne Angabe die Standard-Site der Config. Bei Betreuer-"
@@ -80,10 +80,15 @@ server.tool(
     + "WICHTIG beim ERST-IMPORT: Frag den Nutzer VOR dem Deploy nach der gewünschten Adresse "
     + "(„Unter welcher Adresse soll die Website laufen?“, z. B. 'wuerttemberg' → wuerttemberg.prontosite.io) "
     + "und übergib sie als slug – ohne slug wird die Adresse nur aus Konto-/Seitenname ABGELEITET (die Antwort "
-    + "nennt dann die abgeleitete Adresse; sie ist später änderbar). Bitte VOR dem Aufruf bestätigen lassen.",
-  { site: z.string().optional().describe(SITE_DESC + " Erst-Import: 'new' (Einzel) bzw. '<label>:new' (Multi-Site)."),
+    + "nennt dann die abgeleitete Adresse; sie ist später änderbar). Bitte VOR dem Aufruf bestätigen lassen. "
+    + "MARKER (wenn du das Template lokal baust): markiere im HTML mit dem Attribut data-ps, wo Bausteine "
+    + "erscheinen sollen – data-ps=\"formular:kontakt\" (verwaltetes Kontaktformular), data-ps=\"impressum\" bzw. "
+    + "data-ps=\"datenschutz\" (Rechtstext-Seite) und data-ps=\"link-impressum\" / data-ps=\"link-datenschutz\" "
+    + "(Footer-Links auf die Rechtstexte). Beim Import legt ProntoSite die Bausteine automatisch an. "
+    + "Syntax-Referenz: https://prontosite.io/docs/marker-shortcodes",
+  { site: z.string().optional().describe(SITE_DESC + " Erst-Import: 'new' (Einzel) bzw. '<label>:new' (Multi-Site). Betreuer-Token: '<Konto-ID>:new' (k-…) legt im betreuten Konto an – die Konto-ID im Label ersetzt den customer-Parameter. sites_list zeigt betreute Konten OHNE Website (needsFirstImport) samt ihrer k-ID."),
     slug: z.string().optional().describe("Erst-Import: gewünschte Web-Adresse (Subdomain-Label, z. B. 'wuerttemberg' → wuerttemberg.prontosite.io). Beim Erst-Import den Nutzer danach FRAGEN; wird sie weggelassen, leitet ProntoSite eine Adresse ab. Bei Updates ignoriert."),
-    customer: z.string().optional().describe("Nur Betreuer-Token + Erst-Import mit EINEM Manager-Token: Ziel-Konto-ID (k-…). Bei per-Konto-Token in der sites-Map genügt '<label>:new'."),
+    customer: z.string().optional().describe("Betreuer-Token + Erst-Import: Ziel-Konto-ID (k-…) für die neue Website. Alternativ direkt im site-Argument als '<Konto-ID>:new'."),
     zipPath: z.string().describe("Pfad zur ZIP-Datei der Website (lokal)."),
     publish: z.boolean().default(false).describe("true = nach dem Import direkt veröffentlichen (LIVE)."),
     resetOverlay: z.boolean().default(false).describe("true = bisherige Dashboard-Änderungen verwerfen."),
@@ -140,7 +145,10 @@ server.tool(
   "LESEND/SCHREIBEND: Anzeige-Optionen der Rechtstext-Widgets je Rolle (impressum/datenschutz): showTitle "
     + "(Überschrift), showDate (Stand-Datum), draftNotice (Entwurfs-Hinweis in der Live-Ausgabe). OHNE impressum/"
     + "datenschutz nur LESEN. Teil-Update (nur gesetzte Felder). HINWEIS: draftNotice:false blendet den rechtlich "
-    + "empfohlenen Entwurfs-Hinweis live aus (protokolliert) – bitte vorher bestätigen lassen.",
+    + "empfohlenen Entwurfs-Hinweis live aus (protokolliert) – bitte vorher bestätigen lassen. "
+    + "MARKER (beim lokalen Bauen): Rechtstext-Seiten und -Links im Template mit data-ps markieren – "
+    + "data-ps=\"impressum\" / data-ps=\"datenschutz\" (Seite) bzw. data-ps=\"link-impressum\" / "
+    + "data-ps=\"link-datenschutz\" (Footer-Links). Syntax-Referenz: https://prontosite.io/docs/marker-shortcodes",
   { site: z.string().optional().describe(SITE_DESC),
     impressum: legalOptShape.optional(),
     datenschutz: legalOptShape.optional() },
@@ -203,5 +211,33 @@ server.tool(
   }
 );
 
+server.tool(
+  "site_widgets",
+  "LESEND: Katalog der verwalteten Widgets einer Website – je Widget name, Titel, aktiv, aktuelle optionen und "
+    + "das Konfig-schema (Feldtypen/Defaults). Widgets sind in JEDEM Plan (auch Free) verfügbar. Bekannte Widgets: "
+    + "consent (Cookie-Banner), a11y (Barrierefreiheit-Hilfen), notice (Pop-Ups/Hinweise – Modal/Banner/inline, "
+    + "Listen-Widget optionen.items[]), google-reviews, ps-impressum, ps-datenschutz. Basis für site_widget_set.",
+  { site: z.string().optional().describe(SITE_DESC) },
+  async ({ site }) => { try { return asText(await apiWidgets(cfg, { site })); } catch (e) { return asError(e); } }
+);
+
+server.tool(
+  "site_widget_set",
+  "SCHREIBEND: ein Widget aktivieren/deaktivieren und/oder seine Optionen setzen – MIT DEMSELBEN Schema-Sanitizer "
+    + "wie das Dashboard (unbekannte/ungültige Felder werden abgewiesen). `optionen` muss zum schema aus site_widgets "
+    + "passen; Listen-Widgets (z. B. notice) erwarten { items: [ { id?, name?, aktiv?, ...Felder } ] }. Beispiel notice: "
+    + "optionen={ items:[{ titel:'Sommerpause', text:'**Geschlossen** bis 1.9.', darstellung:'modal', seiten:['index.html'], "
+    + "haeufigkeit:'tage', ruheTage:3 }] }. Greift beim nächsten Veröffentlichen (publishNeeded). Vorher mit dem Nutzer "
+    + "bestätigen (verändert die Website). Ergänzt die Einzel-Tools site_legal_options/site_embed_consent, ersetzt sie nicht. "
+    + "Betreuer-Token gilt für betreute Kunden.",
+  { site: z.string().optional().describe(SITE_DESC),
+    widget: z.string().describe("Widget-Name aus site_widgets (z. B. 'notice', 'consent', 'a11y', 'google-reviews', 'ps-impressum', 'ps-datenschutz')."),
+    aktiv: z.boolean().optional().describe("Widget an/aus. Weglassen = unverändert (nur optionen setzen)."),
+    optionen: z.any().optional().describe("Konfig-Objekt gemäß schema aus site_widgets. Listen-Widgets: { items: [...] }. Weglassen = aktiv-Status unverändert lassen.") },
+  async ({ site, widget, aktiv, optionen }) => {
+    try { return asText(await apiWidgetSet(cfg, { site, widget, aktiv, optionen })); } catch (e) { return asError(e); }
+  }
+);
+
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prontosite/mcp",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "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": {