Zum Inhalt springen

MCP Client Invoke Tools-Aktivität in Jitterbit Studio

Einführung

Eine MCP Client Invoke Tools-Aktivität verwendet ihre MCP Client-Verbindung und führt ein bestimmtes Tool auf einem MCP-Server aus. Sie ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen. Verwenden Sie zunächst die List Tools-Aktivität, um verfügbare Tools und deren erforderliche Felder anzuzeigen.

Erstellen einer MCP Client Invoke Tools-Aktivität

Eine Instanz einer MCP Client Invoke Tools-Aktivität wird aus einer MCP Client-Verbindung mit dem Aktivitätstyp Invoke Tools erstellt.

Um eine Aktivitätsinstanz zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Entwurfsfläche ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

Eine vorhandene MCP Client Invoke Tools-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer MCP Client Invoke Tools-Aktivität

Führen Sie diese Schritte aus, um eine MCP Client Invoke Tools-Aktivität zu konfigurieren:

Schritt 1: Namen eingeben und Einstellungen festlegen

Geben Sie in diesem Schritt einen Namen für die Aktivität an und legen Sie das Tool fest. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

Tipp

Felder mit einem -Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das -Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen.

  • Endpunkt-Menü: Wenn Sie mehrere Endpunkte desselben Connector-Typs konfiguriert haben, wird oben auf dem Bildschirm ein Menü mit dem aktuellen Endpunktnamen angezeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpunkt ändern in Konfigurationsbildschirme.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den aktuellen Endpunktnamen bewegen. Klicken Sie, um die Verbindungskonfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

  • Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede MCP Client Invoke Tools-Aktivität eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

  • Tool auswählen: Sie können ein Tool mit einer dieser beiden Optionen angeben: Tool-Namen manuell angeben oder Tool aus Liste auswählen.

    • Tool-Namen manuell angeben: Wählen Sie diese Option, um den Namen des Tools auf dem MCP-Server anzugeben. Wenn diese Option ausgewählt ist, ist dieses Feld sichtbar:

      • Tool-Name: Geben Sie den Namen des Tools ein.

    • Tool aus Liste auswählen: (Standard.) Wählen Sie diese Option, um aus einer Liste der auf dem MCP-Server verfügbaren Tools auszuwählen. Wenn diese Option ausgewählt ist, ist dieses Feld sichtbar:

  • Tool auswählen: In diesem Bereich werden die im MCP-Server verfügbaren Tools angezeigt.

  • Ausgewähltes Tool: Nach der Auswahl eines Tools wird es hier aufgelistet.

  • Suche: Geben Sie einen beliebigen Wert aus einer Spalte in das Suchfeld ein, um die Tool-Liste zu filtern. Die Suche berücksichtigt keine Groß- und Kleinschreibung. Wenn Tools bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Tools vom Endpunkt beim Suchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann wie unten beschrieben.

  • Aktualisieren: Klicken Sie auf das Symbol oder das Wort Aktualisieren, um die Tools vom MCP-Server-Endpunkt neu zu laden. Dies kann nützlich sein, wenn dem MCP-Server neue Tools hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der angezeigten Tool-Tabelle in der Konfiguration verwendet werden.

  • Tool auswählen: Klicken Sie in der Tabelle auf eine beliebige Stelle in einer Zeile, um ein Tool auszuwählen. Es kann nur ein Tool ausgewählt werden. Die für jedes Tool verfügbaren Informationen werden vom MCP-Server-Endpunkt abgerufen:

    • Name: Der Name des Tools.

    • Beschreibung: Die Beschreibung des Tools.

Tipp

Wenn die Tabelle nicht mit verfügbaren Tools gefüllt wird, ist die MCP-Server-Verbindung möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen.

  • Bei Fehler fortfahren: Wählen Sie diese Option, um die Aktivitätsausführung fortzusetzen, wenn bei einem Datensatz in einer Batch-Anfrage ein Fehler auftritt. Falls Fehler auftreten, werden diese in das Operationsprotokoll geschrieben.

  • Speichern und beenden: Klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf der letzten Seite auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die in einem beliebigen Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Datenschemas überprüfen

Alle Anfrage- oder Antwortschemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Datenschemas: Diese Datenschemas werden von angrenzenden Transformationen geerbt und werden während der Transformationszuordnung erneut angezeigt.

    Der MCP Client-Connector verwendet das Model Context Protocol. Die Schemaknoten und Felder werden vom MCP-Server definiert. Verwenden Sie zunächst die Aktivität „Tools auflisten", um verfügbare Tools und deren erforderliche Felder anzuzeigen.

  • Aktualisieren: Klicken Sie auf das Symbol oder das Wort Aktualisieren, um Schemas vom MCP Client-Endpunkt neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden Transformation.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die in einem beliebigen Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer MCP Client-Aktivität Tools aufrufen schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten, Transformationen oder Skripte als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit bieten, Vorgänge zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Designoberfläche zugänglich. Weitere Informationen finden Sie unter Menü „Aktivitätsaktionen" in Connector-Grundlagen.

MCP Client Invoke Tools Aktivitäten können mit diesen Operationsmustern als Ziel verwendet werden:

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Skriptfunktion.

Wenn alles bereit ist, stellen Sie die Operation bereit und führen Sie sie aus und überprüfen Sie das Verhalten durch Kontrolle der Operationsprotokolle.