Serveur MCP pour agents de code

fonctionnel

Permettez à Claude Code, Cursor, VS Code et Windsurf d'utiliser vos connexions enregistrées en lecture seule via MCP, sans partager de mots de passe.

SQLly peut faire office de Serveur Model Context Protocol (MCP), donc des agents de codage tels que Claude Code, Cursor, VS Code, Windsurf et Claude Desktop peuvent utiliser les connexions que vous avez déjà enregistrées dans SQLly. L'agent peut lister les connexions, parcourir les tables, lire les définitions des colonnes, obtenir un résumé du schéma et exécuter un seul SELECT à la fois avec un nombre de lignes limité. Il ne voit jamais de mot de passe, et les connexions de production sont toujours refusées.

  • Local et uniquement stdio. L'agent démarre sqlly-cli mcp sur votre machine et communique avec elle via l'entrée et la sortie standard. Rien n'écoute sur un port réseau.
  • Lecture seule par défaut. Les écritures sont possibles uniquement si vous choisissez de les autoriser, et même dans ce cas, chacune d'elles s'ouvre dans SQLly pour que vous puissiez la confirmer.
  • Les mots de passe restent dans votre trousseau. Le serveur se connecte lui-même à vos bases de données ; l'agent ne reçoit que les noms de connexion, le texte du schéma et les lignes de résultats.

Mise en place

  1. Ouvrir Paramètres › IA › MCP et trouvez SQLLY comme serveur MCP.
  2. Choisissez le Plafond global: Lecture seule (par défaut), ou Lecture/écriture avec confirmation. Choisissez quelles connexions enregistrées exposer.
  3. Appuyez sur le bouton de copie pour votre agent : Copier pour Claude Code, Copier pour Cursor, Copier pour VS Code, Copier pour Windsurf ou Copier pour Claude Desktop, et collez l'extrait là où cet agent définit ses serveurs MCP.
  4. Demandez à l'agent de lister vos connexions SQLly.

Les fragments nomment le chemin complet vers sqlly-cli, l'outil en ligne de commande qui est inclus dans l'application. SQLly le cherche d'abord à côté de l'application, puis sur votre PATH; s'il ne trouve ni l'un ni l'autre, le snippet indique simplement sqlly-cli. Les formes sont :

# Claude Code
claude mcp add --transport stdio sqlly -- /path/to/sqlly-cli mcp

// Cursor, Windsurf and Claude Desktop
{ "mcpServers": { "sqlly": { "command": "/path/to/sqlly-cli", "args": ["mcp"] } } }

// VS Code (.vscode/mcp.json)
{ "servers": { "sqlly": { "type": "stdio", "command": "/path/to/sqlly-cli", "args": ["mcp"] } } }

Le même volet contient aussi une liste de externe Serveurs MCP. Cette liste part dans l'autre sens : les serveurs auxquels SQLly se connecte pour que son propre assistant IA connaisse les outils qu'ils proposent. Vous n'en avez pas besoin pour permettre à un agent d'utiliser SQLly.

Ce que l'agent peut faire

OutilCe que cela fait
list_connectionsListe les connexions exposées avec leur moteur, serveur, base de données, environnement, et si chacune est en production ou en lecture seule.
list_tablesListe les tables dans la base de données d'une connexion.
describe_tableColonnes, types et nullabilité pour une table.
get_schema_contextUn résumé du schéma adapté à un budget de tokens.
run_readonly_queryExécute un SELECT et renvoie jusqu'à la limite de lignes. Tout le reste est refusé sans exécution.
open_in_appOuvre un onglet de requête dans SQLly, éventuellement avec du SQL prérempli. Rien ne s'exécute.
propose_writePropose une instruction de modification des données à confirmer dans SQLly (uniquement lorsque les écritures sont autorisées).
get_proposal_statusIndique si une proposition est en attente, ouverte, exécutée, rejetée ou expirée.

Modes lecture seule et lecture/écriture

Le Plafond global définit le maximum autorisé par une connexion. Chaque connexion peut ensuite être réglée à un niveau inférieur : Hériter du global, Verrouillé (pas du tout exposé), Lecture seule, ou Lecture/écriture avec confirmation. Une connexion ne dépasse jamais le plafond global.

La lecture seule est appliquée par la base de données, pas seulement par la vérification de la requête de SQLly. Sur PostgreSQL, MySQL et MariaDB, chaque requête s'exécute dans une transaction en lecture seule qui est toujours annulée ; SQLite l'exécute en mode requête seule ; SQL Server, qui n’a pas de transaction en lecture seule, l’exécute à l’intérieur d’une transaction annulée avec un contrôle des instructions. Sur ClickHouse, seul le SELECT-only est l'écran qui s'applique, et les commandes Redis sont vérifiées par rapport à une liste en lecture seule.

Avec les écritures autorisées, propose_write ne lance jamais quoi que ce soit lui-même. SQLly ouvre la requête dans un nouvel onglet de requête, affiche un nombre de lignes estimé et un résumé du plan sur une seule ligne lorsque le moteur le permet, et l'exécute uniquement via la boîte de dialogue de confirmation habituelle une fois que vous avez approuvé.

La production est interdite. Une connexion est en production quand son environnement est Production, ou quand vous l'avez marquée comme telle. L'agent peut la voir dans la liste, et tous les autres outils la refusent, lectures comprises.

Limites

  • Lignes et cellules. 100 lignes maximum par requête (par défaut et plafond), et les valeurs de cellule trop longues sont tronquées à 200 caractères par défaut (jusqu'à 2000).
  • Limites de débit. Par défaut 60 requêtes, 5 écritures et 2 modifications de schéma par minute, ajustables jusqu'à 600, 60 et 20.
  • Délai d'inactivité. Le serveur s'arrête par défaut après 15 minutes sans requête (réglable de 30 secondes à un jour).

Le journal d'activité

SQLly consigne chaque appel d'outil de l'agent et l'issue de chaque proposition dans un journal privé sur votre machine. Chaque entrée comporte l'heure, l'outil, la connexion, la base de données, la durée, le nombre de lignes et le résultat. Le SQL y est stocké sous forme expurgée, jamais avec ses valeurs littérales. Appuyez sur Ouvrir l'activité MCP dans les paramètres du MCP pour le parcourir, filtrer par outil, résultat ou connexion, et l'exporter en CSV ou JSON.

Édition Mac App Store

Le bac à sable d'Apple empêche les applications de l'App Store de démarrer d'autres programmes, donc l'édition du Mac App Store ne peut pas servir de serveur MCP pour d'autres applications, ni lancer de serveurs MCP locaux (stdio). Les serveurs MCP accessibles via HTTP continuent de fonctionner. Voir macOS et le Mac App Store.