@prontosite/mcp 0.11.1 → 0.12.0

package/CHANGELOG.md

@@ -3,6 +3,32 @@
 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.12.0 – 2026-10-19
+
+- **Arbeitsweise im Server verankert:** Der MCP-Server liefert beim Verbinden `instructions` – Standard ist das Arbeiten direkt
+  am Server-Entwurf (`site_status` → `site_edit_text`/`site_file_*` → `site_status`, Vorschau-Link nennen). Export + Deploy nur
+  auf ausdrücklichen Wunsch bzw. für größere Umbauten; `site_publish` nur nach Bestätigung im Chat; bei 409 erst `site_status`.
+- **Neu `site_edit_text`** (`find`, `replace`, optional `pages`, `baseRev`): Text über alle Seiten suchen und ersetzen –
+  Formatierung bleibt, ein Rückgängig-Schritt, Rechtstexte ausgenommen; bei mehreren Fundstellen ohne `pages` nur eine Liste.
+- Beschreibungen: Datei-Tools „STANDARDWEG", Export/Deploy „AUSNAHME"; `site_publish` ausdrücklich „live für Besucher, nur nach
+  Bestätigung".
+- **`baseRev` beim Deploy-Update Pflicht** (F4a): ZIPs aus `site_export` tragen ihn automatisch, sonst `baseRev` aus `site_status`
+  mitgeben (neuer Parameter an `site_deploy`); ohne → `428`.
+
+## 0.11.3 – 2026-10-19
+
+- Beschreibungen von `site_file_put`/`site_file_delete`/`site_file_rename`: Schreiben geht jetzt auch mit Kunden-Token
+  (serverseitig seit 19.10.); Skriptdateien (JavaScript) bleiben Betreuern vorbehalten – Kunden bekommen dort 403.
+
+## 0.11.2 – 2026-10-19 (veröffentlicht 19.10.2026)
+
+- **Intern, kein Verhaltenswechsel:** die Tool-Definitionen liegen jetzt in `tools.mjs` – dieselbe Quelle nutzt der neue
+  Remote-Endpunkt `https://app.prontosite.io/mcp` (Streamable HTTP, Bearer-Token; für Cursor und Claude Code ohne lokale
+  Installation). Lokal bleiben `site_export`/`site_deploy` mit Dateipfaden; remote heißen sie Download-Link bzw.
+  `deploy_upload_begin` + `deploy_commit`.
+- Die Config-Prüfung akzeptiert neben `psk_` auch `pso_` (OAuth-Zugriff – nur der Remote-Endpunkt reicht ihn intern weiter; lokal ändert sich nichts).
+- MCP-SDK mindestens 1.31.0 (Sicherheitshinweis GHSA-6qxp-vccf-f47h betrifft nur die OAuth-Client-Seite, hier ungenutzt).
+
 ## 0.11.1 – 2026-10-18
 
 - **Sanfte Sperre:** neue Tools `site_lock` (Notiz optional, `takeover` nur Betreuer) und `site_unlock`. Zeigt allen anderen

package/api.mjs

@@ -43,7 +43,8 @@ export function loadConfig(env = process.env, home = os.homedir()) {
 }
 
 const needToken = (token, ref) => {
-  if (!token || !String(token).startsWith("psk_"))
+  // psk_ = API-Token; pso_ = OAuth-Zugriff (nur der Remote-Endpunkt /mcp reicht ihn an seinen internen Loopback weiter).
+  if (!token || !/^(psk_|pso_)/.test(String(token)))
     throw new Error(`Kein API-Token für „${ref}" konfiguriert. Setze PRONTOSITE_TOKEN oder trage die Site in ~/.prontosite.json (sites) ein.`);
   return token;
 };
@@ -91,11 +92,13 @@ export function resolveTarget(cfg, site) {
   return { token: needToken(cfg.token, want), slug: want };
 }
 
-const baseUrl = cfg => `https://${cfg.host}/api`;
+// cfg.apiBase: Remote-Endpunkt (/mcp) ruft die REST-API über den internen Loopback auf (http://127.0.0.1:<port>/api).
+const baseUrl = cfg => cfg.apiBase || `https://${cfg.host}/api`;
 // Client-Kennung: der Server führt damit im Verlauf je Site den Weg „mcp" (statt „api" für curl).
 let CLIENT_ID = "mcp";
 try { CLIENT_ID = "mcp/" + JSON.parse(fs.readFileSync(new URL("./package.json", import.meta.url), "utf8")).version; } catch { /* egal */ }
-const authHeaders = token => ({ authorization: `Bearer ${token}`, "x-prontosite-client": CLIENT_ID });
+// Remote: cfg.clientId (Weg/Client-Name) + cfg.extraHeaders (interne Loopback-Kennung, echte Client-IP).
+const authHeaders = (token, cfg = {}) => ({ authorization: `Bearer ${token}`, "x-prontosite-client": cfg.clientId || CLIENT_ID, ...(cfg.extraHeaders || {}) });
 
 /**
  * Server-Fehler → VERSTÄNDLICHE Meldung für den Chat. Zentral für ALLE Tools (über asJson). Übersetzt die
@@ -128,19 +131,24 @@ async function asJson(res) {
 /** GET /api/status/<site> – Status der Site (Plan, Slug, Live-URL, Publish-Bedarf, letzte Änderung). */
 export async function apiStatus(cfg, { site } = {}, fetchImpl = fetch) {
   const { token, slug } = resolveTarget(cfg, site);
-  const res = await fetchImpl(`${baseUrl(cfg)}/status/${encodeURIComponent(slug)}`, { headers: authHeaders(token) });
+  const res = await fetchImpl(`${baseUrl(cfg)}/status/${encodeURIComponent(slug)}`, { headers: authHeaders(token, cfg) });
   return asJson(res);
 }
 
-/** GET /api/export/<site>?which= – ZIP in einen lokalen Ordner speichern. */
-export async function apiExport(cfg, { site, which = "published", outDir = "." } = {}, fetchImpl = fetch) {
+/** GET /api/export/<site>?which= – ZIP holen (Puffer + Dateiname). Remote macht daraus einen Download-Link. */
+export async function apiExportFetch(cfg, { site, which = "published" } = {}, fetchImpl = fetch) {
   const { token, slug } = resolveTarget(cfg, site);
-  const res = await fetchImpl(`${baseUrl(cfg)}/export/${encodeURIComponent(slug)}?which=${encodeURIComponent(which)}`, { headers: authHeaders(token) });
-  if (!res.ok) return asJson(res);   // Fehler kommen als JSON
+  const res = await fetchImpl(`${baseUrl(cfg)}/export/${encodeURIComponent(slug)}?which=${encodeURIComponent(which)}`, { headers: authHeaders(token, cfg) });
+  if (!res.ok) { await asJson(res); throw new Error(`HTTP ${res.status}`); }   // Fehler kommen als JSON → Exception
   const buf = Buffer.from(await res.arrayBuffer());
   const cd = res.headers.get("content-disposition") || "";
   const m = /filename="?([^"]+)"?/.exec(cd);
-  const name = (m && m[1]) || `prontosite-${slug}-${which}.zip`;
+  return { buf, slug, name: (m && m[1]) || `prontosite-${slug}-${which}.zip` };
+}
+
+/** GET /api/export/<site>?which= – ZIP in einen lokalen Ordner speichern. */
+export async function apiExport(cfg, { site, which = "published", outDir = "." } = {}, fetchImpl = fetch) {
+  const { buf, slug, name } = await apiExportFetch(cfg, { site, which }, fetchImpl);
   fs.mkdirSync(outDir, { recursive: true });
   const outPath = path.join(outDir, name.replace(/[^a-zA-Z0-9._-]+/g, "_"));
   fs.writeFileSync(outPath, buf);
@@ -148,7 +156,7 @@ 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, name = null, zipPath, publish = false, resetOverlay = false, legal = null, company = null, siteOverride = false } = {}, fetchImpl = fetch) {
+export async function apiDeploy(cfg, { site, customer = null, slug: wishSlug = null, name = null, zipPath, baseRev = null, publish = false, resetOverlay = false, legal = null, company = null, siteOverride = false } = {}, fetchImpl = fetch) {
   if (!zipPath || !fs.existsSync(zipPath)) throw new Error(`ZIP nicht gefunden: ${zipPath}`);
   const target = resolveTarget(cfg, site);
   const { token, slug } = target;
@@ -165,10 +173,11 @@ export async function apiDeploy(cfg, { site, customer = null, slug: wishSlug = n
   if (legal === false) q.set("legal", "0");
   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)
-  if (isNew && name) q.set("name", String(name));   // Erst-Import: Site-Name explizit setzen (sonst aus der Startseite abgeleitet)
+  if (isNew && name) q.set("name", String(name));
+  if (!isNew && Number.isInteger(baseRev)) q.set("baseRev", String(baseRev));   // F4a: ab 0.12 Pflicht bei Updates (ZIP aus site_export trägt ihn selbst)   // Erst-Import: Site-Name explizit setzen (sonst aus der Startseite 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) });
+    method: "POST", headers: { ...authHeaders(token, cfg), "content-type": "application/zip" }, body: fs.readFileSync(zipPath) });
   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/
@@ -197,7 +206,7 @@ export async function apiAccountCreate(cfg, { name, email = null, plan = null, n
   if (note) body.note = String(note).trim();
   if (override === true) body.override = true;
   const res = await fetchImpl(`${baseUrl(cfg)}/account`, {
-    method: "POST", headers: { ...authHeaders(token), "content-type": "application/json" }, body: JSON.stringify(body) });
+    method: "POST", headers: { ...authHeaders(token, cfg), "content-type": "application/json" }, body: JSON.stringify(body) });
   return asJson(res);
 }
 
