@prontosite/mcp 0.10.1 → 0.11.0

package/CHANGELOG.md

@@ -3,6 +3,40 @@
 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.0 – 2026-10-18
+
+- **Datei-API – kleine Änderungen am Entwurf ohne lokale Kopie:** neue Tools `site_files`, `site_file_get`,
+  `site_file_put`, `site_file_delete`, `site_file_rename` (Schreiben nur mit Betreuer-Token). Pflicht-`baseRev`
+  (= `draftRev` aus `site_status`/`site_file_get`); bei Konflikt (jemand hat dieselbe Datei geändert) kommt die
+  Antwort mit `conflict:true` und der Liste wer/wann/was zurück – nicht als Fehler, damit der Assistent neu aufsetzt.
+  Für größere Umbauten bleibt `site_export (which='draft')` → lokal → `site_deploy`.
+- **`site_status`** beschreibt `draftRev` und `recentEdits` (vor Änderungen lesen).
+- **Client-Kennung:** jeder Aufruf sendet `X-ProntoSite-Client: mcp/<version>` – im Verlauf je Site erscheint der Weg
+  „MCP" statt „API".
+- Server-seitig (wirkt auch für ältere Versionen): Export-ZIP trägt `.prontosite-export.json` mit `draftRev`;
+  `site_deploy` eines exportierten Stands meldet einen zwischenzeitlich geänderten Entwurf mit 409 statt zu überschreiben.
+
+## 0.10.3 – 2026-10-14 (veröffentlicht 18.10.2026)
+
+- **`site_deploy`:** neuer Parameter `name` (Erst-Import) – setzt den Website-Namen explizit, falls die
+  Ableitung aus der Startseite danebenliegt (z. B. „Physio Phoenix – Bad Honnef Süd" → `name="Physio Phoenix"`).
+  Beschreibung ergänzt um die **Reihenfolge-Empfehlung** „Konto → Firmendaten → Import".
+- **`site_company_set`:** Beschreibung klärt, dass ein Firmendaten-Set NACH einem Import die Rechts-Automatik
+  AUTOMATISCH neu laufen lässt (Entwurf; `legal.refreshed` in der Antwort) – ein zweiter Import ist nicht mehr
+  nötig. `apiDeploy` meldet das im `companyNote` entsprechend.
+
+## 0.10.2 – 2026-10-14
+
+- **Verständliche Fehlermeldungen** statt roher Server-/HTTP-Fehler – zentral in `api.mjs`
+  (`friendlyApiError`, greift über `asJson` für JEDES Tool: `site_deploy`, `site_status`, `sites_list`, …):
+  - **403** mit „API-Zugang nicht im Tarif" (bzw. alt „Starter-Plan") → *„Dein ProntoSite-Tarif enthält keinen
+    API-Zugang. Wähle im Dashboard → Zahlung einen Tarif oder bitte deinen Betreuer um eine API-Freigabe."*
+  - **401** (Token ungültig/abgelaufen) → Hinweis, das Token im Dashboard → API-Zugang neu zu erstellen und in
+    `~/.prontosite.json` einzutragen.
+  - **429** → Hinweis auf das Rate-Limit (kurz warten und erneut versuchen).
+  Andere 403 (z. B. „Kein Zugriff auf dieses Konto") bleiben unverändert. Tests mit gemockten Antworten
+  (401/403/429 über mehrere Tools) in `tests/mcp-prontosite.test.js`.
+
 ## 0.10.1 – 2026-10-03
 
 - **Fix:** In der `account_create`-Beschreibung beendeten gerade Anführungszeichen (`"`) innerhalb der

package/README.md

@@ -83,7 +83,11 @@ sichern: `cp ~/.prontosite.json ~/.prontosite.json.bak`).
 |------|---------|
 | `sites_list` | Alle erreichbaren Websites (Slug, Plan, letzte Änderung, Publish-Bedarf). **Lesend.** |
 | `account_create({ name, email?, plan?, note?, override? })` | **Nur mit Betreuer-Token.** Legt ein neues Kundenkonto an (Dashboard-Weg „Kunde anlegen"). Mit `email` → eingeladenes Login-Konto (Invite-Mail), ohne → verwaltetes Konto. Partner/Agentur: Konto wird dem Betreuer zugeordnet (Agentur-Kunden automatisch `agentur-kunde`). Antwort nennt die neue Konto-ID (k-…) → danach `site_deploy({ site: "<k-id>:new", zipPath })`. Namens-/E-Mail-Dublette → Warnung mit vorhandener k-ID (`override:true` erzwingt die Namensdublette). **Schreibend.** |
-| `site_status({ site? })` | Plan, Slug, Live-URL, Publish-Bedarf. **Lesend.** |
+| `site_status({ site? })` | Plan, Slug, Live-URL, Publish-Bedarf, `draftRev` + `recentEdits` (wer hat zuletzt wo geändert). **Lesend.** |
+| `site_files({ site? })` | Dateien des Entwurfs (Pfad, Größe, Typ, bearbeitbar) + `draftRev`. **Lesend.** |
+| `site_file_get({ site?, path })` | Quelltext einer Datei (Text bzw. Base64, max. 5 MB) + `draftRev` + Hinweis auf Dashboard-Änderungen darüber (`overlay`). **Lesend.** |
+| `site_file_put({ site?, path, content, baseRev, overlay? })` | Text-Datei im Entwurf ersetzen (nur Betreuer-Token). `baseRev` Pflicht; bei Konflikt `conflict:true` mit Liste statt Überschreiben. Nicht live – danach `site_publish`. **Schreibend.** |
+| `site_file_delete({ site?, path, baseRev, confirmDestructive? })` / `site_file_rename({ site?, from, to, baseRev })` | Text-Datei im Entwurf entfernen bzw. umbenennen (undo-fähig, nur Betreuer-Token). **Schreibend.** |
 | `site_export({ site?, which, outDir })` | ZIP (`published`\|`draft`\|`original`) lokal speichern. **Lesend.** |
 | `site_deploy({ site?, zipPath, publish?, resetOverlay?, legal?, company?, siteOverride? })` | ZIP importieren, optional live; optional Firmendaten im selben Aufruf setzen. Beim lokalen Bauen Bausteine im HTML per `data-ps` markieren (`formular:kontakt`, `impressum`/`datenschutz`, `link-impressum`/`link-datenschutz`) → [Marker-Syntax](https://prontosite.io/docs/marker-shortcodes). **Schreibend.** |
 | `site_publish({ site? })` | Aktuellen Stand erneut veröffentlichen. **Schreibend.** |
@@ -122,6 +126,20 @@ genau diese Website, und Verwechslungen sind ausgeschlossen. `sites_list` zeigt
 Chat einfach sagen „deploye mas-monti", ohne Slugs auswendig zu kennen. (Alternativ ein Chat für alles und die
 Website je Aufruf über `site` wählen – die getrennten Chats sind aber übersichtlicher.)
 
+## Fehlermeldungen
+
+Statt roher HTTP-/Server-Fehler geben **alle** Tools bei den drei häufigen Betriebsfällen eine verständliche
+Meldung zurück (zentral in `api.mjs`):
+
+- **Kein API-Zugang im Tarif (403):** „Dein ProntoSite-Tarif enthält keinen API-Zugang. Wähle im
+  Dashboard → Zahlung einen Tarif oder bitte deinen Betreuer um eine API-Freigabe."
+- **Token ungültig/abgelaufen (401):** „Dein API-Token ist ungültig oder abgelaufen. Token im
+  Dashboard → API-Zugang neu erstellen und in `~/.prontosite.json` eintragen."
+- **Zu viele Anfragen (429):** Hinweis auf das Rate-Limit – einen Moment warten und erneut versuchen.
+
+Andere Fehler (z. B. „Kein Zugriff auf dieses Konto", „Website nicht gefunden") werden unverändert mit der
+Server-Meldung durchgereicht.
+
 ## Sicherheit
 
 - Tokens liegen nur lokal (Config/Env), werden nie geloggt und nie in Antworten zurückgegeben.

package/api.mjs

@@ -92,13 +92,36 @@ export function resolveTarget(cfg, site) {
 }
 
 const baseUrl = cfg => `https://${cfg.host}/api`;
-const authHeaders = token => ({ authorization: `Bearer ${token}` });
+// 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 });
+
+/**
+ * Server-Fehler → VERSTÄNDLICHE Meldung für den Chat. Zentral für ALLE Tools (über asJson). Übersetzt die
+ * drei häufigen Betriebsfälle; alles andere behält die Server-Meldung (bzw. „HTTP <status>"). Token werden
+ * nie geloggt/zurückgegeben – hier sind ohnehin nur Status + Server-Text im Spiel.
+ *   401  Token ungültig/abgelaufen → neues Token erstellen + in ~/.prontosite.json eintragen.
+ *   403  API-Gate (Text „API-Zugang nicht im Tarif" bzw. „Starter-Plan") → Tarif ohne API-Zugang.
+ *   429  Rate-Limit → kurz warten.
+ * Andere 403 (z. B. „Kein Zugriff auf dieses Konto") bleiben unverändert – nur das API-Zugangs-Gate wird gemappt.
+ */
+export function friendlyApiError(status, serverError = "") {
+  const raw = String(serverError || "").trim();
+  if (status === 401)
+    return "Dein API-Token ist ungültig oder abgelaufen. Token im Dashboard → API-Zugang neu erstellen und in ~/.prontosite.json eintragen.";
+  if (status === 403 && /API-Zugang nicht im Tarif|Starter-Plan/i.test(raw))
+    return "Dein ProntoSite-Tarif enthält keinen API-Zugang. Wähle im Dashboard → Zahlung einen Tarif oder bitte deinen Betreuer um eine API-Freigabe.";
+  if (status === 429)
+    return "Zu viele Anfragen in kurzer Zeit (Rate-Limit). Bitte einen Moment warten und erneut versuchen.";
+  return raw || `HTTP ${status}`;
+}
 
 /** Antwort als JSON lesen; bei Fehlerstatus eine sprechende Exception (ohne Token). */
 async function asJson(res) {
   let body = {};
   try { body = await res.json(); } catch { /* kein JSON */ }
-  if (!res.ok) throw new Error(body.error || `HTTP ${res.status}`);
+  if (!res.ok) throw new Error(friendlyApiError(res.status, body.error));
   return body;
 }
 
@@ -125,7 +148,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, 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, 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;
@@ -142,6 +165,7 @@ 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)
   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) });
