Cloud/Connector erstellen/OpenAPI / Swagger
OpenAPI / Swagger
Der dritte Pfad in Create Connector: Verbinden Sie Ihre API mit einer einzigen URL. Vinkius entdeckt Ihre Endpoints und macht daraus Tools, die KI-Agenten nutzen können, mit automatisch gemappten Annotationen.
OpenAPI / Swagger ist der dritte Pfad innerhalb von Create Connector, und es ist der schnellste, wenn Ihre API bereits existiert. Die Karte der Konsole sagt es in einem Satz: "Connect your API with one URL. Vinkius discovers your endpoints and turns them into tools AI agents can use." Die beiden Tags benennen den Nutzen: Auto-generates tools und AI-ready annotations. Sie beschreiben Ihre API nicht, Sie zeigen nur auf sie.
Deploy Connector
Connect your API to AI agents in under 30 seconds.
Auto-discovers and generates all tools for your AI agents instantly.
Auto-detected from the OpenAPI spec if left empty.
Das Mockup ist der echte Wizard. Fügen Sie eine Spec-URL ein und sehen Sie der Erkennung zu: Die Endpoint-Anzahl erscheint in Smaragdgrün, während Name und Base URL sich von selbst füllen. Fahren Sie mit Security und Governance fort, dann deployen Sie.
Eine URL. Jedes Tool.
Das Schulungspannel nennt das Angebot: "Paste your spec URL and we do the rest: endpoints discovered, tools generated, annotations mapped. AI agents can use them instantly." Das Kleingedruckte ist großzügig: OpenAPI 2.0, 3.0, 3.1. JSON oder YAML. Wir kümmern uns darum.
Der erste Schritt verlangt die OpenAPI / Swagger URL. Während Sie tippen, inspiziert die Konsole die Spec: Ein blauer "Detecting..."-Spinner läuft, dann verkündet eine smaragdgrüne Zeile das Ergebnis, "{count} endpoints ready for AI". Eine Spec, die nicht auflöst, bekommt die rote Meldung "Invalid spec URL. Make sure it points to a valid OpenAPI/Swagger file." Bevor etwas eingefügt ist, erklärt sich das Feld selbst: "Auto-discovers and generates all tools for your AI agents instantly."
Der Rest des Formulars füllt sich von selbst
Die Erkennung stoppt nicht bei der Endpoint-Anzahl. Der Server Name füllt sich aus dem Titel der Spec, und sein Placeholder wechselt zu "Auto-detected ✓". Die Base URL ist optional, weil sie "Auto-detected from the OpenAPI spec if left empty." ist. Sie können beide überschreiben; der Punkt ist, dass Sie es normalerweise nicht müssen.
Security: Credentials verlassen niemals den Vault
Der zweite Schritt fragt, wie sich Ihre API authentifiziert. Die Auth Type-Optionen sind None · Public API, Bearer Token, Basic Auth (user:password) und Custom Header (mit Header-Name und -Wert). Deklariert die Spec selbst ein Security-Schema, meldet das ein blaues Banner: "Security detected in spec: Bearer Token. Select below if your API requires it." Alles, was Sie eingeben, trägt ein Versprechen, in Smaragdgrün auf dem Formular geschrieben: "AES-256 encrypted at rest. Credentials never leave your vault." Schlüssel werden at-rest verschlüsselt, zur Laufzeit injiziert und sind für das Modell unsichtbar; Agenten rufen Ihre API über Vinkius auf, niemals mit Ihren Secrets in ihrem Kontext.
Governance: Schützen Sie, was zählt
Der dritte Schritt bietet zwei Schalter, beide optional und beide später in den Einstellungen editierbar:
- Zero-Trust PII Redaction: "Masks emails, SSNs, and credit cards in RAM before returning data to the AI. GDPR-compliant by default."
- Smart Array Truncation, mit dem Badge Cost Control: "Large arrays shrink automatically. Same data, fewer tokens. Your context window stays focused."
Dies sind dieselben Richtlinien, die Sie später pro Connector in DLP Protection und FinOps Guard verwalten können; dieser Schritt legt nur die Defaults bei der Geburt fest.
Der Deploy und was herauskommt
Deploy to Edge durchläuft die Swagger-Phasen: die OpenAPI-Specs parsen, die V8 Isolate Sandbox versiegeln, Zero-Trust DLP injizieren, an die globale Edge verteilen. Dann ist Ihr Connector is Live! mit dem einmaligen Connection Token und dem Config-JSON mcpServers, fertig zum Kopieren oder Herunterladen, mit einem Tab pro Client: Claude, Cursor, VS Code, Antigravity und Others. Von dort an verhält er sich wie jeder Connector: Dashboard zum Beobachten, AI Capabilities zum Prüfen der Tools, die die Spec generiert hat, Playground zum Ausführen.
Warum es diesen Pfad gibt
Tausende APIs sprechen bereits OpenAPI. Dieser Pfad macht aus dieser bestehenden Beschreibung AI Capabilities, ohne eine Zeile Integrationscode zu schreiben: eine URL hinein, jeder Endpoint heraus als Tool, das ein Agent aufrufen kann, annotiert und geregelt ab der ersten Anfrage.
Wie es weitergeht
Der letzte Create-Connector-Pfad hat seinen eigenen Guide: Manual Setup (keine Spec? Fügen Sie Ihre API von Hand hinzu, Schritt für Schritt). Nach den Pfaden deckt der Seller Account der Konsole das Listing im Marketplace ab.