Zum Inhalt springen

OpenAI Register MCP Server Tools-Aktivität in Jitterbit Studio

Einführung

Eine OpenAI Register MCP Server Tools-Aktivität, die ihre OpenAI-Verbindung verwendet, registriert einen entfernten MCP-Server als Tool-Anbieter bei OpenAI und ist dazu gedacht, als Ziel zum Konsumieren von Daten in einem Vorgang verwendet zu werden. Im Gegensatz zu den OpenAI Register Tools und Register Tools V2 Aktivitäten, die benutzerdefinierte Funktionsaufruf-Tool-Definitionen registrieren, verbindet diese Aktivität OpenAI direkt mit einem entfernten MCP-Server, sodass die Tools dieses Servers in einer verketteten Prompt V2 Aktivität verfügbar werden.

Wenn der Vorgang ausgeführt wird, speichert Jitterbit den registrierten MCP-Server und seine aufgelöste Tool-Liste, sodass jeder nachfolgende Vorgang, der automatisch ausgeführt wird, Zugriff auf die Tools des registrierten Servers hat, wenn er eine Prompt V2-Aktivität mit derselben chatId aufruft. Private Agenten speichern dies im Speicher; Cloud-Agentengruppen können es über Vorgänge hinweg mit der Einstellung Chat-Kontext über Vorgänge hinweg speichern (nur V2-Aktivitäten) in der OpenAI-Verbindung beibehalten. Sie müssen die Register MCP Server Tools-Antwort nicht erfassen oder die Tool-Definitionen explizit an den nachfolgenden Prompt V2-Vorgang übergeben.

Hinweis

Diese Aktivität nutzt die eigene MCP-Tool-Unterstützung von OpenAI, um direkt mit einem entfernten MCP-Server zu verbinden. Sie ist unabhängig vom MCP Client Connector und verbraucht keine Ausgaben aus der List Tools Aktivität des MCP Client Connectors.

Unterstützte OpenAI-Modelle

Diese Aktivität kann so konfiguriert werden, dass sie eines dieser OpenAI Modelle verwendet:

Erstellen einer OpenAI Register MCP Server Tools-Aktivität

Eine Instanz einer OpenAI Register MCP Server Tools-Aktivität wird aus einer OpenAI-Verbindung unter Verwendung des Aktivitätstyps Register MCP Server Tools erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsgrafik oder kopieren Sie den Aktivitätstyp und fügen Sie ihn in die Entwurfsgrafik ein. Für Details siehe Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.

Eine vorhandene OpenAI Register MCP Server Tools-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer OpenAI Register MCP Server Tools-Aktivität

Befolgen Sie diese Schritte, um eine OpenAI Register MCP Server Tools-Aktivität zu konfigurieren:

Schritt 1: Geben Sie einen Namen ein und spezifizieren Sie die Einstellungen

In diesem Schritt geben Sie einen Namen für die Aktivität an und spezifizieren den MCP-Server sowie das Modell, das verwendet werden soll. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

Tipp