@@ -206,14 +215,14 @@ export async function apiAccountCreate(cfg, { name, email = null, plan = null, n
 export async function apiPublish(cfg, { site, force = false } = {}, fetchImpl = fetch) {
   const { token, slug } = resolveTarget(cfg, site);
   const qs = force ? "?force=1" : "";
-  const res = await fetchImpl(`${baseUrl(cfg)}/publish/${encodeURIComponent(slug)}${qs}`, { method: "POST", headers: authHeaders(token) });
+  const res = await fetchImpl(`${baseUrl(cfg)}/publish/${encodeURIComponent(slug)}${qs}`, { method: "POST", headers: authHeaders(token, cfg) });
   return asJson(res);
 }
 
 /** GET /api/company/<site> – konto-weite Firmendaten (effektiv + account_company + siteOverride-Flag). */
 export async function apiCompanyGet(cfg, { site } = {}, fetchImpl = fetch) {
   const { token, slug } = resolveTarget(cfg, site);
-  const res = await fetchImpl(`${baseUrl(cfg)}/company/${encodeURIComponent(slug)}`, { headers: authHeaders(token) });
+  const res = await fetchImpl(`${baseUrl(cfg)}/company/${encodeURIComponent(slug)}`, { headers: authHeaders(token, cfg) });
   return asJson(res);
 }
 
@@ -223,7 +232,7 @@ export async function apiCompanySet(cfg, { site, company, siteOverride = false }
   if (!company || typeof company !== "object") throw new Error("company-Objekt erwartet.");
   const { token, slug } = resolveTarget(cfg, site);
   const res = await fetchImpl(`${baseUrl(cfg)}/company/${encodeURIComponent(slug)}`, {
-    method: "PUT", headers: { ...authHeaders(token), "content-type": "application/json" },
+    method: "PUT", headers: { ...authHeaders(token, cfg), "content-type": "application/json" },
     body: JSON.stringify({ company, siteOverride: !!siteOverride }) });
   return asJson(res);
 }
@@ -233,7 +242,7 @@ export async function apiCompanySet(cfg, { site, company, siteOverride = false }
 export async function apiDomainStatus(cfg, { site, check } = {}, fetchImpl = fetch) {
   const { token, slug } = resolveTarget(cfg, site);
   const qs = check ? `?check=${encodeURIComponent(check)}` : "";
-  const res = await fetchImpl(`${baseUrl(cfg)}/domain/${encodeURIComponent(slug)}${qs}`, { headers: authHeaders(token) });
+  const res = await fetchImpl(`${baseUrl(cfg)}/domain/${encodeURIComponent(slug)}${qs}`, { headers: authHeaders(token, cfg) });
   return asJson(res);
 }
 
@@ -244,7 +253,7 @@ export async function apiDomainConnect(cfg, { site, domain, canonical = "www", a
   if (!domain) throw new Error("domain erwartet.");
   const { token, slug } = resolveTarget(cfg, site);
   const res = await fetchImpl(`${baseUrl(cfg)}/domain/${encodeURIComponent(slug)}`, {
-    method: "POST", headers: { ...authHeaders(token), "content-type": "application/json" },
+    method: "POST", headers: { ...authHeaders(token, cfg), "content-type": "application/json" },
     body: JSON.stringify({ domain, canonical, action }) });
   return asJson(res);
 }
@@ -252,7 +261,7 @@ export async function apiDomainConnect(cfg, { site, domain, canonical = "www", a
 /** GET /api/embeds/<site> – erkannte Embeds (Host, Seite(n), aktuelle Kategorie gated|notwendig). LESEND. */
 export async function apiEmbeds(cfg, { site } = {}, fetchImpl = fetch) {
   const { token, slug } = resolveTarget(cfg, site);
-  const res = await fetchImpl(`${baseUrl(cfg)}/embeds/${encodeURIComponent(slug)}`, { headers: authHeaders(token) });
+  const res = await fetchImpl(`${baseUrl(cfg)}/embeds/${encodeURIComponent(slug)}`, { headers: authHeaders(token, cfg) });
   return asJson(res);
 }
 
@@ -263,7 +272,7 @@ export async function apiEmbedConsent(cfg, { site, host, page, category = "notwe
   if (!host) throw new Error("host erwartet.");
   const { token, slug } = resolveTarget(cfg, site);
   const res = await fetchImpl(`${baseUrl(cfg)}/embeds/${encodeURIComponent(slug)}`, {
-    method: "PUT", headers: { ...authHeaders(token), "content-type": "application/json" },
+    method: "PUT", headers: { ...authHeaders(token, cfg), "content-type": "application/json" },
     body: JSON.stringify({ host, page: page || null, category, confirmed: !!confirmed }) });
   return asJson(res);
 }
@@ -271,7 +280,7 @@ export async function apiEmbedConsent(cfg, { site, host, page, category = "notwe
 /** 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) });
+  const res = await fetchImpl(`${baseUrl(cfg)}/widgets/${encodeURIComponent(slug)}`, { headers: authHeaders(token, cfg) });
   return asJson(res);
 }
 /** PUT /api/widgets/<site>/<widget> {aktiv, optionen} – Widget setzen (gleicher Schema-Sanitizer wie das Dashboard). */
@@ -282,7 +291,7 @@ export async function apiWidgetSet(cfg, { site, widget, aktiv, optionen } = {},
   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) });
+    method: "PUT", headers: { ...authHeaders(token, cfg), "content-type": "application/json" }, body: JSON.stringify(body) });
   return asJson(res);
 }
 
@@ -292,12 +301,12 @@ export async function apiLegalOptions(cfg, { site, impressum, datenschutz } = {}
   const { token, slug } = resolveTarget(cfg, site);
   const endpoint = `${baseUrl(cfg)}/legal-options/${encodeURIComponent(slug)}`;
   if (impressum === undefined && datenschutz === undefined) {
-    return asJson(await fetchImpl(endpoint, { headers: authHeaders(token) }));
+    return asJson(await fetchImpl(endpoint, { headers: authHeaders(token, cfg) }));
   }
   const body = {};
   if (impressum !== undefined) body.impressum = impressum;
   if (datenschutz !== undefined) body.datenschutz = datenschutz;
-  const res = await fetchImpl(endpoint, { method: "PUT", headers: { ...authHeaders(token), "content-type": "application/json" }, body: JSON.stringify(body) });
+  const res = await fetchImpl(endpoint, { method: "PUT", headers: { ...authHeaders(token, cfg), "content-type": "application/json" }, body: JSON.stringify(body) });
   return asJson(res);
 }
 
@@ -305,7 +314,7 @@ export async function apiLegalOptions(cfg, { site, impressum, datenschutz } = {}
  *  jeder Eintrag per Status abgefragt; sonst die eine konfigurierte Site. Fehler je Site werden mitgeführt. */
 // 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 body = await asJson(await fetchImpl(`${baseUrl(cfg)}/sites`, { headers: authHeaders(token, cfg) }));
   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,
@@ -353,36 +362,44 @@ async function asJsonOr409(res) {
 /** GET /api/files/<site> – Dateiliste des Entwurfs (Pfad, Größe, Typ, bearbeitbar) + draftRev. */
 export async function apiFiles(cfg, { site } = {}, fetchImpl = fetch) {
   const { token, slug } = resolveTarget(cfg, site);
-  return asJson(await fetchImpl(`${baseUrl(cfg)}/files/${encodeURIComponent(slug)}`, { headers: authHeaders(token) }));
+  return asJson(await fetchImpl(`${baseUrl(cfg)}/files/${encodeURIComponent(slug)}`, { headers: authHeaders(token, cfg) }));
 }
 /** GET /api/file/<site>?path= – Quelltext einer Datei (Text bzw. Base64) + draftRev + Overlay-Hinweis. */
 export async function apiFileGet(cfg, { site, path: rel } = {}, fetchImpl = fetch) {
   const { token, slug } = resolveTarget(cfg, site);
-  return asJson(await fetchImpl(`${baseUrl(cfg)}/file/${encodeURIComponent(slug)}?path=${encodeURIComponent(rel)}`, { headers: authHeaders(token) }));
+  return asJson(await fetchImpl(`${baseUrl(cfg)}/file/${encodeURIComponent(slug)}?path=${encodeURIComponent(rel)}`, { headers: authHeaders(token, cfg) }));
 }
 /** PUT /api/file/<site>?path= – Text-Inhalt ersetzen (Entwurf). baseRev Pflicht. */
 export async function apiFilePut(cfg, { site, path: rel, content, baseRev, overlay = "keep" } = {}, fetchImpl = fetch) {
   const { token, slug } = resolveTarget(cfg, site);
   return asJsonOr409(await fetchImpl(`${baseUrl(cfg)}/file/${encodeURIComponent(slug)}?path=${encodeURIComponent(rel)}`, {
-    method: "PUT", headers: { ...authHeaders(token), "content-type": "application/json" }, body: JSON.stringify({ content, baseRev, overlay }) }));
+    method: "PUT", headers: { ...authHeaders(token, cfg), "content-type": "application/json" }, body: JSON.stringify({ content, baseRev, overlay }) }));
 }
 /** POST /api/file/<site>/delete – Datei im Entwurf als gelöscht markieren (undo-fähig). */
 export async function apiFileDelete(cfg, { site, path: rel, baseRev, confirmDestructive = false } = {}, fetchImpl = fetch) {
   const { token, slug } = resolveTarget(cfg, site);
   return asJsonOr409(await fetchImpl(`${baseUrl(cfg)}/file/${encodeURIComponent(slug)}/delete`, {
-    method: "POST", headers: { ...authHeaders(token), "content-type": "application/json" }, body: JSON.stringify({ path: rel, baseRev, confirmDestructive }) }));
+    method: "POST", headers: { ...authHeaders(token, cfg), "content-type": "application/json" }, body: JSON.stringify({ path: rel, baseRev, confirmDestructive }) }));
 }
 /** POST /api/file/<site>/rename – Datei umbenennen (Verweise werden NICHT umgeschrieben). */
 export async function apiFileRename(cfg, { site, from, to, baseRev } = {}, fetchImpl = fetch) {
   const { token, slug } = resolveTarget(cfg, site);
   return asJsonOr409(await fetchImpl(`${baseUrl(cfg)}/file/${encodeURIComponent(slug)}/rename`, {
-    method: "POST", headers: { ...authHeaders(token), "content-type": "application/json" }, body: JSON.stringify({ from, to, baseRev }) }));
+    method: "POST", headers: { ...authHeaders(token, cfg), "content-type": "application/json" }, body: JSON.stringify({ from, to, baseRev }) }));
+}
+
+/** POST /api/edit-text/<site> – Text über alle Seiten suchen + ersetzen (Entwurf, eine Undo-Einheit). 409 kommt als Objekt zurück. */
+export async function apiEditText(cfg, { site, find, replace, pages = null, baseRev = null } = {}, fetchImpl = fetch) {
+  const { token, slug } = resolveTarget(cfg, site);
+  const body = { find, replace, ...(Array.isArray(pages) && pages.length ? { pages } : {}), ...(Number.isInteger(baseRev) ? { baseRev } : {}) };
+  return asJsonOr409(await fetchImpl(`${baseUrl(cfg)}/edit-text/${encodeURIComponent(slug)}`, {
+    method: "POST", headers: { ...authHeaders(token, cfg), "content-type": "application/json" }, body: JSON.stringify(body) }));
 }
 
 /** GET/POST /api/lock/<site> – sanfte Sperre („in Bearbeitung durch …"); blockiert niemanden. action: lock|unlock|takeover. */
 export async function apiLock(cfg, { site, action = null, note = null } = {}, fetchImpl = fetch) {
   const { token, slug } = resolveTarget(cfg, site);
   const url = `${baseUrl(cfg)}/lock/${encodeURIComponent(slug)}`;
-  if (!action) return asJson(await fetchImpl(url, { headers: authHeaders(token) }));
-  return asJsonOr409(await fetchImpl(url, { method: "POST", headers: { ...authHeaders(token), "content-type": "application/json" }, body: JSON.stringify({ action, note }) }));
+  if (!action) return asJson(await fetchImpl(url, { headers: authHeaders(token, cfg) }));
+  return asJsonOr409(await fetchImpl(url, { method: "POST", headers: { ...authHeaders(token, cfg), "content-type": "application/json" }, body: JSON.stringify({ action, note }) }));
 }

