Erstellen von Swagger-MCP-Servern

Erstellen Sie einen Swagger-MCP-Server in Orchestrator, indem Sie ein OpenAPI-Dokument bereitstellen, das die API beschreibt, die als Tools verfügbar gemacht werden soll.

Hinweis:

Diese Funktion befindet sich in der Vorschau.

Ein Swagger-MCP-Server wandelt ein OpenAPI-Dokument in MCP-Tools um. Sie stellen das Dokument bereit, und jeder darin beschriebene Vorgang wird zu einem Tool, das der Server über HTTP aufruft.

Voraussetzungen

• Die Ordnerberechtigung Erstellen für MCP-Server.
• Das OpenAPI-Dokument für die API, entweder als URL oder als Datei, die Sie einfügen können.

Erstellen Sie einen Swagger-MCP-Server

1. Wählen Sie unter Agent Gateway > MCP-Server das Menü MCP-Server hinzufügen .

2. Wählen Sie unter Extern die Option Swagger aus.

3. Geben Sie einen Namen ein. Dies ist der Anzeigename, der in der Serverliste angezeigt wird.

4. Geben Sie eine Slug ein.

   Hinweis:

   Die Slug akzeptiert nur Kleinbuchstaben, Ziffern und Bindestriche und muss zwischen 3 und 50 Zeichen lang sein. Es wird das letzte Segment der Server-URL.

5. Geben Sie optional eine Beschreibung mit bis zu 500 Zeichen ein.

6. Wählen Sie aus, wie das OpenAPI-Dokument bereitgestellt werden soll: Wählen Sie Von-URL aus und geben Sie die Swagger-URL ein, von der es bereitgestellt wird, oder wählen Sie JSON einfügen und fügen Sie das Dokument selbst ein.

   Hinweis:

   Von URL ist die zu bevorzugende Option, da nur dies das spätere Aktualisieren der Tools unterstützt. Verwenden Sie „JSON einfügen“, wenn das Dokument nicht an einer Adresse bereitgestellt wird, die UiPath erreichen kann. Wenn Sie zwischen den beiden Optionen wechseln, wird gelöscht, was Sie in der anderen eingegeben haben.

7. Wählen Sie den Verbindungstyp aus: Standard , um eine Verbindung direkt über das öffentliche Internet herzustellen, oder Privat (Relay), um den Datenverkehr über UiPath Relay für eine API in Ihrem eigenen Netzwerk weiterzuleiten.

8. Fügen Sie die von der API erwarteten Header , einen pro Zeile, im Format Name:value hinzu.

   Hinweis:

   Der aufgelöste Wert wird als konfigurierter Header an die API gesendet. Verwenden Sie daher Asset-gestützte Header nur für Endpunkte, denen Sie diese Geheimnisse vertrauen.

   Anstatt ein Geheimnis einzufügen, geben Sie einem Header einen Wert im Format %ASSETS/AssetName% an. UiPath löst es anhand des Assets im Serverordner auf, bevor die Anforderung gesendet wird, und der Aufruf schlägt fehl, anstatt einen ungelösten Platzhalter weiterzuleiten, wenn das Asset nicht gelesen werden kann. Die Autovervollständigung listet nur Assets auf, die Automatisierungen und API-Zugriff zulassen.

9. Erweitern Sie optional die Guardrails und konfigurieren Sie sie.

10. Wählen Sie Hinzufügen aus.

Ergebnis: UiPath liest das Dokument, ruft es ab, wenn Sie eine URL angegeben haben, und erstellt ein Tool für jeden beschriebenen Vorgang. Wenn das Dokument nicht gelesen werden kann, wird der Server nicht erstellt und der Fehler gibt den Grund an. Wählen Sie URL kopieren in der Zeile des Servers aus, um die Adresse abzurufen:

https://cloud.uipath.com/{org_name}/{tenant_name}/agenthub_/mcp/{folder_key}/{server_slug}

Text-, Geheimnis-, Bool-, Integer-, Anmeldeinformations- und Windows-Anmeldeinformations-Assets werden für Asset-gestützte Header unterstützt; Anmeldedaten und Windows-Anmeldedaten werden in den Kennwortwert aufgelöst. Schlüsselwertlisten-Assets werden nicht unterstützt, da ein Header-Wert in eine Zeichenfolge aufgelöst werden muss.

Um Änderungen später an der API zu übernehmen, wählen Sie Aktualisieren auf dem Server aus. Es liest das Dokument erneut aus seiner URL und erstellt die Toolliste neu; Verbundene Clients sehen die neue Liste, wenn sie das nächste Mal nach einer fragen. Ein Server, der aus einem eingefügten Dokument erstellt wurde, hat keine URL, die erneut gelesen werden muss. Wenn er also aktuell bleibt, muss das eingefügte Dokument bearbeitet werden.

Hinweis:

Bei einer Standardverbindung hat die Anforderung, die UiPath an die API stellt, ein Timeout von 30 Sekunden und ein Antwortlimit von 1 MiB, und der Toolaufruf wird offen gehalten, bis er zurückgegeben wird. Vorgänge mit langer Ausführungszeit und Vorgänge, die große Nutzlasten zurückgeben, eignen sich nicht gut für diesen Servertyp.

Aufrufe werden auf der Registerkarte Ausführungen auf dem Server angezeigt.

Informationen dazu, wie Aufrufer authentifizieren und welche Berechtigungen sie benötigen, finden Sie unter MCP-Serverauthentifizierung. Um diesen Servertyp zu sehen und wie er mit den anderen verglichen wird, aktivieren Sie MCP-Servertypen.