Cloud/Criar Conector/OpenAPI / Swagger
OpenAPI / Swagger
O terceiro caminho do Create Connector: conecte sua API com uma URL. O Vinkius descobre seus endpoints e os transforma em ferramentas que agentes de IA podem usar, com as anotações mapeadas automaticamente.
O OpenAPI / Swagger é o terceiro caminho dentro do Create Connector, e é o mais rápido quando sua API já existe. O card do console diz em uma frase: "Connect your API with one URL. Vinkius discovers your endpoints and turns them into tools AI agents can use." As duas tags nomeiam o resultado: Auto-generates tools e AI-ready annotations. Você não descreve sua API, você só aponta para ela.
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.
O mockup é o wizard real. Cole uma URL de spec e veja a detecção: a contagem de endpoints chega em verde enquanto o nome e a base URL se preenchem sozinhos. Continue por Security e Governance, depois publique.
One URL. Every tool.
O painel educacional declara a oferta: "Paste your spec URL and we do the rest: endpoints discovered, tools generated, annotations mapped. AI agents can use them instantly." A letra miúda é generosa: OpenAPI 2.0, 3.0, 3.1. JSON ou YAML. Nós resolvemos.
O primeiro passo pede a OpenAPI / Swagger URL. Enquanto você digita, o console inspeciona a spec: um spinner azul "Detecting..." roda, depois uma linha verde anuncia o resultado, "{count} endpoints ready for AI". Uma spec que não resolve recebe o vermelho "Invalid spec URL. Make sure it points to a valid OpenAPI/Swagger file." Antes de colar qualquer coisa, o campo se explica: "Auto-discovers and generates all tools for your AI agents instantly."
O resto do formulário se preenche sozinho
A detecção não para na contagem de endpoints. O Server Name preenche a partir do título da spec, e o placeholder dele vira "Auto-detected ✓". A Base URL é opcional porque é "Auto-detected from the OpenAPI spec if left empty." Você pode sobrescrever os dois; o ponto é que normalmente não precisa.
Security: credenciais nunca saem do vault
O segundo passo pergunta como sua API autentica. As opções de Auth Type são None · Public API, Bearer Token, Basic Auth (user:password) e Custom Header (com o nome e o valor do header). Se a própria spec declara um esquema de segurança, um banner azul avisa: "Security detected in spec: Bearer Token. Select below if your API requires it." Tudo que você digitar carrega uma promessa, escrita em verde no formulário: "AES-256 encrypted at rest. Credentials never leave your vault." As chaves são criptografadas em repouso, injetadas em runtime, e invisíveis para o modelo; os agentes chamam sua API através do Vinkius, nunca com seus segredos no contexto deles.
Governance: proteja o que importa
O terceiro passo oferece dois switches, ambos opcionais e ambos editáveis depois nas configurações:
- 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, com o selo Cost Control: "Large arrays shrink automatically. Same data, fewer tokens. Your context window stays focused."
Essas são as mesmas políticas que você pode gerenciar por conector depois em DLP Protection e FinOps Guard; este passo só define os padrões no nascimento.
O deploy e o que sai dele
O Deploy to Edge roda as fases do modo swagger: parsear as specs OpenAPI, selar o V8 Isolate Sandbox, injetar o Zero-Trust DLP, distribuir para o edge global. Então seu conector is Live! com o Connection Token de uso único e o config JSON mcpServers pronto para copiar ou baixar, com uma aba por cliente: Claude, Cursor, VS Code, Antigravity e Others. A partir daí ele se comporta como todo conector: Dashboard para observá-lo, AI Capabilities para revisar as ferramentas que a spec gerou, Playground para executá-las.
Por que este caminho existe
Milhares de APIs já falam OpenAPI. Este caminho transforma essa descrição existente em AI Capabilities sem escrever uma linha de código de integração: uma URL entra, todo endpoint sai como ferramenta que um agente pode chamar, anotada e governada desde o primeiro request.
O que vem a seguir
O último caminho do Create Connector tem seu próprio guia: Manual Setup (sem spec? adicione sua API à mão, passo a passo). Depois dos caminhos, o Seller Account do console cobre listar no marketplace.