@prontosite/mcp 0.11.2 → 0.12.0

package/CHANGELOG.md

@@ -3,12 +3,30 @@
 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.11.2 – 2026-10-19
+## 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

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;
 };
@@ -155,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;
@@ -172,7 +173,8 @@ 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, cfg), "content-type": "application/zip" }, body: fs.readFileSync(zipPath) });
@@ -386,6 +388,14 @@ export async function apiFileRename(cfg, { site, from, to, baseRev } = {}, fetch
     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);

package/index.mjs

@@ -14,13 +14,14 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import { loadConfig } from "./api.mjs";
-import { registerTools } from "./tools.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.2" });
+// 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" });
 

package/package.json

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

package/tools.mjs

@@ -9,7 +9,24 @@
  *                site_domain_connect nur mit Betreuer-Token (Entscheidung 9a).
  * `z` wird vom Aufrufer übergeben (dieselbe zod-Instanz wie sein MCP-SDK).
  */
-import { 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";
+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)) }] });
@@ -80,18 +97,36 @@ export function registerTools(server, { z, cfg, mode = "local", remote = null })
   }
   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.",
+    "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",
-      "Exportiert eine Website als ZIP in ein lokales Verzeichnis. which: 'published' (Live-Stand, Standard), "
-        + "'draft' (Entwurf) oder 'original' (flacher Stand ohne ProntoSite-Zutaten). LESEND.",
+      "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).") },
@@ -101,7 +136,9 @@ export function registerTools(server, { z, cfg, mode = "local", remote = null })
 
     server.tool(
       "site_deploy",
-      "SCHREIBEND: Übergibt eine lokale ZIP-Datei an ProntoSite (Import). Mit publish=true wird die Website "
+      "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 "
@@ -130,13 +167,14 @@ export function registerTools(server, { z, cfg, mode = "local", remote = null })
         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, 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); }
+      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); }
       }
     );
 
@@ -145,9 +183,9 @@ export function registerTools(server, { z, cfg, mode = "local", remote = null })
   }
   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.",
+    "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); } }
@@ -290,7 +328,9 @@ export function registerTools(server, { z, cfg, mode = "local", remote = null })
   );
 
   // ---- 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. ";
+  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. "
@@ -308,7 +348,7 @@ export function registerTools(server, { z, cfg, mode = "local", remote = null })
   );
   server.tool(
     "site_file_put",
-    "SCHREIBEND (Entwurf, nicht live; nur Betreuer-Token): Ersetzt den Inhalt einer Text-Datei (HTML einer bestehenden Seite, "
+    "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 "
@@ -324,7 +364,7 @@ export function registerTools(server, { z, cfg, mode = "local", remote = null })
   );
   server.tool(
     "site_file_delete",
-    "SCHREIBEND (Entwurf; nur Betreuer-Token): Markiert eine Text-Datei im Entwurf als gelöscht (rückgängig machbar; Seiten "
+    "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(),
@@ -333,7 +373,7 @@ export function registerTools(server, { z, cfg, mode = "local", remote = null })
   );
   server.tool(
     "site_file_rename",
-    "SCHREIBEND (Entwurf; nur Betreuer-Token): Benennt eine Text-Datei (kein HTML) um. Verweise in anderen Dateien werden NICHT "
+    "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); } }
@@ -362,7 +402,8 @@ export function registerTools(server, { z, cfg, mode = "local", remote = null })
 function registerRemoteTransferTools(server, { z, cfg, remote, SITE_DESC, asText, asError }) {
   server.tool(
     "site_export",
-    "LESEND: Exportiert eine Website als ZIP und liefert einen DOWNLOAD-LINK (15 Minuten gültig, nur EINMAL abrufbar). "
+    "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),
@@ -376,7 +417,8 @@ function registerRemoteTransferTools(server, { z, cfg, remote, SITE_DESC, asText
   );
   server.tool(
     "deploy_upload_begin",
-    "SCHREIBEND (Schritt 1 von 2): ZIP-Deploy vorbereiten. Liefert einen UPLOAD-LINK (HTTP PUT, 15 Minuten, einmalig, max. "
+    "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. "
@@ -387,9 +429,10 @@ function registerRemoteTransferTools(server, { z, cfg, remote, SITE_DESC, asText
       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.") },
-    async ({ site, slug, name, publish, resetOverlay, legal }) => {
-      try { return asText(remote.beginUpload({ site, slug, name, publish, resetOverlay, legal })); } catch (e) { return asError(e); }
+      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(
@@ -404,7 +447,7 @@ function registerRemoteTransferTools(server, { z, cfg, remote, SITE_DESC, asText
         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 }));
+          resetOverlay: o.resetOverlay, legal: o.legal, baseRev: o.baseRev }));
       } catch (e) { return asError(e); } finally { if (up) up.done(); }
     }
   );