Verfügbare Tools
Der Widget Builder MCP Server stellt die folgenden Tools bereit, die KI-Assistenten zur Verwaltung Ihrer Widgets verwenden können.
Widget-Verwaltung
list_widgets
Listet alle benutzerdefinierten Widgets für Ihr Konto auf. Gibt eine Zusammenfassung jedes Widgets zurück, einschließlich GUID, Titel, Aktivierungsstatus und Zeitstempel.
Parameter: Keine
Rückgabe: Array von Widgets mit guid, title, isActive, updateTimestamp und createTimestamp.
Erforderlicher Scope: widgets:read
get_widget
Ruft alle Details eines bestimmten Widgets anhand seiner GUID ab. Enthält das Handlebars-Template, Formularfelddefinitionen, Variablen, Übersetzungen und API-Konfiguration.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
guid | string | Ja | Die eindeutige Kennung des Widgets |
Erforderlicher Scope: widgets:read
create_widget
Erstellt ein neues Widget mit einem Titel und optionalem Handlebars-HTML-Template, Formularfeldern, Variablen und Übersetzungen.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
title | string | Ja | Der Widget-Titel |
template | string | Nein | Handlebars-HTML-Template |
form | array | Nein | Formularfelddefinitionen (Editor-Einstellungen) |
variables | array | Nein | Widget-Variablen für interaktiven Zustand |
translations | object | Nein | Übersetzungs-Schlüssel-Wert-Paare pro Sprache |
isActive | boolean | Nein | Ob das Widget sofort aktiv ist (Standard: false) |
Erforderlicher Scope: widgets:write
update_widget
Aktualisiert ein bestehendes Widget. Nur angegebene Felder werden aktualisiert — nicht angegebene Felder bleiben unverändert.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
guid | string | Ja | Die eindeutige Kennung des Widgets |
title | string | Nein | Neuer Widget-Titel |
template | string | Nein | Aktualisiertes Handlebars-Template |
form | array | Nein | Aktualisierte Formularfelder |
variables | array | Nein | Aktualisierte Variablen |
translations | object | Nein | Aktualisierte Übersetzungen |
isActive | boolean | Nein | Widget aktivieren oder deaktivieren |
Erforderlicher Scope: widgets:write
delete_widget
Löscht ein Widget dauerhaft anhand seiner GUID. Diese Aktion kann nicht rückgängig gemacht werden.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
guid | string | Ja | Die eindeutige Kennung des Widgets |
Erforderlicher Scope: widgets:write
Integrierte Widgets
list_builtin_widgets
Listet alle integrierten Widgets auf, die für Ihr Konto aktiviert sind. Gibt GUID, Version, Titel und Symbol für jedes integrierte Widget zurück.
Parameter: Keine
Erforderlicher Scope: widgets:read
get_builtin_widget
Ruft alle Details eines integrierten Widgets anhand seiner GUID ab, einschließlich HTML-Template, Formularfelder, Variablen, Übersetzungen und API-Konfiguration.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
guid | string | Ja | Die eindeutige Kennung des integrierten Widgets |
Erforderlicher Scope: widgets:read
Template-Rendering
test_render
Rendert ein Handlebars-Template serverseitig ohne Browser zu Testzwecken. Gibt die gerenderte HTML-Ausgabe und eventuelle Kompilierungsfehler zurück. Sie können ein bestehendes Widget per GUID rendern oder einen rohen Template-String angeben.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
guid | string | Nein | Widget-GUID zum Rendern (optional, wenn template angegeben ist) |
template | string | Nein | Roher Handlebars-Template-String (optional, wenn guid angegeben ist) |
data | object | Nein | Beispieldatenkontext für das Template-Rendering |
settings | object | Nein | Beispiel-Einstellungswerte für das Template-Rendering |
Erforderlicher Scope: render
Verwenden Sie test_render, um Templates vor dem Erstellen oder Aktualisieren von Widgets zu validieren. So lassen sich Handlebars-Syntaxfehler frühzeitig erkennen.
Dokumentation
get_widget_guide
Ruft die vollständige Widget-Entwicklungsanleitung ab. Diese enthält Dokumentation zur Handlebars-Syntax, alle verfügbaren Helfer mit Beispielen, Formularfeldtypen, Variablen, Übersetzungen, Tailwind CSS Nutzung und ein vollständiges Beispiel-Widget.
Parameter: Keine
Erforderlicher Scope: Keiner (verfügbar für alle authentifizierten Tokens)
Berechtigungs-Scopes
Jedes API Token hat einen oder mehrere Berechtigungs-Scopes, die steuern, auf welche Tools es zugreifen kann:
| Scope | Tools |
|---|---|
widgets:read | list_widgets, get_widget, list_builtin_widgets, get_builtin_widget |
widgets:write | create_widget, update_widget, delete_widget |
render | test_render |
| (kein Scope erforderlich) | get_widget_guide |
Standardmäßig werden neue Tokens mit allen drei Scopes erstellt: widgets:read, widgets:write und render.
Integrierte Prompts
Der MCP Server bietet außerdem geführte Prompts, die KI-Assistenten durch mehrstufige Arbeitsabläufe leiten:
create_widget
Ein geführter Arbeitsablauf zum Erstellen eines neuen Widgets von Grund auf. Der KI-Assistent wird:
- Die Widget-Entwicklungsanleitung lesen
- Ihre Anforderungen erfassen (Datenstruktur, gewünschtes Layout)
- Das HTML-Template mit Handlebars und Tailwind CSS erstellen
- Das Template testweise rendern, um es zu validieren
- Das Widget in Ihrem Konto erstellen
improve_widget
Ein geführter Arbeitsablauf zur Verbesserung eines bestehenden Widgets. Geben Sie eine Widget-GUID an, und der KI-Assistent wird:
- Das aktuelle Template und die Konfiguration des Widgets abrufen
- Es anhand von Best Practices überprüfen
- Konkrete Verbesserungen vorschlagen
- Das aktualisierte Template testweise rendern
- Die Änderungen anwenden
Nächste Schritte
Bereit es auszuprobieren? Bitten Sie Ihren KI-Assistenten:
- „Liste meine Widgets auf"
- „Erstelle ein Wetter-Widget, das die aktuelle Temperatur anzeigt"
- „Verbessere mein KPI Dashboard Widget"