KI-Agenten

StackQL gibt KI-Agenten dieselbe SQL-Schnittstelle, die Menschen zum Abfragen, Bereitstellen und Betreiben von Cloud- und SaaS-Services verwenden. Ein Agent ermittelt, was ein Provider bereitstellt, validiert eine Abfrage vor der Ausführung, liest den Live-Zustand mit SELECT und ändert ihn mit INSERT, UPDATE und DELETE, ohne State-Datei und ohne SDK pro Cloud.

Wie sich Agenten verbinden

• MCP über stdio für Editor- und Desktop-Clients wie Claude Desktop, Cursor und Continue. Der Client startet stackql mcp --mcp.server.type=stdio selbst. Siehe MCP-Server.
• MCP über HTTP für eigenständige Agenten und Automatisierung, die sich mit einem dauerhaft laufenden stackql mcp- oder stackql srv-Prozess verbinden, mit Bearer-Token-Authentifizierung und optionalem TLS.
• Eingebettetes MCP für kompilierte Anwendungen: Der Server läuft im Prozess in Go, Rust, Swift, Kotlin, .NET und Gleam. Siehe Eingebettetes MCP.
• PostgreSQL-Wire-Protokoll über stackql srv für Agenten-Frameworks, Notebooks und BI-Tools, die bereits Postgres sprechen.

Schnellstart mit Claude Desktop

Installieren Sie aus dem Anthropic Connector Directory (empfohlen) oder dem herunterladbaren MCP Bundle, oder registrieren Sie den Server von Hand in claude_desktop_config.json:

{
  "mcpServers": {
    "stackql": {
      "command": "stackql",
      "args": ["mcp", "--mcp.server.type=stdio", "--tls.allowInsecure"],
      "env": {
        "AWS_ACCESS_KEY_ID": "your-aws-access-key-id",
        "AWS_SECRET_ACCESS_KEY": "your-aws-secret-access-key"
      }
    }
  }
}

Geben Sie nur die Anmeldedaten für die Provider an, die Sie verwenden möchten. Die vollständige Anleitung, einschließlich der Bundle-Downloads und der Verwendung einer Datei mit Anmeldedaten, finden Sie unter StackQL mit Claude Desktop verwenden.

Was ein Agent tun kann

Der MCP-Server stellt einen kleinen, typisierten Satz von Tools bereit. Jedes Tool liefert eine gerenderte Ansicht für das Modell und eine strukturierte Payload für programmatische Clients.

• Entdecken: list_providers, list_services, list_resources, list_methods und describe_method durchlaufen die Provider-Hierarchie und geben die Eingaben und Ausgabefelder jeder Operation zurück, sodass erforderliche WHERE-Parameter bekannt sind, bevor eine Abfrage geschrieben wird.
• Validieren und lesen: validate_select_query parst und plant ein SELECT, ohne es auszuführen; run_select_query führt es aus.
• Ändern: run_mutation_query führt INSERT, UPDATE, REPLACE und DELETE aus; run_lifecycle_operation führt EXEC-Lebenszyklusoperationen aus. Beide unterliegen dem unten beschriebenen Servermodus.
• Verwaltung: server_info, list_registry, pull_provider und reload_credentials.

Die vollständige Referenz mit Eingaben, Freigabeverhalten und einem Beispiel-Prompt pro Tool finden Sie unter MCP-Tools.

Schutzmechanismen

Der Servermodus legt den Sicherheitsvertrag für die gesamte Sitzung fest:

Modus	SELECT / Metadaten	INSERT / UPDATE / REPLACE	DELETE / EXEC
read_only	erlaubt	abgelehnt	abgelehnt
safe (Standard)	erlaubt	Freigabe erforderlich	Freigabe erforderlich
delete_safe	erlaubt	erlaubt	Freigabe erforderlich
full_access	erlaubt	erlaubt	erlaubt

"Freigabe erforderlich" verwendet MCP-Elicitation: Clients, die sie unterstützen (Claude Desktop, Cursor, Continue), zeigen dem Benutzer den Tool-Namen, die Abfrageklasse und das SQL an und warten auf eine Entscheidung, bevor etwas ausgeführt wird; Clients, die sie nicht ankündigen, werden abgelehnt. Jeder Tool-Aufruf wird in ein Audit-Log geschrieben, HTTP-Listener erfordern ein Bearer-Token, und Anmeldedaten stammen aus der Umgebung oder einer dotenv-Datei, ohne dass geheime Werte jemals an den Client zurückgegeben werden. Details finden Sie unter Servermodi, HTTP-Client-Authentifizierung und Audit-Log.

Nächste Schritte

• MCP-Server - Deployment-Modi, Konfiguration, Servermodi, Audit-Log und Flags.
• MCP-Tools - die vollständige Tool-Referenz mit Eingaben, Freigabeverhalten und Beispiel-Prompts.
• Eingebettetes MCP - den Server in Ihrer eigenen Go-, Rust-, Swift-, Kotlin-, .NET- oder Gleam-Anwendung ausführen.
• Query Library - sofort ausführbares SQL für gängige Fragen des Cloud-Betriebs, nach Provider.
• KI-Referenz - Konzepte, Anleitungen, Vergleiche und Fehlerbehebung, geschrieben für Agenten und die Menschen, die sie bauen.