MCP Tool

Desktop: Widget INSERT

Legt ein Widget in einer Leiste an: KPI-Widget (widget=kpi, app, variable aus select_sdkinvisible_desktop_kpi_katalog, optional titel und felder) oder ein Katalog-Widget (widget=<Katalog-ID>). Ohne nur_pruefen wird der Desktop danach aktualisiert. Mit nur_pruefen=true entsteht ausschliesslich eine KPI-Vorschau, bei verifiziertem Chat als dort gespeichertes echtes Widget; keine Desktopinstanz. Bei chat_artifact_status.gespeichert=true die zurueckgegebene artifact_id unveraendert in der Antwort nennen, damit die Chatkarte zugeordnet werden kann. Keine Desktop-ID oder ASCII-Diagramme erfinden.

Tool-Name

tool

insert_desktop_widget

Parameter

Parameter	Typ	Pflicht	Beschreibung
`inhalt`	`object`	Nein	–

Input Schema

json

{
    "type": "object",
    "properties": {
        "inhalt": {
            "type": "object",
            "properties": {
                "widget": {
                    "type": "string",
                    "description": "kpi (Standard) oder Katalog-ID"
                },
                "app": {
                    "type": "string",
                    "description": "App der Kennzahl"
                },
                "variable": {
                    "type": "string",
                    "description": "Variable der Kennzahl"
                },
                "titel": {
                    "type": "string",
                    "description": "Optional: eigener Titel"
                },
                "felder": {
                    "type": "object",
                    "description": "Optional: KPI-Einstellungen als flache Formularfelder, z. B. {\"filter__datumsauswahl\":\"dieses_jahr\"}"
                },
                "leiste": {
                    "type": "string",
                    "enum": [
                        "left",
                        "right",
                        "control"
                    ],
                    "description": "left (Standard), right oder control"
                },
                "position": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Optional: Position in der Leiste (0 = oben)"
                },
                "raum": {
                    "type": "string",
                    "description": "Optional: Raum-ID; leer = global (in allen Raeumen)"
                },
                "nur_pruefen": {
                    "type": "boolean",
                    "description": "Optional: true = KPI-Vorschau ohne Desktopaenderung. Mit desktop_schluessel der aktuellen Chatnachricht wird die Vorschau dort als echtes Widget gespeichert; chat_artifact_status meldet den separaten Speicherstatus."
                },
                "revision": {
                    "type": "string",
                    "description": "Optional: revision aus select_sdkinvisible_desktop_widgets (Konfliktschutz)"
                },
                "desktop_schluessel": {
                    "type": "string",
                    "pattern": "^dk_[a-f0-9]{32}$",
                    "description": "desktop_schluessel aus der aktuellen Chatnachricht ([tricoma-Desktop] desktop_schluessel=dk_...). Im Agentic Chat immer mitgeben."
                }
            },
            "additionalProperties": false
        }
    }
}

Beispiel-Aufruf

json

{
    "tool": "insert_desktop_widget",
    "arguments": {
        "inhalt": {}
    }
}