Zum Inhalt springen

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

Einführung

Eine OpenAI Register MCP Server Tools-Aktivität registriert mithilfe ihrer OpenAI-Verbindung einen Remote-MCP-Server als Tool-Anbieter bei OpenAI und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen. Im Gegensatz zu den OpenAI-Aktivitäten Register Tools und Register Tools V2, die benutzerdefinierte Funktionsaufrufe-Tool-Definitionen registrieren, verbindet diese Aktivität OpenAI direkt mit einem Remote-MCP-Server, sodass die Tools dieses Servers einer verketteten Prompt V2-Aktivität zur Verfügung stehen.

Wenn der Vorgang ausgeführt wird, speichert Jitterbit den registrierten MCP-Server und seine aufgelöste Tool-Liste, sodass jeder Vorgang, der nach diesem ausgeführt wird, automatisch 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-Agent-Gruppen können dies mithilfe der Einstellung Store chat context across operations (V2 activities only) in der OpenAI-Verbindung über Vorgänge hinweg beibehalten. Es ist nicht erforderlich, die Antwort der Register MCP Server Tools-Aktivität zu erfassen oder die Tool-Definitionen explizit an den nachfolgenden Prompt V2-Vorgang zu übergeben.

Hinweis

Diese Aktivität nutzt OpenAIs eigene MCP-Tool-Unterstützung, um sich direkt mit einem Remote-MCP-Server zu verbinden. Sie ist unabhängig vom MCP Client-Connector und verarbeitet keine Ausgabe aus der List Tools-Aktivität des MCP Client-Connectors.

Unterstützte OpenAI-Modelle

Diese Aktivität kann für die Verwendung eines dieser OpenAI-Modelle konfiguriert werden:

OpenAI-Aktivität „Register MCP Server Tools" erstellen

Eine Instanz einer OpenAI-Aktivität Register MCP Server Tools wird aus einer OpenAI-Verbindung mit dem Aktivitätstyp Register MCP Server Tools erstellt.

Um eine Aktivitätsinstanz zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Aktivitäts- oder Tool-Instanz erstellen in Komponentenwiederverwendung.

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

OpenAI-Aktivität „Register MCP Server Tools" konfigurieren

Führen Sie diese Schritte aus, um eine OpenAI-Aktivität Register MCP Server Tools zu konfigurieren:

Schritt 1: Name eingeben und Einstellungen festlegen

Geben Sie in diesem Schritt einen Namen für die Aktivität an und legen Sie den zu verwendenden MCP-Server und das Modell 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 mehrere Endpunkte desselben Connector-Typs konfiguriert sind, 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 OpenAI-Aktivität Register MCP Server Tools 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 starten, können Sie die in ihrer Antwort zurückgegebene chatId in eine Variable schreiben, auf die hier verwiesen 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 vorhandenen Assistenten.

  • Eingabeaufforderungstext: Geben Sie eine Eingabeaufforderung ein, die zusammen mit der Registrierungsanfrage gesendet werden soll, z. B. um das Modell aufzufordern, die verfügbaren Tools aufzulisten. Wenn Sie das Feld leer lassen, wird die Standard-Eingabeaufforderung List all available tools verwendet.

  • Modell: Wählen Sie über das Menü ein unterstütztes OpenAI-Modell aus. Das Standard-Modell ist gpt-4.

  • MCP-Server-Label: Geben Sie ein Label ein, um den MCP-Server zu identifizieren, z. B. github-mcp.

  • MCP-Server-URL: Geben Sie die URL des Remote-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 durch Bereitstellung eines tools-Arrays, wobei jeder Eintrag sein eigenes server_label, server_url und access_token angibt. Die Felder MCP-Server-Label, MCP-Server-URL und MCP-Server-Zugriffstoken des Assistenten gelten nur für den ersten Server in diesem Array.

  • Speichern und 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 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 Anforderungs- 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 Datenzuordnung von Transformationen 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 Schemaknoten und Feldern finden Sie in der API-Dokumentation.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Schemas vom OpenAI-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 OpenAI-Aktivität MCP-Server-Tools registrieren schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten oder Tools 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.

Um einen MCP-Tool-Calling-Workflow abzuschließen, verketten Sie einen Prompt V2-Vorgang, der nach diesem ausgeführt werden soll, und konfigurieren Sie ihn mit derselben chatId. Da Jitterbit die registrierten Server-Tools zur Verwendung durch diesen Vorgang speichert (im Speicher auf privaten Agenten oder mithilfe der Einstellung Store chat context across operations (V2 activities only) auf Cloud-Agent-Gruppen), erhält der Prompt V2-Vorgang sie automatisch ohne zusätzliche Zuordnung.

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

OpenAI-Aktivitäten MCP-Server-Tools registrieren 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 diesen temporären Speicherort dann in der Skriptfunktion.

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