@@ -151,9 +175,11 @@ export async function apiDeploy(cfg, { site, customer = null, slug: wishSlug = n
   // Publish übernimmt sie. Das melden wir als companyApplied/companyNote statt still zu lassen.
   if (hasCompany && isNew && out && (out.slug || out.site)) {
     try {
-      await apiCompanySet(cfg, { site: out.slug || out.site, company, siteOverride }, fetchImpl);
+      const compRes = await apiCompanySet(cfg, { site: out.slug || out.site, company, siteOverride }, fetchImpl);
       out.companyApplied = true;
-      if (out.legal && !out.legal.disabled) out.companyNote = "Firmendaten wurden NACH dem Erst-Import gesetzt – die automatisch erzeugten Rechtstexte übernehmen sie erst beim nächsten Rechts-Lauf/Publish.";
+      // Firmendaten-Set lässt serverseitig die Rechts-Automatik neu laufen (Entwurf) – kein zweiter Import nötig.
+      if (compRes && compRes.legal && compRes.legal.refreshed && compRes.legal.refreshed.length)
+        out.companyNote = `Firmendaten gesetzt – Rechtstexte (${compRes.legal.refreshed.join(", ")}) automatisch neu erzeugt (Entwurf). Zum Live-Schalten veröffentlichen.`;
     } catch (e) { out.companyApplied = false; out.companyError = e.message; }
   }
   return out;
@@ -316,3 +342,39 @@ export async function sitesList(cfg, fetchImpl = fetch) {
   const { token } = resolveTarget(cfg, cfg.defaultSite || cfg.site || "active");
   return apiSitesWithToken(cfg, token, fetchImpl);
 }
+
+// ---- Datei-API (Entwurf ohne lokale Kopie; docs/konzept-serverseitig-editieren.md §6/§7) ----
+// 409 (Konflikt) NICHT als Fehler werfen, sondern komplett zurückgeben: der Assistent braucht die Liste
+// „wer hat wann was geändert" (changes/intervening), um sauber neu aufzusetzen.
+async function asJsonOr409(res) {
+  if (res.status === 409) { try { return await res.json(); } catch { return { conflict: true, error: "Konflikt (409)." }; } }
+  return asJson(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) }));
+}
+/** 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) }));
+}
+/** 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 }) }));
+}
+/** 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 }) }));
+}
+/** 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 }) }));
+}

package/index.mjs

@@ -13,13 +13,13 @@ 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 } from "./api.mjs";
+import { loadConfig, apiStatus, apiExport, apiDeploy, apiPublish, sitesList, apiAccountCreate, apiCompanyGet, apiCompanySet, apiLegalOptions, apiDomainStatus, apiDomainConnect, apiEmbeds, apiEmbedConsent, apiWidgets, apiWidgetSet, apiFiles, apiFileGet, apiFilePut, apiFileDelete, apiFileRename } from "./api.mjs";
 
 const cfg = loadConfig();
 // Deutliche Startwarnung bei ambiger Konfiguration (Top-Level-Token NEBEN sites-Map). Nach stderr, damit
 // es im MCP-Log/Terminal auffällt; die endgültige Auflösung (Betreuer-Token-Vorrang vs. Map) klärt sites_list.
 for (const w of (cfg.warnings || [])) process.stderr.write("[prontosite-mcp] ⚠ " + w + "\n");
-const server = new McpServer({ name: "prontosite", version: "0.10.0" });
+const server = new McpServer({ name: "prontosite", version: "0.11.0" });
 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-"
@@ -81,8 +81,9 @@ server.tool(
 
 server.tool(
   "site_status",
-  "Status einer ProntoSite-Website: Plan, Slug, Live-URL, letzte Änderungen und offener Veröffentlichungs"
-    + "bedarf. LESEND – ändert nichts.",
+  "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); } }
 );
@@ -106,6 +107,11 @@ server.tool(
     + "(„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\" "
@@ -120,6 +126,7 @@ server.tool(
     + "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)."),
@@ -127,8 +134,8 @@ server.tool(
     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, customer, zipPath, publish, resetOverlay, legal, company, siteOverride }) => {
-    try { return asText(await apiDeploy(cfg, { site, slug, customer, zipPath, publish, resetOverlay, legal, company, siteOverride })); } catch (e) { return asError(e); }
+  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); }
   }
 );
 
@@ -156,8 +163,11 @@ server.tool(
     + "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. Bitte VOR "
-    + "dem Speichern die erkannten Felder kurz zusammenfassen und bestätigen lassen.",
+    + "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).") },
@@ -273,6 +283,56 @@ server.tool(
   }
 );
 
+// ---- 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); } }
+);
+
 // 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.
 // So lädt der Import die Datei komplett (inkl. aller server.tool-Registrierungen → fängt Syntax-/Beschreibungs-

package/package.json

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