MCP Fusion/Integrations and federation/YAML-Konnektoren

YAML-Konnektoren

Frag die KI über Vinkius

Erstellen Sie ohne TypeScript einen REST-basierten MCP-Connector: Geheimnisse, Verbindungen, Tools, Ressourcen, Prompts und Antworttransformationen in mcpfusion.yaml.

Die YAML-Engine ist der Weg zur Erstellung ohne Code. Sie kompiliert ein deklaratives Manifest in dieselbe MCP-Oberfläche wie ein typisierter Server: Tools mit Parametern, Presenter über Antworttransformationen, Ressourcen, Prompts und Verbindungen. Verwenden Sie sie, um schnell eine interne REST-API zu kapseln. Wechseln Sie zu typisiertem MVA-Code, wenn die Domäne eigenes Verhalten benötigt.

Ein vollständiges Manifest

yaml

version: "1.0"
server:
  name: billing
  description: Invoice operations for an AI agent
  capabilities:
    tools: true
    resources: true
secrets:
  BILLING_TOKEN:
    label: Billing API token
    type: api_key
    required: true
    sensitive: true
connections:
  billing:
    type: rest
    base_url: https://api.example.com
    auth:
      type: bearer
      token: ${SECRETS.BILLING_TOKEN}
tools:
  - name: list_invoices
    description: List invoices for the current account
    rules:
      - Never expose internal_notes to the model
    parameters:
      account_id:
        type: string
        required: true
        description: Account identifier
    execute:
      connection: billing
      method: GET
      path: /accounts/{{account_id}}/invoices
    response:
      extract: [data]
      max_items: 50

Der Parser validiert das Root-Schema mit Zod, prüft Querverweise, interpoliert ${SECRETS.KEY} aus der Umgebung, kompiliert Parameter zu JSON Schema, löst die Verbindung auf und erstellt einen lokalen MCP Server.

Die Manifest-Oberfläche

server: Name, Beschreibung, Capabilities und Anweisungen
secrets: typisierte Deklarationen wie api_key, token, password, url sowie die Flags required und sensitive
connections: REST-Basis-URL, Authentifizierung (none, bearer, basic oder custom header), Header, Timeout und Wiederholungsrichtlinie
tools: Beschreibung, Anweisung, Regeln, Tags, Annotationen, Parameter, HTTP-execute-Block und Antworttransformation
resources: URI-Vorlagen, statischer oder abgerufener Inhalt, MIME-Typ und optionaler Cache
prompts: flache primitive Argumente und Nachrichten-Vorlagen für Benutzer und Assistenten mit {{argument}}
settings: Deklarationen für Exposition, DLP, FinOps, Circuit Breaker und Lebenszyklus

Die CLI

bash

mcpfusion yaml validate mcpfusion.yaml
mcpfusion yaml dev mcpfusion.yaml --transport http --port 3001

Die CLI entdeckt mcpfusion.yaml oder mcpfusion.yml automatisch im aktuellen Verzeichnis. validate endet nach Schema- und Querverweisprüfungen. dev führt standardmäßig stdio oder Streamable HTTP am ausgewählten Port aus.

Das aktuelle YAML-Paket enthält die Befehle validate und dev in der OSS-CLI. Deployen Sie den kompilierten Connector über den regulären Deploy-Ablauf. Gehen Sie nicht von einem separaten YAML-Deploy-Befehl aus, sofern Ihre installierte CLI ihn nicht anbietet.

Was OSS erzwingt

Die offene Engine erzwingt Schemaform, Pflichtfelder, Parametertypen, Querverweise, Secret-Interpolation und REST-Ausführung. Die settings-Schlüssel für DLP, FinOps, Circuit Breaker und Lebenszyklus werden als Teil des Manifests geparst. Die Durchsetzung dieser Plattformkontrollen gehört zu Vinkius Cloud. Dadurch kann dasselbe YAML lokal ausgeführt werden, während der gehostete Connector den Plattformperimeter erhält.

Wenn YAML nicht mehr ausreicht

Wählen Sie typisierten MVA-Code, wenn Sie dynamische Presenter, rollenabhängige Schemas, benutzerdefinierte Middleware, Transaktionen, FSM-Zustandssperren, Generator-Handler oder domänenspezifische Fehlerwiederherstellung benötigen. Die Migration ist keine Neuschreibung des Protokolls: Dieselben Tools, Ressourcen und Prompts können mit initMCPFusion() neu erstellt und mit demselben Befehl deployed werden.

Nächste Schritte

The MVA pattern: der typisierte Pfad, auf den YAML kompiliert
Credentials: vom Käufer verwaltete Geheimnisse deklarieren
CLI: die gemeinsamen Entwicklungsbefehle