Haeufige Fragen
Was ist FlowMCP genau?
FlowMCP ist eine Schema-Library + Engine, die Datenquellen zu AI-aufrufbaren Tools normalisiert. Die Library enthaelt aktuell 373 produktionsreife Schemas (v4) ueber 291 Datenquellen. Die Engine routet Calls, validiert Inputs/Outputs und handhabt Authentifizierung. AI-Agenten rufen FlowMCP; FlowMCP ruft die zugrundeliegenden APIs.
Brauche ich einen MCP-kompatiblen Client?
Nein. FlowMCP ist CLI-First. Der MCP-Server-Modus ist optional. Wenn dein Client dynamisches Tool-Loading unterstuetzt, funktioniert MCP — sonst ist die CLI der bevorzugte Einstieg.
Was bedeutet CLI-First konkret?
Du rufst flowmcp call <schema>.<tool> '{...}' aus deinem Terminal, einem LLM-Call oder einem Node/Python-Script. Tools werden bei Bedarf geladen — keine Notwendigkeit, 1608 Tools im Kontext zu halten.
Wo leben API-Keys?
API-Keys leben in ~/.flowmcp/.env, optional mit Projekt-Overrides. Die AI sieht nie einen Key — nur Calls und Antworten. Das ist Absicht: bei direkten REST-Calls aus der AI heraus wuerden Keys exposed.
Wie fuege ich ein neues Schema hinzu?
Siehe Specification und repos/flowmcp-schemas-private fuer den Schema-Creation-Guide. Validation-Rules haben explizite IDs (z.B. RES001). PRs gehen ins Schemas-Repo mit Tests.
Kann ich FlowMCP offline nutzen?
Ja — fuer Schemas mit lokalen Ressourcen (z.B. das gtfs-sqlite-toolkit-Add-on mit konvertierter SQLite-DB). Fuer Schemas, die Remote-APIs callen, brauchst du weiter Netz.
Was ist der Spec-Versions-Status?
FlowMCP unterstuetzt aktuell die v4-Spezifikation (aktiv) und v4.1-Add-on-Erweiterungen (z.B. gtfs-sqlite-toolkit). Aeltere Versionen (v3, v2, v1.x) bleiben aus Kompatibilitaetsgruenden ladbar, erhalten aber keine neuen Schemas.
Warum heisst FlowMCP "MCP", wenn es CLI-First ist?
Der Name kommt vom Projektstart als MCP-Server-Experiment. Die Substanz hat sich Richtung CLI-First-Schema-Layer verschoben; der Name bleibt fuer Kontinuitaet mit dem MCP-Oekosystem.
Wo melde ich Issues?
GitHub Issues pro Repo. Finde das passende Repository unter github.com/FlowMCP und oeffne dort ein Issue. Fuer Schema-Fragen: flowmcp-schemas. Fuer CLI-Bugs: flowmcp-cli.
Was ist das v4 Self-Contained Skill Pattern?
Skills bringen ihre eigene Parameter-Referenz mit — Schema-Daten stehen vor Workflow-Instruktionen. In einem Labortest erreichten Skills mit vollen Parameter/Enum/Beispiel-Infos 5/5 Erfolg gegen LLMs; Skills mit nur Name + Beschreibung 0/5. Das Pattern ist in der v4-Spec dokumentiert.
Sind FlowMCP-Schemas frei nutzbar?
Ja, MIT-lizensiert. Manche APIs brauchen Keys (du lieferst sie); die zurueckgegebenen Daten folgen deren Lizenz — z.B. GTFS-Feeds unter CC-BY 4.0 brauchen Attribution im Output. FlowMCP zeigt diese Attribution in der Response.