Serveur MCP pour agents de code
fonctionnelPermettez à 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 mcpsur 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
- Ouvrir Paramètres › IA › MCP et trouvez SQLLY comme serveur MCP.
- Choisissez le Plafond global: Lecture seule (par défaut), ou Lecture/écriture avec confirmation. Choisissez quelles connexions enregistrées exposer.
- 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.
- 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
| Outil | Ce que cela fait |
|---|---|
list_connections | Liste les connexions exposées avec leur moteur, serveur, base de données, environnement, et si chacune est en production ou en lecture seule. |
list_tables | Liste les tables dans la base de données d'une connexion. |
describe_table | Colonnes, types et nullabilité pour une table. |
get_schema_context | Un résumé du schéma adapté à un budget de tokens. |
run_readonly_query | Exécute un SELECT et renvoie jusqu'à la limite de lignes. Tout le reste est refusé sans exécution. |
open_in_app | Ouvre un onglet de requête dans SQLly, éventuellement avec du SQL prérempli. Rien ne s'exécute. |
propose_write | Propose une instruction de modification des données à confirmer dans SQLly (uniquement lorsque les écritures sont autorisées). |
get_proposal_status | Indique 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é.
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.