@prontosite/mcp 0.3.1 → 0.5.0

package/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog – @prontosite/mcp
+
+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.5.0 – 2026-09-20
+
+- **Neu: `site_legal_options`** – 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; sonst Teil-Update. `draftNotice:false` blendet den Entwurfs-Hinweis
+  live aus (protokolliert) – Bestätigung empfohlen. Serverseitig: `GET/PUT /api/legal-options/<site>`.
+
+## 0.4.0 – 2026-09-20
+
+- **Neu: `site_company_get`** – Firmendaten (Impressum/Footer) einer Website lesen (effektiver Stand +
+  konto-weite Angaben + ob eine Website-Abweichung gesetzt ist). Lesend.
+- **Neu: `site_company_set`** – Firmendaten des Kontos setzen/ergänzen (Name, Rechtsform, Inhaber, Anschrift,
+  Kontakt, USt-IdNr., Register, Kammer/Beruf, Aufsicht, § 18 MStV, Social). **Teil-Update** (nur übergebene
+  Felder ändern sich); der Assistent kann die Angaben aus Impressum-Text/Visitenkarte/Freitext extrahieren.
+  Default konto-weit, `siteOverride:true` für website-spezifische Angaben. Schreibend (Bestätigung empfohlen).
+- **`site_deploy`** akzeptiert jetzt optional `company:{…}` (+ `siteOverride`) – Firmendaten setzen **und**
+  deployen in einem Aufruf; die Rechtstext-Automatik nutzt die Daten dann direkt beim Import.
+- Diese Firmendaten füllen beim (Erst-)Deploy automatisch Impressum & Datenschutz; die Deploy-Antwort meldet
+  über `legal.missingCompanyFields`, welche Pflichtangaben noch fehlen.
+- Doku/Homepage auf `https://prontosite.io/docs/mcp` umgestellt.
+
+Benötigt die serverseitige Company-API (`/api/company/<site>`, seit 2026-09-20 live).
+
+## 0.3.x
+
+- Tools `sites_list`, `site_status`, `site_export`, `site_deploy` (inkl. `legal`-Schalter), `site_publish`.
+- Erst-Import (`site:"new"` bzw. `<label>:new`), Betreuer-/Multi-Site-Config, Wunsch-Slug beim Erst-Import.

package/README.md

@@ -84,8 +84,11 @@ sichern: `cp ~/.prontosite.json ~/.prontosite.json.bak`).
 | `sites_list` | Alle erreichbaren Websites (Slug, Plan, letzte Änderung, Publish-Bedarf). **Lesend.** |
 | `site_status({ site? })` | Plan, Slug, Live-URL, Publish-Bedarf. **Lesend.** |
 | `site_export({ site?, which, outDir })` | ZIP (`published`\|`draft`\|`original`) lokal speichern. **Lesend.** |
-| `site_deploy({ site?, zipPath, publish?, resetOverlay?, legal? })` | ZIP importieren, optional live. **Schreibend.** |
+| `site_deploy({ site?, zipPath, publish?, resetOverlay?, legal?, company?, siteOverride? })` | ZIP importieren, optional live; optional Firmendaten im selben Aufruf setzen. **Schreibend.** |
 | `site_publish({ site? })` | Aktuellen Stand erneut veröffentlichen. **Schreibend.** |
+| `site_company_get({ site? })` | Firmendaten (Impressum/Footer) lesen. **Lesend.** |
+| `site_company_set({ site?, company, siteOverride? })` | Firmendaten setzen/ergänzen (Teil-Update); füllen Impressum/Datenschutz beim Deploy. **Schreibend.** |
+| `site_legal_options({ site?, impressum?, datenschutz? })` | Anzeige-Optionen der Rechtstexte (showTitle, showDate, draftNotice); ohne Rolle nur lesen. **Schreibend.** |
 
 `site_deploy` und `site_publish` sind **schreibende** Aktionen (verändern die Live-Website). Die
 Tool-Beschreibungen weisen den Assistenten an, vorher rückzufragen. Jeder Aufruf wird serverseitig auditiert.