Felder mit einem Variablen-Icon unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben oder indem Sie auf das Variablen-Icon klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

  • Endpoint-Menü: Wenn Sie mehrere Endpunkte des gleichen Verbindungstyps konfiguriert haben, wird ein Menü oben auf dem Bildschirm angezeigt, das den aktuellen Endpunktnamen anzeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Ändern des zugewiesenen Endpunkts in Konfigurationsbildschirmen.

    • Endpunkt bearbeiten: Erscheint, wenn Sie über den aktuellen Endpunktnamen fahren. Klicken Sie, um die Verbindungs-Konfiguration 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 OpenAI Register MCP Server Tools-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Chat-ID: Geben Sie die chatId ein. Wenn Sie eine Prompt V2-Aktivität verwenden, um ein Gespräch zu beginnen, können Sie die chatId, die in der Antwort zurückgegeben wird, in eine Variable schreiben, die hier referenziert wird. Wenn Sie keine chatId angeben, wird automatisch eine generiert; in diesem Fall gilt der registrierte Server nur für ein neues Gespräch und nicht für einen bestehenden Assistenten.

  • Prompt-Text: Geben Sie einen Prompt ein, der zusammen mit der Registrierungsanfrage gesendet werden soll, um beispielsweise das Modell zu bitten, die verfügbaren Tools aufzulisten. Wenn das Feld leer bleibt, wird der Standardprompt List all available tools verwendet.

  • Modell: Verwenden Sie das Menü, um ein unterstütztes OpenAI-Modell auszuwählen. Das Standardmodell ist gpt-4.

  • MCP-Serverbezeichnung: Geben Sie eine Bezeichnung ein, um den MCP-Server zu identifizieren, zum Beispiel github-mcp.

  • MCP-Server-URL: Geben Sie die URL des entfernten MCP-Servers ein, den Sie registrieren möchten.

  • MCP-Server-Zugriffstoken: Geben Sie das Zugriffstoken ein, das zur Authentifizierung beim MCP-Server verwendet wird.

    Hinweis

    Das Anforderungsschema unterstützt auch die Registrierung mehrerer MCP-Server in einem einzigen Aufruf, indem ein tools-Array bereitgestellt wird, wobei jeder Eintrag sein eigenes server_label, server_url und access_token angibt. Die Felder MCP-Serverbezeichnung, MCP-Server-URL und MCP-Server-Zugriffstoken gelten nur für den ersten Server in diesem Array.

  • Speichern & Beenden: Wenn aktiviert, 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 fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Schritt 2: Überprüfen der Datenschemas

Alle Anforderungs- oder Antwortschemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

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

    Hinweis

    Daten, die in einer Transformation bereitgestellt werden, haben Vorrang vor der Aktivitätskonfiguration.

    Der OpenAI-Connector verwendet die OpenAI Responses API. Weitere Informationen zu den Schema-Knoten und -Feldern finden Sie in der API-Dokumentation.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um die Schemata vom OpenAI-Endpunkt neu zu generieren. Diese Aktion regeneriert auch ein Schema an anderen Stellen im Projekt, an denen dasselbe Schema referenziert wird, wie zum Beispiel in einer benachbarten 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: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Nächste Schritte

Nachdem Sie eine OpenAI Register MCP Server Tools-Aktivität konfiguriert haben, vervollständigen Sie die Konfiguration des Vorgangs, indem Sie andere Aktivitäten oder Tools als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Betriebseinstellungen konfigurieren, die die Möglichkeit umfassen, Vorgänge zusammenzuführen, die sich in denselben oder unterschiedlichen Workflows befinden.

Um einen MCP-Toolaufruf-Workflow abzuschließen, verknüpfen Sie einen Prompt V2-Vorgang, der nach diesem ausgeführt wird, und konfigurieren Sie ihn mit derselben chatId. Da Jitterbit die registrierten Tools des Servers für die Verwendung durch diesen Vorgang speichert (im Speicher auf privaten Agenten oder mithilfe der Einstellung Chat-Kontext über Vorgänge hinweg speichern (nur V2-Aktivitäten) in Cloud-Agent-Gruppen), erhält der Prompt V2-Vorgang diese automatisch, ohne dass eine zusätzliche Zuordnung erforderlich ist.

Menüaktionen für eine Aktivität sind im Projektbereich und auf der Entwurfsgrafik zugänglich. Weitere Informationen finden Sie im Aktivitätsaktionsmenü in Connector-Grundlagen.

OpenAI Register MCP Server Tools-Aktivitäten können als Ziel mit diesen Vorgangsmustern verwendet werden:

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

Wenn Sie bereit sind, setzen Sie die Operation ein und führen Sie sie aus und validieren Sie das Verhalten, indem Sie die Betriebsprotokolle überprüfen.