@prontosite/mcp 0.9.0 → 0.9.2

package/CHANGELOG.md

@@ -3,6 +3,15 @@
 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.2 – 2026-10-01
+
+- **Pflicht-Marker in den Tool-Beschreibungen** (`site_deploy`, `site_legal_options`) + README: Rechtsseiten
+  bringen `data-ps="impressum"`/`"datenschutz"` + eine EIGENE `<h1>` mit (kein handgeschriebener Rechtstext) →
+  `site_legal_options` mit `showTitle:false` setzen (bei `?markers=auto` automatisch bei erkannter eigener H1);
+  Footer IMMER mit allen vier Markern (`link-impressum`, `link-datenschutz`, `cookie-einstellungen`,
+  `cookie-richtlinie`), sonst ungestylter Consent-Block; Mobile-Menü rendert als Drawer, Toggle braucht
+  `aria-controls`. Reine Beschreibungs-/Doku-Änderung (keine neue Funktion).
+
 ## 0.9.0 – 2026-09-27
 
 - **Neu: `site_widgets`** (lesend) – Katalog der verwalteten Widgets einer Website inkl. `aktiv`, `optionen`

package/README.md

@@ -99,6 +99,21 @@ sichern: `cp ~/.prontosite.json ~/.prontosite.json.bak`).
 `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.
 
+### Pflicht-Marker beim lokalen Bauen
+
+Baust du das Template selbst, gehören drei Dinge dazu (volle Spec:
+[Marker-Syntax](https://prontosite.io/docs/marker-shortcodes)):
+
+- **Rechtsseiten:** `impressum/index.html` und `datenschutz/index.html` tragen IMMER
+  `<div data-ps="impressum">` bzw. `<div data-ps="datenschutz">` als Inhaltsbereich und eine **eigene `<h1>`**
+  (kein handgeschriebener Rechtstext). Danach `site_legal_options({ impressum:{ showTitle:false } })` setzen
+  (eigene H1 → keine doppelte Überschrift). Beim Erst-Import mit `?markers=auto`/der Rechts-Automatik setzt
+  ProntoSite `showTitle:false` automatisch, sobald die Rechtsseite eine eigene H1 hat.
+- **Footer:** IMMER alle vier Marker `link-impressum`, `link-datenschutz`, `cookie-einstellungen`,
+  `cookie-richtlinie` – sonst hängt das Consent-Widget einen ungestylten Block an den Seitenfuß (mehrsprachig
+  je Sprach-Footer dieselben Marker, Linktext lokalisiert).
+- **Mobile-Menü:** rendert als Drawer (von rechts); der Toggle braucht `aria-controls` auf das Menü.
+
 ## Arbeitsweise: ein Chat je Kunde
 
 Für saubere Trennung: pro Kundenwebsite **einen eigenen Claude-Chat**. So bezieht sich der ganze Verlauf auf

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"
@@ -246,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

@@ -17,7 +17,7 @@ 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.9.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-"
@@ -85,10 +85,17 @@ server.tool(
     + "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. "
+    + "PFLICHT-MARKER: (a) Rechtsseiten impressum/index.html + datenschutz/index.html tragen IMMER den "
+    + "data-ps-Marker als Inhaltsbereich UND eine EIGENE <h1>; schreib KEINEN Rechtstext von Hand hinein. Weil "
+    + "die Seite ihre eigene H1 hat, die Widget-Überschrift ausschalten – site_legal_options mit showTitle:false "
+    + "(bei ?markers=auto setzt ProntoSite das automatisch, sobald die Rechtsseite eine eigene H1 hat). "
+    + "(b) Footer IMMER mit allen vier Markern link-impressum, link-datenschutz, cookie-einstellungen, "
+    + "cookie-richtlinie (sonst hängt das Consent-Widget einen ungestylten Block an den Seitenfuß; mehrsprachig "
+    + "je Sprach-Footer dieselben Marker). (c) Mobile-Menü-Toggle braucht aria-controls (Menü rendert als Drawer). "
     + "Syntax-Referenz: https://prontosite.io/docs/marker-shortcodes",
-  { site: z.string().optional().describe(SITE_DESC + " Erst-Import: 'new' (Einzel) bzw. '<label>:new' (Multi-Site)."),
+  { 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."),
@@ -135,7 +142,7 @@ server.tool(
 );
 
 const legalOptShape = z.object({
-  showTitle: z.boolean().optional().describe("Überschrift (H1) des Rechtstextes anzeigen (Default an)."),
+  showTitle: z.boolean().optional().describe("Widget-Überschrift des Rechtstextes anzeigen (Default an). Bringt die Rechtsseite ihre EIGENE <h1> mit (Pflicht-Marker-Konvention), hier showTitle:false setzen, sonst doppelte Überschrift."),
   showDate: z.boolean().optional().describe("Stand-Datum anzeigen (Default an; nur wo vorhanden, i. d. R. Datenschutz)."),
   draftNotice: z.boolean().optional().describe("Entwurfs-Hinweis in der VERÖFFENTLICHTEN Seite anzeigen (Default an)."),
 }).describe("Anzeige-Optionen einer Rechtstext-Rolle – Teil-Update, nur gesetzte Booleans wirken.");
@@ -146,7 +153,9 @@ server.tool(
     + "(Ü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. "
-    + "MARKER (beim lokalen Bauen): Rechtstext-Seiten und -Links im Template mit data-ps markieren – "
+    + "WICHTIG: Rechtsseiten sollen laut Konvention ihre EIGENE <h1> mitbringen (Marker data-ps=\"impressum\"/"
+    + "\"datenschutz\" als Inhaltsbereich) – dann hier showTitle:false setzen, damit keine doppelte Überschrift "
+    + "entsteht. 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),

package/package.json

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