degree-dynamicweb-mcp

MCP-Server (Model Context Protocol) für die DynamicWeb 10 Admin API. Gibt Claude Code vollen Zugriff auf die Verwaltung von DynamicWeb-Item-Typen, -Feldern, -Seiten, -Absätzen und API-Discovery – ohne die DW-Admin-Oberfläche zu berühren.

Tools

Item-Typen

Schema-Wartung

Das Bereitstellen von Item-Typ-XML berührt die Datenbank nicht. Bis das Schema synchronisiert ist, speichert ein Feld, dessen Spalte fehlt, ohne Fehler und behält nichts.

Nach dem Bereitstellen neuer XML: dw_itemtype_sync_schema, dann dw_itemtype_health. Der Sync-Endpunkt antwortet auch dann mit „ok“, wenn er mittendrin abgebrochen wurde. Der Health-Check verrät dir also, ob es funktioniert hat – und /Files/System/Log/items/ActivationWorkflow enthält die eigentlichen Fehler. Ein Item-Typ, dessen Tabelle vollständig fehlt, erscheint im Health-Bericht überhaupt nicht.

Felder

Seiten

Absätze

dw_page_set_fields und dw_paragraph_set_fields verifizieren ihren eigenen Schreibvorgang. Ein Feldname, den der Item-Typ nicht deklariert, ist ein Fehler, der die vorhandenen Namen auflistet. Nach dem Speichern lesen sie das Item erneut aus und geben zurück, was es jetzt enthält. DW antwortet mit „ok“, unabhängig davon, ob ein Wert gespeichert wurde. Ein Tippfehler in einem SystemName war daher früher nicht von einem erfolgreichen Schreibvorgang zu unterscheiden.

Produkte

dw_product_update akzeptiert drei Eingabe-Maps:

• fields – Top-Level-Produktfelder (Name, DefaultPrice, Stock usw.)

• customFields – globale Produkt-Custom-Field-Werte, mit SystemName als Schlüssel

• categoryFields – Produktkategorie-Feldwerte, mit SystemName als Schlüssel

Produktschema

Verwalte das PIM-Datenmodell: Produktkategorien (Gruppen von Attributen) und Produktfelder (die Attribute selbst).

Dateien

Delivery API (schreibgeschützt)

API-Discovery

Related MCP server: TeamDesk MCP Server

Einrichtung

1. DW-API-Token abrufen

Gehe im DynamicWeb Admin zu Settings > Developer > API Keys und erstelle einen neuen Schlüssel mit vollem Zugriff.

2. KI-Client konfigurieren

Füge zu .mcp.json in deinem Projekt hinzu:

{
  "mcpServers": {
    "dynamicweb": {
      "command": "npx",
      "args": ["-y", "@degree-as/dynamicweb-mcp"],
      "env": {
        "DW_BASE_URL": "https://your-dw-instance",
        "DW_API_TOKEN": "your-token"
      }
    }
  }
}

Bearbeite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "dynamicweb": {
      "command": "npx",
      "args": ["-y", "@degree-as/dynamicweb-mcp"],
      "env": {
        "DW_BASE_URL": "https://your-dw-instance",
        "DW_API_TOKEN": "your-token"
      }
    }
  }
}

Füge zu ~/.cursor/mcp.json (global) oder .cursor/mcp.json (Projekt) hinzu:

{
  "mcpServers": {
    "dynamicweb": {
      "command": "npx",
      "args": ["-y", "@degree-as/dynamicweb-mcp"],
      "env": {
        "DW_BASE_URL": "https://your-dw-instance",
        "DW_API_TOKEN": "your-token"
      }
    }
  }
}

Füge .vscode/mcp.json zu deinem Projekt hinzu (Hinweis: verwendet servers, nicht mcpServers):

{
  "servers": {
    "dynamicweb": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@degree-as/dynamicweb-mcp"],
      "env": {
        "DW_BASE_URL": "https://your-dw-instance",
        "DW_API_TOKEN": "your-token"
      }
    }
  }
}

Bearbeite ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "dynamicweb": {
      "command": "npx",
      "args": ["-y", "@degree-as/dynamicweb-mcp"],
      "env": {
        "DW_BASE_URL": "https://your-dw-instance",
        "DW_API_TOKEN": "your-token"
      }
    }
  }
}

Konfiguriere über die MCP-Einstellungen von Cline oder füge es zu dessen Konfiguration hinzu:

{
  "mcpServers": {
    "dynamicweb": {
      "command": "npx",
      "args": ["-y", "@degree-as/dynamicweb-mcp"],
      "env": {
        "DW_BASE_URL": "https://your-dw-instance",
        "DW_API_TOKEN": "your-token"
      }
    }
  }
}

