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
Datentabellen
list_tables
Listet alle Datentabellen für Ihr Konto auf.
Parameter: Keine
Erforderlicher Scope: tables:read
get_table
Ruft das vollständige Schema einer Datentabelle anhand ihrer GUID ab.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
tableGuid | string | Ja | Die eindeutige Kennung der Datentabelle |
Erforderlicher Scope: tables:read
list_rows
Listet Zeilen einer Datentabelle mit Paginierung, optionaler Sortierung und Filterung auf.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
tableGuid | string | Ja | Die eindeutige Kennung der Datentabelle |
page | number | Nein | Seitennummer (Standard: 1) |
pageSize | number | Nein | Zeilen pro Seite (Standard: 50, max: 200) |
sortBy | string | Nein | Spalten-Key zum Sortieren |
sortDir | string | Nein | Sortierrichtung: asc oder desc |
filters | array | Nein | Array von Filterobjekten mit column, operator und value |
Erforderlicher Scope: tables:read
create_table
Erstellt eine neue Datentabelle mit Name und optionalen Spaltendefinitionen.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
name | string | Ja | Tabellenname (max. 255 Zeichen) |
description | string | Nein | Tabellenbeschreibung (max. 1000 Zeichen) |
columns | array | Nein | Spaltendefinitionen |
Erforderlicher Scope: tables:write
update_table_schema
Aktualisiert die Spaltendefinitionen einer Datentabelle.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
tableGuid | string | Ja | Die eindeutige Kennung der Datentabelle |
columns | array | Ja | Neue Spaltendefinitionen |
Erforderlicher Scope: tables:write
delete_table
Löscht eine Datentabelle dauerhaft anhand ihrer GUID.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
tableGuid | string | Ja | Die eindeutige Kennung der Datentabelle |
Erforderlicher Scope: tables:write
create_row
Fügt eine neue Zeile in eine Datentabelle ein.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
tableGuid | string | Ja | Die eindeutige Kennung der Datentabelle |
data | object | Ja | Zeilendaten als { spaltenKey: wert }-Paare |
Erforderlicher Scope: tables:rows
update_row
Aktualisiert eine bestehende Zeile in einer Datentabelle.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
tableGuid | string | Ja | Die eindeutige Kennung der Datentabelle |
rowGuid | string | Ja | Die eindeutige Kennung der Zeile |
data | object | Ja | Aktualisierte Zeilendaten |
Erforderlicher Scope: tables:rows
delete_row
Markiert eine Zeile als gelöscht (Soft-Delete).
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
tableGuid | string | Ja | Die eindeutige Kennung der Datentabelle |
rowGuid | string | Ja | Die eindeutige Kennung der Zeile |
Erforderlicher Scope: tables:rows
Der Scope tables:write beinhaltet implizit die tables:rows-Berechtigungen.
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 |
tables:read | list_tables, get_table, list_rows |
tables:write | create_table, update_table_schema, delete_table (beinhaltet auch tables:rows) |
tables:rows | create_row, update_row, delete_row |
| (kein Scope erforderlich) | get_widget_guide |
Standardmäßig werden neue Tokens mit allen sechs Scopes erstellt: widgets:read, widgets:write, render, tables:read, tables:write und tables:rows.
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"