package/api.mjs

@@ -117,8 +117,10 @@ 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 } = {}, fetchImpl = fetch) {
+export async function apiDeploy(cfg, { site, customer = null, slug: wishSlug = null, zipPath, publish = false, resetOverlay = false, legal = null, company = null, siteOverride = false } = {}, fetchImpl = fetch) {
   if (!zipPath || !fs.existsSync(zipPath)) throw new Error(`ZIP nicht gefunden: ${zipPath}`);
+  // Optional: Firmendaten VOR dem Deploy setzen (ein Schritt) → Rechtstext-Automatik nutzt sie direkt.
+  if (company && typeof company === "object") await apiCompanySet(cfg, { site, company, siteOverride }, fetchImpl);
   const { token, slug } = resolveTarget(cfg, site);
   const q = new URLSearchParams();
   if (publish) q.set("publish", "1");
@@ -142,6 +144,39 @@ export async function apiPublish(cfg, { site, force = false } = {}, fetchImpl =
   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) });
+  return asJson(res);
+}
+
+/** PUT /api/company/<site> – Firmendaten TEIL-aktualisieren (nur gesetzte Felder). Default konto-weit;
+ *  siteOverride=true schreibt die abweichenden Firmendaten DIESER Website. */
+export async function apiCompanySet(cfg, { site, company, siteOverride = false } = {}, fetchImpl = fetch) {
+  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" },
+    body: JSON.stringify({ company, siteOverride: !!siteOverride }) });
+  return asJson(res);
+}
+
+/** GET/PUT /api/legal-options/<site> – Anzeige-Optionen der Rechtstext-Widgets. Ohne impressum/datenschutz
+ *  nur LESEN; sonst Teil-Update (nur echte Booleans wirken). */
+export async function apiLegalOptions(cfg, { site, impressum, datenschutz } = {}, fetchImpl = fetch) {
+  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) }));
+  }
+  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) });
+  return asJson(res);
+}
+
 /** Alle erreichbaren Sites auflisten (Slug, Plan, Publish-Bedarf, letzte Änderung). Bei einer sites-Map wird
  *  jeder Eintrag per Status abgefragt; sonst die eine konfigurierte Site. Fehler je Site werden mitgeführt. */
 export async function sitesList(cfg, fetchImpl = fetch) {

package/index.mjs

@@ -11,7 +11,7 @@
 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 } from "./api.mjs";
+import { loadConfig, apiStatus, apiExport, apiDeploy, apiPublish, sitesList, apiCompanyGet, apiCompanySet, apiLegalOptions } from "./api.mjs";
 
 const cfg = loadConfig();
 const server = new McpServer({ name: "prontosite", version: "0.3.1" });
@@ -20,6 +20,29 @@ const asError = e => ({ isError: true, content: [{ type: "text", text: "Fehler:
 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"
@@ -61,9 +84,11 @@ server.tool(
     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.") },
-  async ({ site, slug, customer, zipPath, publish, resetOverlay, legal }) => {
-    try { return asText(await apiDeploy(cfg, { site, slug, customer, zipPath, publish, resetOverlay, legal })); } catch (e) { return asError(e); }
+    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); }
   }
 );
 
@@ -77,5 +102,49 @@ server.tool(
   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. 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("Überschrift (H1) des Rechtstextes anzeigen (Default an)."),
+  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.",
+  { 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); }
+  }
+);
+
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@prontosite/mcp",
-  "version": "0.3.1",
+  "version": "0.5.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": { "prontosite-mcp": "index.mjs" },
   "main": "index.mjs",
-  "files": ["index.mjs", "api.mjs", "README.md"],
+  "files": ["index.mjs", "api.mjs", "README.md", "CHANGELOG.md"],
   "engines": { "node": ">=18" },
   "keywords": ["prontosite", "mcp", "model-context-protocol", "claude", "deploy", "website"],
   "license": "UNLICENSED",
-  "homepage": "https://prontosite.io/mcp-anleitung",
+  "homepage": "https://prontosite.io/docs/mcp",
   "publishConfig": { "access": "public" },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",