MCP-Tool
Ein Werkzeug eines eigenen MCP-Servers als festen Workflow-Schritt aufrufen
Der Knoten MCP-Tool ruft genau ein Werkzeug eines eigenen MCP-Servers auf, mit den Werten, die Sie im Knoten eintragen. Er arbeitet wie eine Integrationsaktion: Jeder Lauf macht denselben Aufruf, ohne KI-Modell dazwischen. Sie finden ihn in der Knotenauswahl unter Integrationen, sofern Sie die Berechtigung MCP-Server nutzen haben.
Soll ein Modell selbst entscheiden, ob und welches Werkzeug es aufruft, geben Sie das Werkzeug stattdessen dem KI-Agenten als Tool.
Konfiguration
- MCP-Server: einer Ihrer verbundenen MCP-Server. Angeboten werden die Server, die Sie auch im KI-Agenten auswählen können.
- Tool: eines der Werkzeuge des Servers. Kennt die Auswahl die Werkzeuge noch nicht, fragt sie den Server; Aktualisieren lädt die Liste neu.
- Eingaben: Der Knoten zeigt ein Feld für jedes Argument des Werkzeugs, mit dem Namen, der Beschreibung und der Angabe „erforderlich“, die der Server festlegt.
| Argument des Werkzeugs | Feld im Knoten |
|---|---|
| Text | Textfeld |
| Zahl | Zahlenfeld (eine Ganzzahl muss ganzzahlig sein) |
| Ja/Nein | Schalter |
| Feste Auswahl | Auswahlliste |
| Objekt oder Liste | JSON-Feld |
| Komplexe Beschreibung | ein einziges JSON-Feld Arguments für alle Argumente |
In jedem Feld funktionieren Variablen wie {{trigger.outputs.bestellnummer}}, wie in jedem anderen Knoten. Ein leeres optionales Feld wird nicht an den Server geschickt.
Ändert der Server später die Argumente oder Ausgaben des Werkzeugs, zeigt der Knoten einen Hinweis. Felder aktualisieren übernimmt den neuen Stand und behält, was Sie bereits eingetragen haben, wo das Feld noch passt. Von selbst ändert sich nichts.
Ausgaben
| Ausgabe | Typ | Beschreibung |
|---|---|---|
result | object | Das strukturierte Ergebnis des Werkzeugs, wenn es eines liefert, sonst sein Text. Text, der JSON ist, wird als Objekt gelesen |
content | array | Die Inhalte, so wie der Server sie liefert. Bilder und Dateien werden als Workflow-Dateien gespeichert und stehen unter file bereit |
isError | boolean | Ob das Werkzeug einen Fehler gemeldet hat; bei einem erfolgreichen Lauf immer false |
Ein späterer Knoten liest ein Feld des Ergebnisses mit {{mcpTool.outputs.result.feldName}}. Beschreibt der Server die Ausgaben seines Werkzeugs, zeigt die Variablenauswahl diese Felder schon vor dem ersten Lauf.
Fehler und Freigaben
Meldet das Werkzeug einen Fehler, schlägt der Knoten fehl und das Protokoll nennt die Meldung des Servers. Mit Fehlerausgabe verwenden nimmt der Workflow stattdessen den Fehlerausgang, und die Meldung steht dort als {{mcpTool.outputs.error}} bereit.
Ein ausgewähltes Werkzeug gilt als freigegeben, im Workflow fragt niemand nach. Der Knoten schlägt mit einer Meldung fehl, die den Grund nennt, wenn
- die Person mit der Verbindung das Werkzeug unter Berechtigungen auf Nie erlauben gestellt hat,
- ihr die Berechtigung MCP-Server nutzen fehlt oder die Organisation den Server für sie abgeschaltet hat,
- der Server das Werkzeug unter diesem Namen nicht mehr anbietet.
Ändert das Werkzeug Daten, schalten Sie für den Knoten am besten Genehmigung erforderlich ein.
Mit dem Workflow-Assistenten
Der Assistent im Workflow-Builder kennt Ihre MCP-Server und ihre Werkzeuge. Bitten Sie ihn etwa: „Nutze meinen Server Bestellungen, um für jede Formular-Einsendung eine Bestellung anzulegen“, legt er den Knoten an und füllt die Felder.