User Template erstellen | MCP Server | CODEFLUSS

Erstellt ein neues benutzerdefiniertes Design System Template basierend auf einem System-Template.

Tool Name

create_user_template

Beschreibung

Das create_user_template Tool erstellt ein neues benutzerdefiniertes Template, das auf einem vorhandenen System-Template basiert. Es prüft automatisch die Abo-Limits der Organisation und verwendet standardmäßig das default System-Template als Basis. Das neue Template erbt alle Design-Tokens des Quell-Templates und kann anschließend individuell angepasst werden.

Hinweis: Das Löschen von User Templates ist nur über die Web-Oberfläche möglich, nicht über MCP.

Parameter

Parameter	Typ	Pflicht	Standard	Beschreibung
name	string	Ja	—	Name des Templates (1–255 Zeichen)
description	string	Nein	—	Beschreibung des Templates (max. 1000 Zeichen)
sourceTemplateId	string	Nein	`"default"`	ID des System-Templates als Basis
iconName	string	Nein	—	Icon-Name für die Darstellung (max. 100 Zeichen)
primaryColor	string	Nein	—	Primärfarbe als HEX-Wert (z.B. `"#FF5500"`)

Beispiel Request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "create_user_template",
    "arguments": {
      "name": "Corporate Blue",
      "description": "Unternehmensspezifisches Template mit blauer Farbpalette",
      "sourceTemplateId": "default",
      "primaryColor": "#1E40AF"
    }
  },
  "id": 1
}

Beispiel Response

{
  "jsonrpc": "2.0",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"id\":\"ut_001\",\"name\":\"Corporate Blue\",\"description\":\"Unternehmensspezifisches Template mit blauer Farbpalette\",\"iconName\":null,\"primaryColor\":\"#1E40AF\",\"previewColors\":[\"#1E40AF\"],\"sourceTemplateId\":\"default\",\"organizationId\":\"org_001\",\"createdBy\":\"user_001\",\"createdAt\":\"2026-02-15T08:00:00Z\",\"updatedAt\":\"2026-02-15T08:00:00Z\",\"limits\":{\"current\":2,\"limit\":5,\"remaining\":3}}"
      }
    ]
  },
  "id": 1
}

Response Format

Feld	Typ	Beschreibung
id	string	Eindeutige ID des erstellten Templates
name	string	Name des Templates
description	string	Beschreibung
iconName	string	Icon-Name
primaryColor	string	Primärfarbe als HEX-Wert
previewColors	array	Vorschaufarben
sourceTemplateId	string	ID des Quell-Templates
organizationId	string	Organisations-ID
createdBy	string	ID des erstellenden Benutzers
createdAt	string	Erstellungszeitpunkt (ISO 8601)
updatedAt	string	Letzter Änderungszeitpunkt (ISO 8601)
limits	object	Aktuelle Abo-Limits (siehe unten)

Limits-Objekt

Feld	Typ	Beschreibung
current	number	Aktuelle Anzahl an User Templates
limit	number	Maximale Anzahl laut Abonnement
remaining	number	Verbleibende Templates

Fehlerfälle

Fehler	Beschreibung
Template limit reached	Abo-Limit für Templates wurde erreicht. Upgrade erforderlich.
User is not a member	Der Benutzer gehört keiner Organisation an.
Failed to create template	Interner Fehler bei der Template-Erstellung.