Agents IA

StackQL donne aux agents IA la même interface SQL que celle utilisée par les humains pour interroger, provisionner et exploiter des services cloud et SaaS. Un agent découvre ce qu'un provider expose, valide une requête avant son exécution, lit l'état en temps réel avec SELECT et le modifie avec INSERT, UPDATE et DELETE, sans fichier d'état ni SDK par cloud.

Comment les agents se connectent

• MCP sur stdio pour les clients d'éditeur et de bureau tels que Claude Desktop, Cursor et Continue. Le client lance lui-même stackql mcp --mcp.server.type=stdio. Consultez Serveur MCP.
• MCP sur HTTP pour les agents autonomes et les automatisations qui se connectent à un processus stackql mcp ou stackql srv de longue durée, avec authentification par jeton bearer et TLS facultatif.
• MCP embarqué pour les applications compilées : le serveur s'exécute dans le même processus en Go, Rust, Swift, Kotlin, .NET et Gleam. Consultez MCP embarqué.
• Protocole filaire PostgreSQL via stackql srv pour les frameworks d'agents, les notebooks et les outils de BI qui parlent déjà Postgres.

Démarrage rapide avec Claude Desktop

Installez le serveur depuis l'Anthropic Connector Directory (recommandé) ou le MCP Bundle téléchargeable, ou enregistrez-le à la main dans 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"
      }
    }
  }
}

N'incluez que les identifiants des providers que vous prévoyez d'utiliser. La procédure complète, y compris les téléchargements du bundle et l'utilisation d'un fichier d'identifiants, se trouve dans Utiliser StackQL avec Claude Desktop.

Ce qu'un agent peut faire

Le serveur MCP expose un petit ensemble d'outils typés. Chaque outil renvoie une vue rendue pour le modèle et une charge utile structurée pour les clients programmatiques.

• Découvrir : list_providers, list_services, list_resources, list_methods et describe_method parcourent la hiérarchie des providers et renvoient les entrées et les champs de sortie de chaque opération, de sorte que les paramètres WHERE obligatoires sont connus avant l'écriture d'une requête.
• Valider et lire : validate_select_query analyse et planifie un SELECT sans l'exécuter ; run_select_query l'exécute.
• Modifier : run_mutation_query exécute INSERT, UPDATE, REPLACE et DELETE ; run_lifecycle_operation exécute les opérations de cycle de vie EXEC. Les deux sont contrôlés par le mode du serveur décrit ci-dessous.
• Administration : server_info, list_registry, pull_provider et reload_credentials.

La référence complète, avec les entrées, le comportement de contrôle et un exemple de prompt par outil, se trouve dans Outils MCP.

Garde-fous

Le mode du serveur fixe le contrat de sécurité pour toute la session :

Mode	SELECT / métadonnées	INSERT / UPDATE / REPLACE	DELETE / EXEC
read_only	autorisé	refusé	refusé
safe (par défaut)	autorisé	approbation requise	approbation requise
delete_safe	autorisé	autorisé	approbation requise
full_access	autorisé	autorisé	autorisé

"Approbation requise" repose sur l'élicitation MCP : les clients qui la prennent en charge (Claude Desktop, Cursor, Continue) montrent à l'utilisateur le nom de l'outil, la classe de requête et le SQL, puis attendent une décision avant toute exécution ; les clients qui ne l'annoncent pas sont refusés. Chaque appel d'outil est écrit dans un journal d'audit, les écouteurs HTTP exigent un jeton bearer, et les identifiants proviennent de l'environnement ou d'un fichier dotenv sans que les valeurs secrètes soient jamais renvoyées au client. Les détails se trouvent dans Modes du serveur, Authentification des clients HTTP et Journal d'audit.

Étapes suivantes

• Serveur MCP - modes de déploiement, configuration, modes du serveur, journal d'audit et options.
• Outils MCP - la référence complète des outils avec les entrées, le contrôle et des exemples de prompts.
• MCP embarqué - exécuter le serveur dans votre propre application Go, Rust, Swift, Kotlin, .NET ou Gleam.
• Query Library - du SQL prêt à exécuter pour les questions courantes d'exploitation cloud, par provider.
• Référence IA - concepts, guides pratiques, comparaisons et dépannage, rédigés pour les agents et les personnes qui les construisent.