Füge zu Zeds settings.json hinzu (Hinweis: verwendet context_servers):

{
  "context_servers": {
    "dynamicweb": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "@degree-as/dynamicweb-mcp"],
      "env": {
        "DW_BASE_URL": "https://your-dw-instance",
        "DW_API_TOKEN": "your-token"
      }
    }
  }
}

Füge zu ~/.continue/config.yaml hinzu:

mcpServers:
  - name: dynamicweb
    command: npx
    args:
      - -y
      - "@degree-as/dynamicweb-mcp"
    env:
      DW_BASE_URL: https://your-dw-instance
      DW_API_TOKEN: your-token

3. Client neu starten

Der MCP-Server startet automatisch, wenn dein KI-Client geladen wird.

Lokale Entwicklung

Wenn du statt des veröffentlichten Pakets aus dem Quellcode ausführen möchtest:

git clone https://github.com/Degree-AS/degree-dynamicweb-mcp.git
cd degree-dynamicweb-mcp
npm install
npm run build

Verwende dann "command": "node", "args": ["/path/to/degree-dynamicweb-mcp/dist/index.js"] in .mcp.json.

Feldtyp-Aliase

Item-Typ-Felder (dw_field_save, dw_itemtype_create)

Beim Erstellen von Feldern kannst du kurze Aliase anstelle der vollständigen .NET-Klassennamen verwenden:

Jeder vollständige .NET-Editor-Klassenname wird ebenfalls akzeptiert. Verwende dw_field_types, um alle verfügbaren Editoren aus deiner DW-Instanz zu ermitteln.

Wiederholbare Listen (itemrelation)

itemrelation (ItemRelationListEditor) erstellt eine wiederholbare Liste von Unterelementen – die generische Möglichkeit, FAQ-Einträge, Zeilen, Personen usw. zu modellieren (anstelle fester nummerierter Slots wie Question1..5). Es benötigt zwei zusätzliche Parameter:

Erstellen Sie zuerst den untergeordneten Elementtyp, dann den übergeordneten:

// 1) child row
dw_itemtype_create { systemName: "OpeningHoursRow", fields: [
  { name: "Label", systemName: "Label", type: "text" },
  { name: "Value", systemName: "Value", type: "text" },
]}
// 2) parent with the repeatable list
dw_itemtype_create { systemName: "OpeningHours", fields: [
  { name: "Title", systemName: "Title", type: "text" },
  { name: "Rows",  systemName: "Rows",  type: "itemrelation", itemRelationType: "OpeningHoursRow" },
]}

Das Tool generiert automatisch die erforderlichen EditorConfiguration- und EditorFields-Werte (Elementtyp / Elementquelle) sowie den zugrunde liegenden Int32-Typ.

Produktfelder (dw_product_field_save)

Produktfelder verwenden ein anderes System - eine ganzzahlige TypeId aus FieldTypeAll, keine Editor-Klassennamen:

Eine numerische TypeId wird ebenfalls direkt akzeptiert. Verwenden Sie dw_product_field_type_list, um die aktuelle Liste von Ihrer DW-Instanz abzurufen.

Architektur

src/
  index.ts          Entry point - reads config from env, registers tools
  client.ts         DwClient - HTTP client for Admin API, Update API, Delivery API
  utils.ts          Shared Zod helpers (jsonParam, numParam) and response helpers (prop, pascal)
  tools/
    itemTypes.ts    Item type CRUD, fields, restrictions, settings, editor discovery, schema health and sync
    pages.ts        Page and area management
    paragraphs.ts   Paragraph management (uses ParagraphNew + ParagraphSave)
    products.ts     Product CRUD, bulk discount, custom/category field value updates
    productSchema.ts Product categories and product field schema management
    files.ts        File and directory browsing
    delivery.ts     Read-only Delivery API
    discovery.ts    Swagger search, endpoint schema, raw API calls

DW-API-Schnittstellen

Die DynamicWeb Admin API hat drei Aufrufkonventionen:

1. Admin API (GET /admin/api/{Endpoint}) - Abfragen mit URL-Parametern

2. Command API (POST /admin/api/{Endpoint}) - Mutationen mit { Model: {...} }-Body. Löschbefehle verwenden einen flachen Body (ohne Model-Wrapper).

3. Update API (POST /Admin/Api/{Endpoint}?Query.Type={Type}) - aktualisiert vorhandene Datensätze mit { QueryData: {...}, model: {...} }-Body

DwClient bietet für jede Konvention dedizierte Methoden: get(), post(), command(), update(), delivery().

Entwicklung

npm run dev      # Run with tsx (hot reload)
npm run build    # Compile TypeScript
npm run start    # Run compiled version

Führen Sie nach Änderungen npm run build aus und starten Sie Claude Code neu, um die neue Version zu übernehmen.