Cloud/Crear Conector/OpenAPI / Swagger
OpenAPI / Swagger
El tercer camino de Create Connector: conecta tu API con una sola URL. Vinkius descubre tus endpoints y los convierte en herramientas que los agentes de IA pueden usar, con las anotaciones mapeadas automáticamente.
OpenAPI / Swagger es el tercer camino dentro de Create Connector, y es el más rápido cuando tu API ya existe. La tarjeta de la consola lo dice en una frase: "Connect your API with one URL. Vinkius discovers your endpoints and turns them into tools AI agents can use." Las dos etiquetas nombran el resultado: Auto-generates tools y AI-ready annotations. No describe tu API, solo la señalas.
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.
El mockup es el wizard real. Pega una URL de spec y observa la detección: el conteo de endpoints llega en esmeralda mientras el nombre y la base URL se rellenan solos. Continúa por Security y Governance, y despliega.
Una URL. Todas las herramientas.
El panel educativo declara la oferta: "Paste your spec URL and we do the rest: endpoints discovered, tools generated, annotations mapped. AI agents can use them instantly." La letra pequeña es generosa: OpenAPI 2.0, 3.0, 3.1. JSON o YAML. Nosotros lo resolvemos.
El primer paso pide la OpenAPI / Swagger URL. Mientras escribes, la consola inspecciona la spec: gira un spinner azul "Detecting...", y luego una línea esmeralda anuncia el resultado, "{count} endpoints ready for AI". Una spec que no resuelve recibe el rojo "Invalid spec URL. Make sure it points to a valid OpenAPI/Swagger file." Antes de pegar nada, el campo se explica solo: "Auto-discovers and generates all tools for your AI agents instantly."
El resto del formulario se rellena solo
La detección no se detiene en el conteo de endpoints. El Server Name se rellena desde el título de la spec, y su placeholder cambia a "Auto-detected ✓". La Base URL es opcional: si la dejas vacía, aparece "Auto-detected from the OpenAPI spec if left empty." Puedes sobrescribir ambos; la cuestión es que normalmente no hace falta.
Security: las credenciales nunca salen del vault
El segundo paso pregunta cómo se autentica tu API. Las opciones de Auth Type son None · Public API, Bearer Token, Basic Auth (user:password) y Custom Header (con su nombre y valor de header). Si la propia spec declara un esquema de seguridad, un banner azul lo informa: "Security detected in spec: Bearer Token. Select below if your API requires it." Todo lo que escribas lleva una promesa, escrita en esmeralda en el formulario: "AES-256 encrypted at rest. Credentials never leave your vault." Las claves se cifran en reposo, se inyectan en runtime y son invisibles para el modelo; los agentes llaman a tu API a través de Vinkius, nunca con tus secretos en su contexto.
Governance: protege lo que importa
El tercer paso ofrece dos switches, ambos opcionales y ambos editables después desde settings:
- 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, con la insignia Cost Control: "Large arrays shrink automatically. Same data, fewer tokens. Your context window stays focused."
Estas son las mismas políticas que puedes gestionar por conector más tarde en DLP Protection y FinOps Guard; este paso solo fija los valores por defecto al nacer.
El deploy y lo que sale de él
Deploy to Edge ejecuta las fases del modo swagger: parsear las specs OpenAPI, sellar el V8 Isolate Sandbox, inyectar el Zero-Trust DLP, distribuir al edge global. Entonces tu conector is Live! con su Connection Token de un solo uso y el config JSON mcpServers listo para copiar o descargar, con una pestaña por cliente: Claude, Cursor, VS Code, Antigravity y Others. A partir de ahí se comporta como cualquier conector: Dashboard para vigilarlo, AI Capabilities para revisar las herramientas que generó la spec, Playground para ejecutarlas.
Por qué existe este camino
Miles de APIs ya hablan OpenAPI. Este camino convierte esa descripción existente en AI Capabilities sin escribir una línea de código de integración: entra una URL, sale cada endpoint como una herramienta que un agente puede invocar, anotada y gobernada desde la primera petición.
Qué viene después
El último camino de Create Connector tiene su propia guía: Manual Setup (¿sin spec? añade tu API a mano, paso a paso). Después de los caminos, el Seller Account de la consola cubre la publicación en el marketplace.