Cloud/コネクタを作成/OpenAPI / Swagger
OpenAPI / Swagger
Create Connectorの3番目のパス: URLを1つでAPIに接続します。Vinkiusがエンドポイントを検出し、AIエージェントが使えるツールに変換します。アノテーションは自動でマッピングされます。
OpenAPI / Swaggerは、Create Connectorの中の3番目のパスで、APIがすでに存在する場合に最速のものです。コンソールのカードは一言で言っています: "Connect your API with one URL. Vinkius discovers your endpoints and turns them into tools AI agents can use." 2つのタグがその成果を示します: Auto-generates toolsとAI-ready annotations。APIを説明する必要はありません。指し示すだけです。
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.
モックアップは本物のウィザードです。specのURLを貼り付けると検出の様子がわかります: エンドポイント数がエメラルド色で表示され、名前とベースURLが自動で埋まっていきます。SecurityとGovernanceを進んで、デプロイしましょう。
1つのURL、すべてのツール
教育パネルはこう約束します: "Paste your spec URL and we do the rest: endpoints discovered, tools generated, annotations mapped. AI agents can use them instantly." 細かな条件も寛大です: OpenAPI 2.0、3.0、3.1。JSONでもYAMLでも。すべてこちらで対応します。
最初のステップではOpenAPI / Swagger URLを求められます。入力すると、コンソールがspecを検査します: 青い "Detecting..." スピナーが回り、その後エメラルド色の行が結果を告げます: "{count} endpoints ready for AI"。解決しないspecには赤い "Invalid spec URL. Make sure it points to a valid OpenAPI/Swagger file." が表示されます。何も貼る前には、フィールドが自らを説明します: "Auto-discovers and generates all tools for your AI agents instantly."
フォームの残りは自動で埋まる
検出はエンドポイント数で止まりません。Server Nameはspecのタイトルから埋まり、プレースホルダーは "Auto-detected ✓" に変わります。Base URLは "Auto-detected from the OpenAPI spec if left empty." の通りオプションです。どちらも上書きできますが、通常はその必要がない、というのがポイントです。
Security: 認証情報がvaultの外に出ることはありません
2番目のステップではAPIの認証方法を尋ねます。Auth Typeの選択肢は、None · Public API、Bearer Token、Basic Auth (user:password)、Custom Header(ヘッダー名と値を指定)です。spec自体がセキュリティスキームを宣言していれば、青いバナーが知らせます: "Security detected in spec: Bearer Token. Select below if your API requires it." 入力したものはすべて、フォームにエメラルド色で書かれた約束を伴います: "AES-256 encrypted at rest. Credentials never leave your vault." キーは保存時に暗号化され、実行時に注入され、モデルからは見えません。エージェントはVinkiusを通じてAPIを呼び出し、あなたの秘密がコンテキストに入ることはありません。
Governance: 大切なものを守る
3番目のステップは2つのスイッチを用意します。どちらも任意で、後から設定画面で変更できます:
- 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、バッジはCost Control: "Large arrays shrink automatically. Same data, fewer tokens. Your context window stays focused."
これらは後からDLP ProtectionとFinOps Guardでコネクタごとに管理できるのと同じポリシーです。このステップは誕生時にデフォルトを決めるだけです。
デプロイと、そこから出てくるもの
Deploy to Edgeはswaggerモードのフェーズを実行します: OpenAPI specの解析、V8 Isolate Sandboxの封印、Zero-Trust DLPの注入、グローバルedgeへの配信。その後、コネクタが is Live! になり、一度だけ表示されるConnection Tokenと、コピーまたはダウンロードできるmcpServersのconfig JSONが示されます。クライアントごとのタブとして、Claude、Cursor、VS Code、Antigravity、Othersが並びます。そこからはすべてのコネクタと同じように振る舞います: 監視はDashboard、specが生成したツールの確認はAI Capabilities、実行はPlaygroundです。
このパスが存在する理由
何千ものAPIがすでにOpenAPIを話しています。このパスは、その既存の説明をAI Capabilitiesに変えます。統合コードを1行も書かずに: URLを1つ入れると、すべてのエンドポイントがエージェントが呼び出せるツールとして出てきます。最初のリクエストからアノテーションとガバナンスが付いています。
次にやること
Create Connectorの最後のパスには専用のガイドがあります: Manual Setup(specがない? APIを手作業で順番に追加)。パスの後は、コンソールのSeller Accountがmarketplaceへの出品を扱います。