package/index.mjs

@@ -13,343 +13,17 @@ import { realpathSync } from "node:fs";
 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, apiAccountCreate, apiCompanyGet, apiCompanySet, apiLegalOptions, apiDomainStatus, apiDomainConnect, apiEmbeds, apiEmbedConsent, apiWidgets, apiWidgetSet, apiFiles, apiFileGet, apiFilePut, apiFileDelete, apiFileRename, apiLock } from "./api.mjs";
+import { loadConfig } from "./api.mjs";
+import { registerTools, SERVER_INSTRUCTIONS } from "./tools.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.11.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-"
-  + "Config (mehrere Sites) hier die gewünschte Website angeben.";
-
-// Firmendaten-Felder (identisch zum Dashboard-Formular / Sanitizer). Nur gesetzte Felder werden geändert.
-const companyObject = z.object({
-  name: z.string().optional().describe("Firmenname"),
-  legalForm: z.string().optional().describe("Rechtsform (z. B. GmbH, UG, Einzelunternehmen, Freiberufler)"),
-  representative: z.string().optional().describe("Inhaber / Vertretungsberechtigte:r"),
-  street: z.string().optional().describe("Straße und Hausnummer"),
-  zip: z.string().optional().describe("PLZ"),
-  city: z.string().optional().describe("Ort"),
-  country: z.string().optional().describe("Land"),
-  email: z.string().optional().describe("E-Mail-Adresse (Impressum)"),
-  phone: z.string().optional().describe("Telefon"),
-  fax: z.string().optional().describe("Fax"),
-  vatId: z.string().optional().describe("USt-IdNr."),
-  registerCourt: z.string().optional().describe("Registergericht"),
-  registerNumber: z.string().optional().describe("Handelsregister-Nr."),
-  kammer: z.string().optional().describe("Zuständige Kammer (reglementierte Berufe)"),
-  berufsbezeichnung: z.string().optional().describe("Berufsbezeichnung (reglementierte Berufe)"),
-  aufsichtsbehoerde: z.string().optional().describe("Aufsichtsbehörde (erlaubnispflichtige Gewerbe)"),
-  verantwortlichMStV: z.string().optional().describe("Verantwortlich i.S.d. § 18 Abs. 2 MStV (falls abweichend)"),
-  berufshaftpflicht: z.string().optional().describe("Berufshaftpflichtversicherung (Name, Ort, Geltungsraum)"),
-  social: z.array(z.object({ label: z.string(), href: z.string() })).optional().describe("Social-Links [{label,href}] (href muss http/https sein)"),
-}).describe("Firmendaten fürs Impressum/Footer – Teil-Update: nur gesetzte Felder ändern sich.");
-
-server.tool(
-  "sites_list",
-  "Listet alle erreichbaren ProntoSite-Websites auf (Slug, Plan, letzte Änderung, offener Veröffentlichungs"
-    + "bedarf). Nützlich, um im Chat eine Website beim Namen zu nennen. LESEND.",
-  {},
-  async () => { try { return asText(await sitesList(cfg)); } catch (e) { return asError(e); } }
-);
-
-server.tool(
-  "account_create",
-  "SCHREIBEND (nur mit Betreuer-Token: admin/partner/agentur): Legt ein NEUES Kundenkonto an – der Dashboard-"
-    + "Weg „Kunde anlegen“. Nutze dieses Tool, BEVOR du eine Website importierst, wenn es für den Kunden noch "
-    + "KEIN Konto gibt (z. B. sites_list zeigt den Kunden nicht, oder der Nutzer sagt „für Kunde X gibt es noch "
-    + "kein Konto“). Erst Konto anlegen, dann mit der zurückgegebenen Konto-ID (k-…) per site_deploy und "
-    + "site=\"<k-id>:new\" die erste Website importieren. Richte KEIN site=new/Erst-Import ein, solange die "
-    + "Konto-ID unbekannt ist – dann zuerst dieses Tool. Mit email wird ein Login-Konto angelegt und eine "
-    + "Einladungs-Mail verschickt; ohne email ein verwaltetes Konto (ohne Login, Betrieb über den Betreuer). "
-    + "Partner/Agentur: das Konto wird DIR zugeordnet; Agentur-Kunden erhalten automatisch den Agentur-Plan "
-    + "(Abrechnung über die Agentur). Schutz: bei gleichem Namen/gleicher E-Mail kommt eine Warnung mit der "
-    + "bereits vorhandenen Konto-ID statt einer Doppelanlage – mit override:true trotzdem anlegen. "
-    + "Bitte VOR dem Aufruf bestätigen lassen (es wird ggf. eine Mail an den Kunden gesendet).",
-  { name: z.string().describe("Pflicht: Anzeigename des Kunden (z. B. Firmenname)."),
-    email: z.string().optional().describe("Optional: E-Mail des Kunden. Gesetzt → eingeladenes Login-Konto (Invite-Mail); weggelassen → verwaltetes Konto ohne Login."),
-    plan: z.enum(["free", "agentur-kunde"]).optional().describe("Optional. Standard richtet sich nach dem Betreuer-Konto (Agentur → agentur-kunde, sonst free). Nur angeben, wenn du den Standard bestätigen willst."),
-    note: z.string().optional().describe("Optionale interne Notiz – erscheint im Konto-Verlauf des neuen Kontos."),
-    override: z.boolean().default(false).describe("true = eine Namensdublette-Warnung übergehen und trotzdem ein weiteres Konto anlegen. Eine bereits vergebene E-Mail lässt sich NICHT erzwingen.") },
-  async ({ name, email, plan, note, override }) => {
-    try { return asText(await apiAccountCreate(cfg, { name, email, plan, note, override })); } catch (e) { return asError(e); }
-  }
-);
-
-server.tool(
-  "site_status",
-  "Status einer ProntoSite-Website: Plan, Slug, Live-URL, letzte Änderungen, offener Veröffentlichungs"
-    + "bedarf, draftRev und recentEdits (wer hat zuletzt wo geändert). VOR Änderungen lesen – draftRev ist die baseRev für "
-    + "site_file_put. LESEND – ändert nichts.",
-  { site: z.string().optional().describe(SITE_DESC) },
-  async ({ site }) => { try { return asText(await apiStatus(cfg, { site })); } catch (e) { return asError(e); } }
-);
-
-server.tool(
-  "site_export",
-  "Exportiert eine Website als ZIP in ein lokales Verzeichnis. which: 'published' (Live-Stand, Standard), "
-    + "'draft' (Entwurf) oder 'original' (flacher Stand ohne ProntoSite-Zutaten). LESEND.",
-  { site: z.string().optional().describe(SITE_DESC),
-    which: z.enum(["published", "draft", "original"]).default("published"),
-    outDir: z.string().default(".").describe("Zielordner für die ZIP-Datei (lokal).") },
-  async ({ site, which, outDir }) => { try { return asText(await apiExport(cfg, { site, which, outDir })); } catch (e) { return asError(e); } }
-);
-
-server.tool(
-  "site_deploy",
-  "SCHREIBEND: Übergibt eine lokale ZIP-Datei an ProntoSite (Import). Mit publish=true wird die Website "
-    + "DIREKT LIVE geschaltet und der bestehende Live-Stand überschrieben. ERST-IMPORT (neue Website): "
-    + "Einzel-Config site='new'; Multi-Site/Betreuer site='<label>:new' (legt im Konto DES LABELS an). "
-    + "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. "
-    + "REIHENFOLGE beim Erst-Import: zuerst Konto (account_create) → Firmendaten (company hier mitgeben ODER "
-    + "site_company_set) → Import; so stehen Impressum/Datenschutz sofort korrekt (ein Firmendaten-Set nach dem "
-    + "Import lässt die Rechts-Automatik automatisch neu laufen – kein zweiter Import nötig). "
-    + "WEBSITE-NAME: wird aus der Startseite abgeleitet (og:site_name → Titel-Präfix vor dem ersten Trenner → "
-    + "Header-H1/Logo-alt); mit name=… explizit setzen (Betreuer), falls die Ableitung danebenliegt. "
-    + "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. "
-    + "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). 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."),
-    name: z.string().optional().describe("Erst-Import: expliziter Website-Name (überschreibt die Ableitung aus der Startseite). Nützlich, wenn der Titel einen Ortszusatz trägt (z. B. 'Physio Phoenix – Bad Honnef Süd' → name='Physio Phoenix'). Bei Updates ignoriert."),
-    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."),
-    legal: z.boolean().optional().describe("Rechts-Automatik (Impressum/Datenschutz): true erzwingt, false schaltet ab."),
-    company: companyObject.optional().describe("Optional: Firmendaten VOR dem Deploy setzen (ein Schritt) – Impressum/Datenschutz nutzen sie dann direkt. Teil-Update."),
-    siteOverride: z.boolean().default(false).describe("Nur mit company: true = Firmendaten NUR für diese Website (statt konto-weit).") },
-  async ({ site, slug, name, customer, zipPath, publish, resetOverlay, legal, company, siteOverride }) => {
-    try { return asText(await apiDeploy(cfg, { site, slug, name, customer, zipPath, publish, resetOverlay, legal, company, siteOverride })); } catch (e) { return asError(e); }
-  }
-);
-
-server.tool(
-  "site_publish",
-  "SCHREIBEND: Veröffentlicht den aktuellen Stand einer Website ERNEUT (ohne ZIP) – z. B. um Plattform-"
-    + "Aktualisierungen live zu bringen. Meldet die Antwort nothing:true (keine erkannte Änderung), aber du "
-    + "willst trotzdem neu ausliefern, setze force:true. Bitte VOR dem Aufruf bestätigen lassen – und die richtige Website prüfen.",
-  { site: z.string().optional().describe(SITE_DESC),
-    force: z.boolean().default(false).describe("true = trotzdem veröffentlichen, auch ohne erkannte Änderung (wie der Menüpunkt Erneut veröffentlichen).") },
-  async ({ site, force }) => { try { return asText(await apiPublish(cfg, { site, force })); } catch (e) { return asError(e); } }
-);
-
-server.tool(
-  "site_company_get",
-  "Firmendaten (Impressum/Footer) einer Website lesen: effektiver Stand + konto-weite Angaben + ob eine "
-    + "Website-Abweichung gesetzt ist. LESEND – ändert nichts.",
-  { site: z.string().optional().describe(SITE_DESC) },
-  async ({ site }) => { try { return asText(await apiCompanyGet(cfg, { site })); } catch (e) { return asError(e); } }
-);
-
-server.tool(
-  "site_company_set",
-  "SCHREIBEND: Firmendaten des Kontos setzen/ergänzen (Name, Rechtsform, Inhaber, Anschrift, Kontakt, "
-    + "USt-IdNr., Register, Kammer/Beruf, Aufsicht, § 18 MStV, Social). Diese Daten füllen beim nächsten Deploy "
-    + "automatisch Impressum & Datenschutz. TEIL-UPDATE: nur die übergebenen Felder ändern sich. Du darfst die "
-    + "Angaben aus jeder Vorlage extrahieren (Impressum-Text, Visitenkarte, Freitext) und strukturiert übergeben. "
-    + "Default konto-weit; siteOverride=true nur, wenn DIESE eine Website abweichende Angaben braucht. NACH EINEM "
-    + "IMPORT lässt dieser Aufruf die Rechts-Automatik AUTOMATISCH neu laufen (Entwurf) – Impressum/Datenschutz "
-    + "übernehmen die Firmendaten sofort, ein zweiter Import ist NICHT nötig (die Antwort nennt die neu erzeugten "
-    + "Rechtstexte unter legal.refreshed); danach site_publish zum Live-Schalten. Bitte VOR dem Speichern die "
-    + "erkannten Felder kurz zusammenfassen und bestätigen lassen.",
-  { site: z.string().optional().describe(SITE_DESC),
-    company: companyObject,
-    siteOverride: z.boolean().default(false).describe("true = Firmendaten NUR für diese Website (statt konto-weit).") },
-  async ({ site, company, siteOverride }) => {
-    try { return asText(await apiCompanySet(cfg, { site, company, siteOverride })); } catch (e) { return asError(e); }
-  }
-);
-
-const legalOptShape = z.object({
-  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.");
-
-server.tool(
-  "site_legal_options",
-  "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. "
-    + "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),
-    impressum: legalOptShape.optional(),
-    datenschutz: legalOptShape.optional() },
-  async ({ site, impressum, datenschutz }) => {
-    try { return asText(await apiLegalOptions(cfg, { site, impressum, datenschutz })); } catch (e) { return asError(e); }
-  }
-);
-
-server.tool(
-  "site_domain_status",
-  "LESEND: Kundendomain-Status einer Website – verbundene Domains (kanonisch/Weiterleitung), Zertifikat-"
-    + "Gültigkeit und offene Verbindungs-Jobs. Mit `check` stattdessen NUR eine Live-DNS-Prüfung der angegebenen "
-    + "Domain (A-Record für @ und www muss auf den Server zeigen, kein AAAA) – ideal VOR dem Verbinden.",
-  { site: z.string().optional().describe(SITE_DESC),
-    check: z.string().optional().describe("Domain (z. B. ihre-firma.de) NUR auf DNS-Bereitschaft prüfen, nichts verbinden.") },
-  async ({ site, check }) => { try { return asText(await apiDomainStatus(cfg, { site, check })); } catch (e) { return asError(e); } }
-);
-
-server.tool(
-  "site_domain_connect",
-  "SCHREIBEND: eigene Domain mit der Website verbinden oder trennen. Beim Verbinden werden nginx-Serverblock "
-    + "und HTTPS-Zertifikat (Let's Encrypt) automatisch eingerichtet und die Domain als kanonische Adresse gesetzt "
-    + "(inkl. Republish für Canonical/Sitemap). VORAUSSETZUNG: der DNS zeigt bereits auf den Server – vorher IMMER "
-    + "site_domain_status mit `check` aufrufen und das Ergebnis bestätigen lassen. Nur ab Starter-Plan (Betreuer-/"
-    + "Operator-Token ausgenommen); eine Domain kann nur an EINER Website hängen. Läuft asynchron über eine Job-"
-    + "Queue – danach site_domain_status pollen. action='disconnect' trennt die Domain wieder.",
-  { site: z.string().optional().describe(SITE_DESC),
-    domain: z.string().describe("Die zu verbindende/trennende Domain, z. B. ihre-firma.de (mit oder ohne www)."),
-    canonical: z.enum(["www", "apex"]).default("www").describe("Kanonische Adresse: 'www' (mit www) oder 'apex' (ohne www). Nur beim Verbinden relevant."),
-    action: z.enum(["connect", "disconnect"]).default("connect").describe("connect = verbinden, disconnect = trennen.") },
-  async ({ site, domain, canonical, action }) => {
-    try { return asText(await apiDomainConnect(cfg, { site, domain, canonical, action })); } catch (e) { return asError(e); }
-  }
-);
-
-server.tool(
-  "site_embeds",
-  "LESEND: erkannte eingebettete Inhalte Dritter (iframes) einer Website – je Embed Host, Seite(n) und "
-    + "aktuelle Consent-Kategorie (`gated` = lädt erst nach Einwilligung / Zwei-Klick, `notwendig` = technisch "
-    + "erforderlich, lädt ohne Einwilligung). Basis für site_embed_consent.",
-  { site: z.string().optional().describe(SITE_DESC) },
-  async ({ site }) => { try { return asText(await apiEmbeds(cfg, { site })); } catch (e) { return asError(e); } }
-);
-
-server.tool(
-  "site_embed_consent",
-  "SCHREIBEND: ein Embed als `notwendig` (technisch erforderlich, § 25 Abs. 2 Nr. 2 TDDDG) oder zurück auf "
-    + "`gated` einstufen. Bei `notwendig` erklärt der Kunde/Betreuer, dass der Dienst für die vom Besucher "
-    + "gewünschte Funktion (z. B. Reservierung) UNBEDINGT ERFORDERLICH ist und übernimmt die Verantwortung – "
-    + "das MUSS mit dem Nutzer bestätigt werden (confirmed:true; sonst lehnt der Server mit dem Verantwortungs-"
-    + "Text ab). Dann lädt das Embed OHNE Einwilligung, aber nur auf der angegebenen Seite; der Datenschutz-Text "
-    + "passt sich automatisch an. Greift beim nächsten Veröffentlichen. Betreuer-Token gilt für betreute Kunden.",
-  { site: z.string().optional().describe(SITE_DESC),
-    host: z.string().describe("Embed-Host/Key aus site_embeds (z. B. 'resmio', 'youtube' oder ein Hostname)."),
-    page: z.string().optional().describe("Seiten-Datei, auf die die Einstufung beschränkt ist (z. B. 'reservierung.html'); leer = alle Seiten mit diesem Embed."),
-    category: z.enum(["notwendig", "gated"]).default("notwendig").describe("notwendig = technisch erforderlich (ohne Einwilligung); gated = zurück hinter das Consent-/Zwei-Klick-Gate."),
-    confirmed: z.boolean().default(false).describe("MUSS true sein, um 'notwendig' zu setzen (Verantwortungs-Bestätigung). Vorher den Nutzer explizit fragen.") },
-  async ({ site, host, page, category, confirmed }) => {
-    try { return asText(await apiEmbedConsent(cfg, { site, host, page, category, confirmed })); } catch (e) { return asError(e); }
-  }
-);
-
-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); }
-  }
-);
-
-// ---- Datei-API: kleine Änderungen am Entwurf direkt auf dem Server (Konzept §7) ----
-const FILE_SMALL = "Für kleine Änderungen am Entwurf ohne lokale Kopie; für größere Umbauten site_export (which='draft') → lokal bearbeiten → site_deploy. ";
-server.tool(
-  "site_files",
-  "LESEND: Listet die Dateien des Entwurfs einer Website (Pfad, Größe, Typ, ob bearbeitbar) und die aktuelle draftRev. "
-    + FILE_SMALL + "Ruf VORHER site_status auf; zeigt es kürzliche Änderungen anderer (recentEdits), sag das dem Nutzer, bevor du etwas änderst.",
-  { site: z.string().optional().describe(SITE_DESC) },
-  async ({ site }) => { try { return asText(await apiFiles(cfg, { site })); } catch (e) { return asError(e); } }
-);
-server.tool(
-  "site_file_get",
-  "LESEND: Liefert den Quelltext einer Datei des Entwurfs (Text; Binär als Base64, max. 5 MB) samt draftRev. "
-    + "Der Block overlay nennt Dashboard-Änderungen, die im Entwurf ÜBER diesem Quelltext liegen (sie gewinnen sichtbar) – "
-    + "berücksichtige sie, bevor du Text änderst. Merke dir draftRev: du brauchst sie als baseRev für site_file_put. " + FILE_SMALL,
-  { site: z.string().optional().describe(SITE_DESC), path: z.string().describe("Relativer Pfad, z. B. 'index.html' oder 'css/style.css' (aus site_files).") },
-  async ({ site, path }) => { try { return asText(await apiFileGet(cfg, { site, path })); } catch (e) { return asError(e); } }
-);
-server.tool(
-  "site_file_put",
-  "SCHREIBEND (Entwurf, nicht live; nur Betreuer-Token): Ersetzt den Inhalt einer Text-Datei (HTML einer bestehenden Seite, "
-    + "CSS, SVG, JSON, TXT …). PFLICHT: baseRev = draftRev aus deinem letzten site_file_get/site_status. Antwortet der Server mit "
-    + "conflict:true (409), hat jemand anderes dieselbe Datei inzwischen geändert: NICHT erzwingen – Datei neu holen, Änderung neu "
-    + "anwenden, mit der neuen draftRev erneut senden; die Antwort listet wer/wann/was. Prüfe danach overlay (umgehängte/deaktivierte "
-    + "Dashboard-Änderungen), sanitized und warnings und berichte sie dem Nutzer. Rechtstexte (Impressum/Datenschutz) nicht "
-    + "umformulieren – der Server lehnt das ab. Danach: site_status zeigt publishNeeded, live erst mit site_publish (vorher "
-    + "bestätigen lassen). " + FILE_SMALL,
-  { site: z.string().optional().describe(SITE_DESC),
-    path: z.string().describe("Relativer Pfad der Datei (bestehende Seite oder Text-Asset)."),
-    content: z.string().describe("Vollständiger neuer Dateiinhalt (Text, UTF-8, max. 1 MB)."),
-    baseRev: z.number().int().describe("draftRev, auf der deine Änderung beruht (aus site_file_get/site_status)."),
-    overlay: z.enum(["keep", "yield"]).default("keep").describe("keep = Dashboard-Änderungen bleiben über dem Quelltext; yield = wo deine Datei denselben Inhalt geändert hat, gewinnt die Datei.") },
-  async ({ site, path, content, baseRev, overlay }) => { try { return asText(await apiFilePut(cfg, { site, path, content, baseRev, overlay })); } catch (e) { return asError(e); } }
-);
-server.tool(
-  "site_file_delete",
-  "SCHREIBEND (Entwurf; nur Betreuer-Token): Markiert eine Text-Datei im Entwurf als gelöscht (rückgängig machbar; Seiten "
-    + "löschen geht über das Dashboard). baseRev Pflicht, confirmDestructive:true erst NACH Rückfrage beim Nutzer. Prüfe vorher, "
-    + "ob die Datei noch verlinkt ist. " + FILE_SMALL,
-  { site: z.string().optional().describe(SITE_DESC), path: z.string(), baseRev: z.number().int(),
-    confirmDestructive: z.boolean().default(false).describe("true erst nach ausdrücklicher Bestätigung durch den Nutzer.") },
-  async ({ site, path, baseRev, confirmDestructive }) => { try { return asText(await apiFileDelete(cfg, { site, path, baseRev, confirmDestructive })); } catch (e) { return asError(e); } }
-);
-server.tool(
-  "site_file_rename",
-  "SCHREIBEND (Entwurf; nur Betreuer-Token): Benennt eine Text-Datei (kein HTML) um. Verweise in anderen Dateien werden NICHT "
-    + "angepasst – die musst du selbst per site_file_put nachziehen. baseRev Pflicht. " + FILE_SMALL,
-  { site: z.string().optional().describe(SITE_DESC), from: z.string(), to: z.string(), baseRev: z.number().int() },
-  async ({ site, from, to, baseRev }) => { try { return asText(await apiFileRename(cfg, { site, from, to, baseRev })); } catch (e) { return asError(e); } }
-);
-
-server.tool(
-  "site_lock",
-  "Setzt eine sanfte Sperre „in Bearbeitung durch <dich>“ (2 h, verlängert sich bei jeder deiner Änderungen). Blockiert "
-    + "niemanden – andere sehen nur einen Hinweis und bekommen beim Speichern eine Warnung. Vor einer längeren Bearbeitungsserie "
-    + "setzen. Ist schon jemand anderes in Bearbeitung, kommt conflict/409 mit dem Hinweis – takeover:true NUR als Betreuer und nur "
-    + "nach Rückfrage beim Nutzer (die andere Person sieht die Übernahme).",
-  { site: z.string().optional().describe(SITE_DESC),
-    note: z.string().optional().describe("Optionale Notiz, z. B. „Startseite überarbeiten“ (andere sehen sie im Hinweis)."),
-    takeover: z.boolean().default(false).describe("true = fremde Sperre übernehmen (nur Betreuer, nach Rückfrage).") },
-  async ({ site, note, takeover }) => { try { return asText(await apiLock(cfg, { site, note, action: takeover ? "takeover" : "lock" })); } catch (e) { return asError(e); } }
-);
-server.tool(
-  "site_unlock",
-  "Gibt deine sanfte Sperre („in Bearbeitung“) frei – am Ende der Bearbeitung aufrufen. Ohne Sperre ein No-op.",
-  { site: z.string().optional().describe(SITE_DESC) },
-  async ({ site }) => { try { return asText(await apiLock(cfg, { site, action: "unlock" })); } catch (e) { return asError(e); } }
-);
+// instructions: Arbeitsweise (Weg B = Standard) – gleicher Text wie am Remote-Endpunkt.
+const server = new McpServer({ name: "prontosite", version: "0.12.0" }, { instructions: SERVER_INSTRUCTIONS });
+// Tool-Definitionen: gemeinsame Quelle mit dem Remote-Endpunkt (tools.mjs, Konzept KI-Anbindung §4.2).
+registerTools(server, { z, cfg, mode: "local" });
 
 // Den stdio-Server NUR starten, wenn diese Datei direkt ausgeführt wird (als MCP-Server / bin).
 // Beim bloßen Importieren (Smoke-Test / Tests) NICHT verbinden – sonst würde der Import auf stdin blockieren.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prontosite/mcp",
