@prontosite/mcp 0.13.5 → 0.13.6

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 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.13.6 – 2026-10-20
+
+- Websites beim Namen nennen: `site` darf jetzt auch Firmenname, Domain oder Site-Titel sein (unscharf: Groß/Klein, Umlaute,
+  Bindestriche, Teilstring). Eindeutig → ausgeführt, die Antwort nennt den aufgelösten slug (`aufgeloesteWebsite`); mehrdeutig →
+  Kandidatenliste, nichts geändert; kein Treffer → die drei ähnlichsten. Nur innerhalb der erreichbaren Websites.
+- `sites_list`: je Website Firmenname (`company`), Site-Titel (`title`), Domains, Status (live/entwurf), Kunde-ID.
+- `site_status`: konkrete Rechte des Aufrufers – `canRead`, `canEditDraft`, `canPublish`, `canDeploy` (+ `canReasons`);
+  `apiEnabled` → `restApiEnabled` (betrifft nur die REST-API).
+- Tool-Annotationen (`readOnlyHint`, `destructiveHint`, `openWorldHint`) auf allen Tools; neue Instructions zu Namen und Rechten.
+
 ## 0.13.5 – 2026-10-20
 
 - `site_edit_text`: Telefonnummern werden unabhängig von der Schreibweise gefunden (Leerzeichen, „/", Bindestrich-Varianten,

package/api.mjs

@@ -124,7 +124,11 @@ export function friendlyApiError(status, serverError = "") {
 async function asJson(res) {
   let body = {};
   try { body = await res.json(); } catch { /* kein JSON */ }
-  if (!res.ok) throw new Error(friendlyApiError(res.status, body.error));
+  if (!res.ok) {
+    // Website-Auflösung (Firmenname/Domain): Kandidaten bzw. Vorschläge in die Meldung, damit der Assistent nachfragen kann.
+    const list = (body.candidates || body.suggestions || []).map(e => `${e.slug || e.site}${e.name ? ` (${e.name})` : ""}`).join(", ");
+    throw new Error(friendlyApiError(res.status, body.error) + (list ? ` ${body.candidates ? "Kandidaten" : "Ähnlich"}: ${list}.` : ""));
+  }
   return body;
 }
 
@@ -316,10 +320,11 @@ export async function apiLegalOptions(cfg, { site, impressum, datenschutz } = {}
 async function apiSitesWithToken(cfg, token, fetchImpl) {
   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,
+    name: s.name || null, company: s.company || null, title: s.title || null, domains: s.domains || [], status: s.status || null,
+    plan: s.plan, everPublished: s.everPublished, publishNeeded: s.publishNeeded,
     lastChangeAt: s.lastChangeAt || null, liveUrl: s.liveUrl || null, customer: s.customer,
     ...(s.needsFirstImport ? { needsFirstImport: true, hint: s.hint || null } : {}) }));
-  return { count: sites.length, manager: !!body.manager, hint: body.hint || null, sites };
+  return { count: sites.length, manager: !!body.manager, hint: body.hint || null, ...(body.hinweis ? { hinweis: body.hinweis } : {}), sites };
 }
 // sites-Map abfragen: jeden Eintrag einzeln (jeder Token → seine Site).
 async function sitesFromMap(cfg, fetchImpl) {

package/index.mjs

@@ -21,7 +21,7 @@ const cfg = loadConfig();
 // 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");
 // instructions: Arbeitsweise (Weg B = Standard) – gleicher Text wie am Remote-Endpunkt.
-const server = new McpServer({ name: "prontosite", version: "0.13.5" }, { instructions: instructionsFor("local") });
+const server = new McpServer({ name: "prontosite", version: "0.13.6" }, { instructions: instructionsFor("local") });
 // 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.13.5",
+  "version": "0.13.6",
   "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

@@ -20,6 +20,10 @@ const instructionLines = mode => [
   "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.",
+  "1a. Website wählen: Wenn der Nutzer eine Website beim Firmennamen nennt, erst sites_list, dann den passenden Slug verwenden; bei "
+    + "Unklarheit nachfragen. (Die Tools lösen Firmenname/Domain/Titel auch selbst auf; mehrdeutig → Kandidatenliste, nichts geändert.)",
+  "1b. Rechte aus site_status.can* lesen (canRead, canEditDraft, canPublish, canDeploy, Gründe in canReasons); nicht aus anderen Feldern "
+    + "schließen – restApiEnabled betrifft nur die REST-API, nicht diese Tools.",
   "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.",
   "2a. Für Text-, Link- und Kontaktdaten-Änderungen (Telefonnummer, E-Mail, Adresse, Öffnungszeiten) IMMER site_edit_text mit "
@@ -46,16 +50,31 @@ const instructionLines = mode => [
 export const instructionsFor = mode => instructionLines(mode).join("\n");
 export const SERVER_INSTRUCTIONS = instructionsFor("remote");
 
+// Tool-Annotationen (MCP ToolAnnotations): ChatGPT & Co. fragen sonst bei JEDEM Aufruf nach. readOnly = ändert nichts;
+// destructive = live/kundenwirksam, ersetzt Bestand oder nimmt zurück (Bestätigung sinnvoll). Entwurfs-Änderungen sind
+// rückgängig machbar und daher nicht destruktiv. openWorld = wirkt nach außen (öffentliche Website/DNS).
+const READ_ONLY = new Set(["sites_list", "site_status", "site_page_texts", "site_media_list", "site_preview_screenshot", "site_company_get",
+  "site_domain_status", "site_embeds", "site_widgets", "site_files", "site_file_get"]);
+const DESTRUCTIVE = new Set(["site_publish", "site_deploy", "deploy_commit", "site_file_delete", "site_media_delete", "site_undo", "site_redo", "site_domain_connect"]);
+const OPEN_WORLD = new Set(["site_publish", "site_deploy", "deploy_commit", "site_domain_connect"]);
+export function toolAnnotations(name, mode = "local") {
+  // site_export: remote nur ein Download-Link (lesend), lokal schreibt es eine ZIP auf die Platte.
+  const ro = READ_ONLY.has(name) || (name === "site_export" && mode === "remote");
+  return { readOnlyHint: ro, destructiveHint: !ro && DESTRUCTIVE.has(name), idempotentHint: ro || name === "site_lock" || name === "site_unlock", openWorldHint: OPEN_WORLD.has(name) };
+}
+
 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 }) {
+export function registerTools(server0, { z, cfg, mode = "local", remote = null }) {
+  // Jedes Tool mit Annotationen registrieren (Signatur des SDK: name, description, schema, annotations, handler).
+  const server = { tool: (name, desc, schema, cb) => server0.tool(name, desc, schema, toolAnnotations(name, mode), cb) };
   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.";
+    ? "Website: Slug (z. B. 'mas-monti'), Site-ID (s-…), Firmenname, Domain oder Site-Titel (unscharf, z. B. 'Firat-Deveci'). Ohne Angabe "
+      + "die Website des Tokens bzw. der Freigabe. Betreuer: die gewünschte Website angeben (sites_list zeigt alle mit Firmennamen)."
+    : "Website: Slug (z. B. 'mas-monti'), Firmenname, Domain oder Site-Titel (unscharf). 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({