-  "version": "0.11.1",
+  "version": "0.12.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": {
@@ -8,13 +8,14 @@
   },
   "main": "index.mjs",
   "scripts": {
-    "check": "node --check index.mjs && node --check api.mjs",
+    "check": "node --check index.mjs && node --check api.mjs && node --check tools.mjs",
     "smoke": "node smoke.mjs",
     "prepublishOnly": "npm run check && npm run smoke"
   },
   "files": [
     "index.mjs",
     "api.mjs",
+    "tools.mjs",
     "README.md",
     "CHANGELOG.md"
   ],
@@ -35,7 +36,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.31.0",
     "zod": "^3.23.0"
   }
 }

package/tools.mjs

@@ -0,0 +1,454 @@
+/**
+ * ProntoSite MCP – gemeinsame Tool-Quelle (docs/konzept-ki-anbindung.md §4.2). EINMAL definiert, benutzt vom
+ * lokalen Paket (stdio, index.mjs) UND vom Remote-Endpunkt https://app.prontosite.io/mcp (src/server/mcp-remote.js).
+ * Jedes Tool ruft nur api.mjs → die REST-API (lokal über HTTPS, remote über den internen Loopback mit dem Token des
+ * Aufrufers) – dieselben Gates, Handler, 409/Guards. Kein Tool ruft Store-Funktionen direkt.
+ *
+ * mode "local":  Export/Deploy mit lokalen Pfaden (outDir/zipPath).
+ * mode "remote": Export als Download-Link, Deploy über Upload-Link + deploy_commit (B-K4); account_create und
+ *                site_domain_connect nur mit Betreuer-Token (Entscheidung 9a).
+ * `z` wird vom Aufrufer übergeben (dieselbe zod-Instanz wie sein MCP-SDK).
+ */
+import { apiEditText, apiStatus, apiExport, apiExportFetch, apiDeploy, apiPublish, sitesList, apiAccountCreate, apiCompanyGet, apiCompanySet, apiLegalOptions, apiDomainStatus, apiDomainConnect, apiEmbeds, apiEmbedConsent, apiWidgets, apiWidgetSet, apiFiles, apiFileGet, apiFilePut, apiFileDelete, apiFileRename, apiLock } from "./api.mjs";
+
+/**
+ * Arbeitsweise (MCP-`instructions` beim Initialize – lokal UND /mcp): Weg B ist der Standard (Nick 19.10.).
+ * Direkt am Server-Entwurf arbeiten; Export + Deploy nur auf ausdrücklichen Wunsch bzw. für Komplett-Umbauten.
+ */
+export const SERVER_INSTRUCTIONS = [
+  "ProntoSite – so arbeitest du mit einer Website:",
+  "1. STANDARD: direkt am Server-Entwurf arbeiten. Ablauf: site_status (Stand, draftRev, wer zuletzt geändert hat) → Änderung mit "
+    + "site_edit_text (Text suchen und ersetzen über alle Seiten) bzw. site_file_get/site_file_put (HTML/CSS) → site_status (Kontrolle). "
+    + "Danach dem Nutzer sagen, was geändert wurde, und den Vorschau-Link (previewUrl aus site_status) nennen.",
+  "2. AUSNAHME: site_export + Deploy (site_deploy bzw. deploy_upload_begin/deploy_commit) NUR, wenn der Nutzer ausdrücklich lokal arbeiten "
+    + "möchte oder die Website komplett umgebaut wird.",
+  "3. Veröffentlichen (site_publish, publish=true) NUR nach ausdrücklicher Bestätigung des Nutzers im Chat – bis dahin bleibt alles im Entwurf.",
+  "4. Konflikt (409, conflict:true): nicht erzwingen. Erst site_status aufrufen (zeigt, wer was geändert hat), Inhalt neu holen, Änderung "
+    + "neu anwenden und mit der neuen draftRev erneut senden.",
+  "5. Jede Änderung lässt sich rückgängig machen; Rechtstexte (Impressum/Datenschutz) nicht umformulieren – sie kommen aus den Firmendaten.",
+].join("\n");
+
+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)) }] });
+
+/** Alle Tools am MCP-Server registrieren. */
+export function registerTools(server, { z, cfg, mode = "local", remote = null }) {
+  const SITE_DESC = mode === "remote"
+    ? "Website-Slug (z. B. 'mas-monti') oder stabile Site-ID (s-…). Ohne Angabe die Website des Tokens. Betreuer-Token: "
+      + "die gewünschte Website angeben (sites_list zeigt alle)."
+    : "Website-Slug (z. B. 'mas-monti'). Ohne Angabe die Standard-Site der Config. Bei Betreuer-"
+      + "Config (mehrere Sites) hier die gewünschte Website angeben.";
+
+  // Firmendaten-Felder (identisch zum Dashboard-Formular / Sanitizer). Nur gesetzte Felder werden geändert.
+  const companyObject = z.object({
+    name: z.string().optional().describe("Firmenname"),
+    legalForm: z.string().optional().describe("Rechtsform (z. B. GmbH, UG, Einzelunternehmen, Freiberufler)"),
+    representative: z.string().optional().describe("Inhaber / Vertretungsberechtigte:r"),
+    street: z.string().optional().describe("Straße und Hausnummer"),
+    zip: z.string().optional().describe("PLZ"),
+    city: z.string().optional().describe("Ort"),
+    country: z.string().optional().describe("Land"),
+    email: z.string().optional().describe("E-Mail-Adresse (Impressum)"),
+    phone: z.string().optional().describe("Telefon"),
+    fax: z.string().optional().describe("Fax"),
+    vatId: z.string().optional().describe("USt-IdNr."),
+    registerCourt: z.string().optional().describe("Registergericht"),
+    registerNumber: z.string().optional().describe("Handelsregister-Nr."),
+    kammer: z.string().optional().describe("Zuständige Kammer (reglementierte Berufe)"),
+    berufsbezeichnung: z.string().optional().describe("Berufsbezeichnung (reglementierte Berufe)"),
+    aufsichtsbehoerde: z.string().optional().describe("Aufsichtsbehörde (erlaubnispflichtige Gewerbe)"),
+    verantwortlichMStV: z.string().optional().describe("Verantwortlich i.S.d. § 18 Abs. 2 MStV (falls abweichend)"),
+    berufshaftpflicht: z.string().optional().describe("Berufshaftpflichtversicherung (Name, Ort, Geltungsraum)"),
+    social: z.array(z.object({ label: z.string(), href: z.string() })).optional().describe("Social-Links [{label,href}] (href muss http/https sein)"),
+  }).describe("Firmendaten fürs Impressum/Footer – Teil-Update: nur gesetzte Felder ändern sich.");
+
+  server.tool(
+    "sites_list",
+    "Listet alle erreichbaren ProntoSite-Websites auf (Slug, Plan, letzte Änderung, offener Veröffentlichungs"
+      + "bedarf). Nützlich, um im Chat eine Website beim Namen zu nennen. LESEND.",
+    {},
+    async () => { try { return asText(await sitesList(cfg)); } catch (e) { return asError(e); } }
+  );
+
+  // Kundenkonto anlegen: lokal immer; remote nur mit Betreuer-Token (Entscheidung 9a – nicht im Standard).
+  if (mode === "local" || remote?.isManager) {
+    server.tool(
+      "account_create",
+      "SCHREIBEND (nur mit Betreuer-Token: admin/partner/agentur): Legt ein NEUES Kundenkonto an – der Dashboard-"
+        + "Weg „Kunde anlegen“. Nutze dieses Tool, BEVOR du eine Website importierst, wenn es für den Kunden noch "
+        + "KEIN Konto gibt (z. B. sites_list zeigt den Kunden nicht, oder der Nutzer sagt „für Kunde X gibt es noch "
+        + "kein Konto“). Erst Konto anlegen, dann mit der zurückgegebenen Konto-ID (k-…) per site_deploy und "
+        + "site=\"<k-id>:new\" die erste Website importieren. Richte KEIN site=new/Erst-Import ein, solange die "
+        + "Konto-ID unbekannt ist – dann zuerst dieses Tool. Mit email wird ein Login-Konto angelegt und eine "
+        + "Einladungs-Mail verschickt; ohne email ein verwaltetes Konto (ohne Login, Betrieb über den Betreuer). "
+        + "Partner/Agentur: das Konto wird DIR zugeordnet; Agentur-Kunden erhalten automatisch den Agentur-Plan "
+        + "(Abrechnung über die Agentur). Schutz: bei gleichem Namen/gleicher E-Mail kommt eine Warnung mit der "
+        + "bereits vorhandenen Konto-ID statt einer Doppelanlage – mit override:true trotzdem anlegen. "
+        + "Bitte VOR dem Aufruf bestätigen lassen (es wird ggf. eine Mail an den Kunden gesendet).",
+      { name: z.string().describe("Pflicht: Anzeigename des Kunden (z. B. Firmenname)."),
+        email: z.string().optional().describe("Optional: E-Mail des Kunden. Gesetzt → eingeladenes Login-Konto (Invite-Mail); weggelassen → verwaltetes Konto ohne Login."),
+        plan: z.enum(["free", "agentur-kunde"]).optional().describe("Optional. Standard richtet sich nach dem Betreuer-Konto (Agentur → agentur-kunde, sonst free). Nur angeben, wenn du den Standard bestätigen willst."),
+        note: z.string().optional().describe("Optionale interne Notiz – erscheint im Konto-Verlauf des neuen Kontos."),
+        override: z.boolean().default(false).describe("true = eine Namensdublette-Warnung übergehen und trotzdem ein weiteres Konto anlegen. Eine bereits vergebene E-Mail lässt sich NICHT erzwingen.") },
+      async ({ name, email, plan, note, override }) => {
+        try { return asText(await apiAccountCreate(cfg, { name, email, plan, note, override })); } catch (e) { return asError(e); }
+      }
+    );
+  }
+  server.tool(
+    "site_status",
+    "LESEND – SCHRITT 1 und letzter Schritt jeder Änderung: Status einer ProntoSite-Website: Plan, Slug, Live-URL, Vorschau-Link "
+      + "(previewUrl), letzte Änderungen, offener Veröffentlichungsbedarf (publishNeeded), draftRev und recentEdits (wer hat zuletzt "
+      + "wo geändert). draftRev ist die baseRev für site_edit_text/site_file_put. Ändert nichts.",
+    { site: z.string().optional().describe(SITE_DESC) },
+    async ({ site }) => { try { return asText(await apiStatus(cfg, { site })); } catch (e) { return asError(e); } }
+  );
+
+  server.tool(
+    "site_edit_text",
+    "SCHREIBEND (Entwurf, nicht live) – STANDARDWEG für Textänderungen (Telefonnummer, Öffnungszeiten, Preise, Sätze): sucht `find` "
+      + "im sichtbaren Text ALLER Seiten und ersetzt ihn durch `replace` – als eine rückgängig machbare Änderung, Formatierung bleibt. "
+      + "Gibt es mehr als eine Fundstelle und du hast keine pages angegeben, ändert der Server NICHTS und liefert nur die Liste "
+      + "(Seite, Knoten, Kontext): zeig sie dem Nutzer bzw. entscheide anhand des Kontexts und ruf das Tool erneut mit pages:[…] auf "
+      + "(alle Fundstellen dieser Seiten werden ersetzt). Rechtstexte und geschützte Bereiche werden nie geändert (skipped). "
+      + "linkHints nennt tel:/mailto:-Links mit dem alten Wert – die ändert dieses Tool nicht (ggf. site_file_put). "
+      + "Vorher site_status, danach site_status; live erst nach Bestätigung mit site_publish.",
+    { site: z.string().optional().describe(SITE_DESC),
+      find: z.string().describe("Genau der Text, wie er auf der Website steht (z. B. '02242 123456')."),
+      replace: z.string().describe("Neuer Text (reiner Text)."),
+      pages: z.array(z.string()).optional().describe("Optional: Seiten-IDs (aus der Fundstellen-Liste), auf denen ersetzt werden soll. Ohne Angabe nur bei genau EINER Fundstelle."),
+      baseRev: z.number().int().optional().describe("Optional: draftRev aus site_status (Konfliktschutz, 409 bei zwischenzeitlicher Änderung derselben Seite).") },
+    async ({ site, find, replace, pages, baseRev }) => { try { return asText(await apiEditText(cfg, { site, find, replace, pages, baseRev })); } catch (e) { return asError(e); } }
+  );
+
+  if (mode === "local") {
+    server.tool(
+      "site_export",
+      "AUSNAHME – nur wenn der Nutzer ausdrücklich lokal arbeiten möchte oder für größere Umbauten (sonst site_edit_text/site_file_*): "
+        + "Exportiert eine Website als ZIP in ein lokales Verzeichnis. which: 'published' (Live-Stand, Standard), "
+        + "'draft' (Entwurf – zum Weiterbearbeiten) oder 'original' (flacher Stand ohne ProntoSite-Zutaten). LESEND.",
+      { site: z.string().optional().describe(SITE_DESC),
+        which: z.enum(["published", "draft", "original"]).default("published"),
+        outDir: z.string().default(".").describe("Zielordner für die ZIP-Datei (lokal).") },
+      async ({ site, which, outDir }) => { try { return asText(await apiExport(cfg, { site, which, outDir })); } catch (e) { return asError(e); } }
+    );
+
+
+    server.tool(
+      "site_deploy",
+      "SCHREIBEND – AUSNAHME: nur für Erst-Import, ausdrücklichen Wunsch nach lokaler Arbeit oder größere Umbauten (kleine Änderungen: "
+        + "site_edit_text/site_file_put). Übergibt eine lokale ZIP-Datei an ProntoSite (Import). Bei Updates PFLICHT: baseRev – exportiere "
+        + "vorher mit site_export (which='draft'), die ZIP trägt ihren Stand dann automatisch; sonst baseRev = draftRev aus site_status. Mit publish=true wird die Website "
+        + "DIREKT LIVE geschaltet und der bestehende Live-Stand überschrieben. ERST-IMPORT (neue Website): "
+        + "Einzel-Config site='new'; Multi-Site/Betreuer site='<label>:new' (legt im Konto DES LABELS an). "
+        + "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. "
+        + "REIHENFOLGE beim Erst-Import: zuerst Konto (account_create) → Firmendaten (company hier mitgeben ODER "
+        + "site_company_set) → Import; so stehen Impressum/Datenschutz sofort korrekt (ein Firmendaten-Set nach dem "
+        + "Import lässt die Rechts-Automatik automatisch neu laufen – kein zweiter Import nötig). "
+        + "WEBSITE-NAME: wird aus der Startseite abgeleitet (og:site_name → Titel-Präfix vor dem ersten Trenner → "
+        + "Header-H1/Logo-alt); mit name=… explizit setzen (Betreuer), falls die Ableitung danebenliegt. "
+        + "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. "
+        + "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). 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."),
+        name: z.string().optional().describe("Erst-Import: expliziter Website-Name (überschreibt die Ableitung aus der Startseite). Nützlich, wenn der Titel einen Ortszusatz trägt (z. B. 'Physio Phoenix – Bad Honnef Süd' → name='Physio Phoenix'). Bei Updates ignoriert."),
+        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)."),
+        baseRev: z.number().int().optional().describe("Update ohne Export-ZIP: draftRev aus site_status (sonst lehnt der Server mit 428 ab). Bei ZIPs aus site_export nicht nötig."),
+        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."),
+        legal: z.boolean().optional().describe("Rechts-Automatik (Impressum/Datenschutz): true erzwingt, false schaltet ab."),
+        company: companyObject.optional().describe("Optional: Firmendaten VOR dem Deploy setzen (ein Schritt) – Impressum/Datenschutz nutzen sie dann direkt. Teil-Update."),
+        siteOverride: z.boolean().default(false).describe("Nur mit company: true = Firmendaten NUR für diese Website (statt konto-weit).") },
+      async ({ site, slug, name, customer, zipPath, baseRev, publish, resetOverlay, legal, company, siteOverride }) => {
+        try { return asText(await apiDeploy(cfg, { site, slug, name, customer, zipPath, baseRev, publish, resetOverlay, legal, company, siteOverride })); } catch (e) { return asError(e); }
+      }
+    );
+
+  } else {
+    registerRemoteTransferTools(server, { z, cfg, remote, SITE_DESC, asText, asError });
+  }
+  server.tool(
+    "site_publish",
+    "SCHREIBEND – LIVE FÜR BESUCHER: Veröffentlicht den aktuellen Entwurf einer Website. NUR nach ausdrücklicher Bestätigung "
+      + "des Nutzers im Chat aufrufen (vorher kurz zusammenfassen, was live geht, und die richtige Website prüfen). Meldet die Antwort "
+      + "nothing:true (keine erkannte Änderung), aber du willst trotzdem neu ausliefern, setze force:true.",
+    { site: z.string().optional().describe(SITE_DESC),
+      force: z.boolean().default(false).describe("true = trotzdem veröffentlichen, auch ohne erkannte Änderung (wie der Menüpunkt Erneut veröffentlichen).") },
+    async ({ site, force }) => { try { return asText(await apiPublish(cfg, { site, force })); } catch (e) { return asError(e); } }
+  );
+
+  server.tool(
+    "site_company_get",
+    "Firmendaten (Impressum/Footer) einer Website lesen: effektiver Stand + konto-weite Angaben + ob eine "
+      + "Website-Abweichung gesetzt ist. LESEND – ändert nichts.",
+    { site: z.string().optional().describe(SITE_DESC) },
+    async ({ site }) => { try { return asText(await apiCompanyGet(cfg, { site })); } catch (e) { return asError(e); } }
+  );
+
+  server.tool(
+    "site_company_set",
+    "SCHREIBEND: Firmendaten des Kontos setzen/ergänzen (Name, Rechtsform, Inhaber, Anschrift, Kontakt, "
+      + "USt-IdNr., Register, Kammer/Beruf, Aufsicht, § 18 MStV, Social). Diese Daten füllen beim nächsten Deploy "
+      + "automatisch Impressum & Datenschutz. TEIL-UPDATE: nur die übergebenen Felder ändern sich. Du darfst die "
+      + "Angaben aus jeder Vorlage extrahieren (Impressum-Text, Visitenkarte, Freitext) und strukturiert übergeben. "
+      + "Default konto-weit; siteOverride=true nur, wenn DIESE eine Website abweichende Angaben braucht. NACH EINEM "
+      + "IMPORT lässt dieser Aufruf die Rechts-Automatik AUTOMATISCH neu laufen (Entwurf) – Impressum/Datenschutz "
+      + "übernehmen die Firmendaten sofort, ein zweiter Import ist NICHT nötig (die Antwort nennt die neu erzeugten "
+      + "Rechtstexte unter legal.refreshed); danach site_publish zum Live-Schalten. Bitte VOR dem Speichern die "
+      + "erkannten Felder kurz zusammenfassen und bestätigen lassen.",
+    { site: z.string().optional().describe(SITE_DESC),
+      company: companyObject,
+      siteOverride: z.boolean().default(false).describe("true = Firmendaten NUR für diese Website (statt konto-weit).") },
+    async ({ site, company, siteOverride }) => {
+      try { return asText(await apiCompanySet(cfg, { site, company, siteOverride })); } catch (e) { return asError(e); }
+    }
+  );
+
+  const legalOptShape = z.object({
+    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.");
+
+  server.tool(
+    "site_legal_options",
+    "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. "
+      + "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),
+      impressum: legalOptShape.optional(),
+      datenschutz: legalOptShape.optional() },
+    async ({ site, impressum, datenschutz }) => {
+      try { return asText(await apiLegalOptions(cfg, { site, impressum, datenschutz })); } catch (e) { return asError(e); }
+    }
+  );
+
+  server.tool(
+    "site_domain_status",
+    "LESEND: Kundendomain-Status einer Website – verbundene Domains (kanonisch/Weiterleitung), Zertifikat-"
+      + "Gültigkeit und offene Verbindungs-Jobs. Mit `check` stattdessen NUR eine Live-DNS-Prüfung der angegebenen "
+      + "Domain (A-Record für @ und www muss auf den Server zeigen, kein AAAA) – ideal VOR dem Verbinden.",
+    { site: z.string().optional().describe(SITE_DESC),
+      check: z.string().optional().describe("Domain (z. B. ihre-firma.de) NUR auf DNS-Bereitschaft prüfen, nichts verbinden.") },
+    async ({ site, check }) => { try { return asText(await apiDomainStatus(cfg, { site, check })); } catch (e) { return asError(e); } }
+  );
+
+  // Domain verbinden ist kundenwirksam: remote nur mit Betreuer-Token (Entscheidung 9a).
+  if (mode === "local" || remote?.isManager) {
+    server.tool(
+      "site_domain_connect",
+      "SCHREIBEND: eigene Domain mit der Website verbinden oder trennen. Beim Verbinden werden nginx-Serverblock "
+        + "und HTTPS-Zertifikat (Let's Encrypt) automatisch eingerichtet und die Domain als kanonische Adresse gesetzt "
+        + "(inkl. Republish für Canonical/Sitemap). VORAUSSETZUNG: der DNS zeigt bereits auf den Server – vorher IMMER "
+        + "site_domain_status mit `check` aufrufen und das Ergebnis bestätigen lassen. Nur ab Starter-Plan (Betreuer-/"
+        + "Operator-Token ausgenommen); eine Domain kann nur an EINER Website hängen. Läuft asynchron über eine Job-"
+        + "Queue – danach site_domain_status pollen. action='disconnect' trennt die Domain wieder.",
+      { site: z.string().optional().describe(SITE_DESC),
+        domain: z.string().describe("Die zu verbindende/trennende Domain, z. B. ihre-firma.de (mit oder ohne www)."),
+        canonical: z.enum(["www", "apex"]).default("www").describe("Kanonische Adresse: 'www' (mit www) oder 'apex' (ohne www). Nur beim Verbinden relevant."),
+        action: z.enum(["connect", "disconnect"]).default("connect").describe("connect = verbinden, disconnect = trennen.") },
+      async ({ site, domain, canonical, action }) => {
+        try { return asText(await apiDomainConnect(cfg, { site, domain, canonical, action })); } catch (e) { return asError(e); }
+      }
+    );
+  }
+  server.tool(
+    "site_embeds",
+    "LESEND: erkannte eingebettete Inhalte Dritter (iframes) einer Website – je Embed Host, Seite(n) und "
+      + "aktuelle Consent-Kategorie (`gated` = lädt erst nach Einwilligung / Zwei-Klick, `notwendig` = technisch "
+      + "erforderlich, lädt ohne Einwilligung). Basis für site_embed_consent.",
+    { site: z.string().optional().describe(SITE_DESC) },
+    async ({ site }) => { try { return asText(await apiEmbeds(cfg, { site })); } catch (e) { return asError(e); } }
+  );
+
+  server.tool(
+    "site_embed_consent",
+    "SCHREIBEND: ein Embed als `notwendig` (technisch erforderlich, § 25 Abs. 2 Nr. 2 TDDDG) oder zurück auf "
+      + "`gated` einstufen. Bei `notwendig` erklärt der Kunde/Betreuer, dass der Dienst für die vom Besucher "
+      + "gewünschte Funktion (z. B. Reservierung) UNBEDINGT ERFORDERLICH ist und übernimmt die Verantwortung – "
+      + "das MUSS mit dem Nutzer bestätigt werden (confirmed:true; sonst lehnt der Server mit dem Verantwortungs-"
+      + "Text ab). Dann lädt das Embed OHNE Einwilligung, aber nur auf der angegebenen Seite; der Datenschutz-Text "
+      + "passt sich automatisch an. Greift beim nächsten Veröffentlichen. Betreuer-Token gilt für betreute Kunden.",
+    { site: z.string().optional().describe(SITE_DESC),
+      host: z.string().describe("Embed-Host/Key aus site_embeds (z. B. 'resmio', 'youtube' oder ein Hostname)."),
+      page: z.string().optional().describe("Seiten-Datei, auf die die Einstufung beschränkt ist (z. B. 'reservierung.html'); leer = alle Seiten mit diesem Embed."),
+      category: z.enum(["notwendig", "gated"]).default("notwendig").describe("notwendig = technisch erforderlich (ohne Einwilligung); gated = zurück hinter das Consent-/Zwei-Klick-Gate."),
+      confirmed: z.boolean().default(false).describe("MUSS true sein, um 'notwendig' zu setzen (Verantwortungs-Bestätigung). Vorher den Nutzer explizit fragen.") },
+    async ({ site, host, page, category, confirmed }) => {
+      try { return asText(await apiEmbedConsent(cfg, { site, host, page, category, confirmed })); } catch (e) { return asError(e); }
+    }
+  );
+
+  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); }
+    }
+  );
+
+  // ---- 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) ändern nur Betreuer und nur bei JavaScript-Freigabe der Website – Kunden bekommen dort 403. ";
+  server.tool(
+    "site_files",
+    "LESEND: Listet die Dateien des Entwurfs einer Website (Pfad, Größe, Typ, ob bearbeitbar) und die aktuelle draftRev. "
+      + FILE_SMALL + "Ruf VORHER site_status auf; zeigt es kürzliche Änderungen anderer (recentEdits), sag das dem Nutzer, bevor du etwas änderst.",
+    { site: z.string().optional().describe(SITE_DESC) },
+    async ({ site }) => { try { return asText(await apiFiles(cfg, { site })); } catch (e) { return asError(e); } }
+  );
+  server.tool(
+    "site_file_get",
+    "LESEND: Liefert den Quelltext einer Datei des Entwurfs (Text; Binär als Base64, max. 5 MB) samt draftRev. "
+      + "Der Block overlay nennt Dashboard-Änderungen, die im Entwurf ÜBER diesem Quelltext liegen (sie gewinnen sichtbar) – "
+      + "berücksichtige sie, bevor du Text änderst. Merke dir draftRev: du brauchst sie als baseRev für site_file_put. " + FILE_SMALL,
+    { site: z.string().optional().describe(SITE_DESC), path: z.string().describe("Relativer Pfad, z. B. 'index.html' oder 'css/style.css' (aus site_files).") },
+    async ({ site, path }) => { try { return asText(await apiFileGet(cfg, { site, path })); } catch (e) { return asError(e); } }
+  );
+  server.tool(
+    "site_file_put",
+    "SCHREIBEND (Entwurf, nicht live): Ersetzt den Inhalt einer Text-Datei (HTML einer bestehenden Seite, "
+      + "CSS, SVG, JSON, TXT …). PFLICHT: baseRev = draftRev aus deinem letzten site_file_get/site_status. Antwortet der Server mit "
+      + "conflict:true (409), hat jemand anderes dieselbe Datei inzwischen geändert: NICHT erzwingen – Datei neu holen, Änderung neu "
+      + "anwenden, mit der neuen draftRev erneut senden; die Antwort listet wer/wann/was. Prüfe danach overlay (umgehängte/deaktivierte "
+      + "Dashboard-Änderungen), sanitized und warnings und berichte sie dem Nutzer. Rechtstexte (Impressum/Datenschutz) nicht "
+      + "umformulieren – der Server lehnt das ab. Danach: site_status zeigt publishNeeded, live erst mit site_publish (vorher "
+      + "bestätigen lassen). " + FILE_SMALL,
+    { site: z.string().optional().describe(SITE_DESC),
+      path: z.string().describe("Relativer Pfad der Datei (bestehende Seite oder Text-Asset)."),
+      content: z.string().describe("Vollständiger neuer Dateiinhalt (Text, UTF-8, max. 1 MB)."),
+      baseRev: z.number().int().describe("draftRev, auf der deine Änderung beruht (aus site_file_get/site_status)."),
+      overlay: z.enum(["keep", "yield"]).default("keep").describe("keep = Dashboard-Änderungen bleiben über dem Quelltext; yield = wo deine Datei denselben Inhalt geändert hat, gewinnt die Datei.") },
+    async ({ site, path, content, baseRev, overlay }) => { try { return asText(await apiFilePut(cfg, { site, path, content, baseRev, overlay })); } catch (e) { return asError(e); } }
+  );
+  server.tool(
+    "site_file_delete",
+    "SCHREIBEND (Entwurf): Markiert eine Text-Datei im Entwurf als gelöscht (rückgängig machbar; Seiten "
+      + "löschen geht über das Dashboard). baseRev Pflicht, confirmDestructive:true erst NACH Rückfrage beim Nutzer. Prüfe vorher, "
+      + "ob die Datei noch verlinkt ist. " + FILE_SMALL,
+    { site: z.string().optional().describe(SITE_DESC), path: z.string(), baseRev: z.number().int(),
+      confirmDestructive: z.boolean().default(false).describe("true erst nach ausdrücklicher Bestätigung durch den Nutzer.") },
+    async ({ site, path, baseRev, confirmDestructive }) => { try { return asText(await apiFileDelete(cfg, { site, path, baseRev, confirmDestructive })); } catch (e) { return asError(e); } }
+  );
+  server.tool(
+    "site_file_rename",
+    "SCHREIBEND (Entwurf): Benennt eine Text-Datei (kein HTML) um. Verweise in anderen Dateien werden NICHT "
+      + "angepasst – die musst du selbst per site_file_put nachziehen. baseRev Pflicht. " + FILE_SMALL,
+    { site: z.string().optional().describe(SITE_DESC), from: z.string(), to: z.string(), baseRev: z.number().int() },
+    async ({ site, from, to, baseRev }) => { try { return asText(await apiFileRename(cfg, { site, from, to, baseRev })); } catch (e) { return asError(e); } }
+  );
+
+  server.tool(
+    "site_lock",
+    "Setzt eine sanfte Sperre „in Bearbeitung durch <dich>“ (2 h, verlängert sich bei jeder deiner Änderungen). Blockiert "
+      + "niemanden – andere sehen nur einen Hinweis und bekommen beim Speichern eine Warnung. Vor einer längeren Bearbeitungsserie "
+      + "setzen. Ist schon jemand anderes in Bearbeitung, kommt conflict/409 mit dem Hinweis – takeover:true NUR als Betreuer und nur "
+      + "nach Rückfrage beim Nutzer (die andere Person sieht die Übernahme).",
+    { site: z.string().optional().describe(SITE_DESC),
+      note: z.string().optional().describe("Optionale Notiz, z. B. „Startseite überarbeiten“ (andere sehen sie im Hinweis)."),
+      takeover: z.boolean().default(false).describe("true = fremde Sperre übernehmen (nur Betreuer, nach Rückfrage).") },
+    async ({ site, note, takeover }) => { try { return asText(await apiLock(cfg, { site, note, action: takeover ? "takeover" : "lock" })); } catch (e) { return asError(e); } }
+  );
+  server.tool(
+    "site_unlock",
+    "Gibt deine sanfte Sperre („in Bearbeitung“) frei – am Ende der Bearbeitung aufrufen. Ohne Sperre ein No-op.",
+    { site: z.string().optional().describe(SITE_DESC) },
+    async ({ site }) => { try { return asText(await apiLock(cfg, { site, action: "unlock" })); } catch (e) { return asError(e); } }
+  );
+}
+
+/** Remote: Export als Download-Link, Deploy per Upload-Link (der Remote-Server kann keine lokalen Pfade lesen). */
+function registerRemoteTransferTools(server, { z, cfg, remote, SITE_DESC, asText, asError }) {
+  server.tool(
+    "site_export",
+    "AUSNAHME – nur wenn der Nutzer ausdrücklich lokal arbeiten möchte oder für größere Umbauten (sonst site_edit_text/site_file_*). "
+      + "LESEND: Exportiert eine Website als ZIP und liefert einen DOWNLOAD-LINK (15 Minuten gültig, nur EINMAL abrufbar). "
+      + "which: 'published' (Live-Stand, Standard), 'draft' (Entwurf – für lokales Bearbeiten und späteres deploy_upload_begin) oder "
+      + "'original' (flacher Stand ohne ProntoSite-Zutaten). Den Link mit curl/Browser laden, z. B. curl -o site.zip '<downloadUrl>'.",
+    { site: z.string().optional().describe(SITE_DESC),
+      which: z.enum(["published", "draft", "original"]).default("published") },
+    async ({ site, which }) => {
+      try {
+        const { buf, name, slug } = await apiExportFetch(cfg, { site, which });
+        return asText({ ...remote.storeDownload(buf, name), which, site: slug });
+      } catch (e) { return asError(e); }
+    }
+  );
+  server.tool(
+    "deploy_upload_begin",
+    "SCHREIBEND – AUSNAHME: nur für Erst-Import, ausdrücklichen Wunsch nach lokaler Arbeit oder größere Umbauten (kleine Änderungen: "
+      + "site_edit_text/site_file_put). Schritt 1 von 2: ZIP-Deploy vorbereiten. Liefert einen UPLOAD-LINK (HTTP PUT, 15 Minuten, einmalig, max. "
+      + "100 MB) für die ZIP-Datei der Website, z. B. curl -T site.zip '<uploadUrl>'. Danach deploy_commit mit der uploadId. "
+      + "Ein Deploy ersetzt das Original der Website (rückholbar über die Re-Import-Zeitleiste); mit publish=true geht der Stand "
+      + "DIREKT LIVE. Ab dem Starter-Tarif. Bitte VOR dem Aufruf bestätigen lassen – und die richtige Website prüfen. "
+      + "Für kleine Änderungen ohne ZIP: site_file_put. Exportiere vorher mit site_export (which='draft'): die ZIP trägt dann "
+      + "ihren Stand (draftRev) und der Server meldet 409, wenn der Entwurf inzwischen geändert wurde.",
+    { site: z.string().optional().describe(SITE_DESC + (remote?.isManager ? " Erst-Import (Betreuer): '<Konto-ID>:new' (k-…)." : "")),
+      slug: z.string().optional().describe("Erst-Import: gewünschte Web-Adresse (Subdomain-Label). Bei Updates ignoriert."),
+      name: z.string().optional().describe("Erst-Import: expliziter Website-Name. Bei Updates ignoriert."),
+      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."),
+      legal: z.boolean().optional().describe("Rechts-Automatik (Impressum/Datenschutz): true erzwingt, false schaltet ab."),
+      baseRev: z.number().int().optional().describe("Update ohne Export-ZIP: draftRev aus site_status (Pflicht, sonst 428). ZIPs aus site_export tragen ihn automatisch.") },
+    async ({ site, slug, name, publish, resetOverlay, legal, baseRev }) => {
+      try { return asText(remote.beginUpload({ site, slug, name, publish, resetOverlay, legal, baseRev })); } catch (e) { return asError(e); }
+    }
+  );
+  server.tool(
+    "deploy_commit",
+    "SCHREIBEND (Schritt 2 von 2): übernimmt die per deploy_upload_begin hochgeladene ZIP und führt den Deploy aus (Optionen aus "
+      + "Schritt 1). Antwort wie beim Deploy: Bericht, ggf. 409 (Entwurf inzwischen geändert – nicht erzwingen, neu exportieren). "
+      + "Der Upload-Link ist danach verbraucht.",
+    { uploadId: z.string().describe("uploadId aus deploy_upload_begin.") },
+    async ({ uploadId }) => {
+      let up = null;
+      try {
+        up = remote.takeUpload(uploadId);
+        const o = up.options;
+        return asText(await apiDeploy(cfg, { site: o.site, slug: o.slug, name: o.name, zipPath: up.path, publish: o.publish,
+          resetOverlay: o.resetOverlay, legal: o.legal, baseRev: o.baseRev }));
+      } catch (e) { return asError(e); } finally { if (up) up.done(); }
+    }
+  );
+}