Black Friday15 % de réduction sur l’Individuel mensuel. 5 % de réduction sur l’annuel + 1 place de courtoisie. Offre valable jusqu’au 29 novembre.
Serveur MCP local

Serveur MCP local

Dans Kerry Studio, le serveur MCP local relie vos connexions enregistrées à un client IA de bureau, comme Claude Desktop, ChatGPT, Gemini, Conductor, Cursor, OpenCode, entre autres. Sans lui, lister des tables, voir des colonnes ou exécuter du SQL dans le chat oblige à coller le schéma ou les résultats à la main.

Le serveur n’écoute que sur votre ordinateur. Les mots de passe, SSH et certificats restent protégés dans l’application. MCP ne les expose pas. L’assistant reçoit le projet, l’environnement, le type de base, le nom de la base, le schéma et les résultats des requêtes qu’il exécute. Kerry n’envoie pas cela aux serveurs de Sireeus. Ce qui parvient à l’assistant est configurable : quels projets et environnements le serveur peut utiliser, et quelles valeurs masquer dans mcp.log et dans la réponse. Le client IA peut encore envoyer ce que MCP a renvoyé à son modèle cloud. Utilisez-le seulement avec des agents auxquels vous faites confiance.

Avant de commencer

Il vous faut :

  • Un workspace ouvert dans Kerry Studio
  • Un client IA de bureau qui prend en charge MCP

Ouvrir le panneau

  1. Ouvrez un workspace.
  2. Dans la barre latérale droite, cliquez sur l’icône Serveur MCP.
  3. Ou utilisez le pied du workspace (MCP activé / MCP désactivé), ou la palette de commandes (⌘K / CtrlK) et choisissez Ouvrir le panneau MCP.

Par défaut, le serveur ne redémarre pas quand vous quittez et rouvrez Kerry Studio. Les préférences de démarrage sont dans Paramètres → MCP (icône engrenage dans l’en-tête Configuration du panneau, ou palette ⌘K / CtrlK → Paramètres : MCP) :

  • Au lancement de l’application → Démarrer avec le serveur activé : démarre le serveur MCP à l’ouverture de Kerry Studio (désactivé par défaut).
  • Au lancement de l’application → Toujours démarrer en lecture seule : au lancement suivant, revient en lecture seule même si la session précédente était en mode complet (activé par défaut).

Dans le panneau, l’icône livre à côté de l’engrenage ouvre la documentation (Ouvrir la documentation).

Configurer le client IA

  1. Dans le panneau, activez Activer le serveur MCP.
  2. Cliquez sur Copier le JSON.
  3. Collez le JSON dans les réglages MCP de votre client (ou fusionnez-le avec la config que vous avez déjà).
  4. Relancez le client s’il ne recharge pas les serveurs tout seul.

Si le client enregistre MCP comme binaire local, comme OpenCode, ne collez pas le JSON. Utilisez la commande dans Comment l’utiliser dans OpenCode.

L’adresse par défaut est http://127.0.0.1:18765/mcp. Port HTTP dans le panneau change ce port. Le champ est verrouillé tant que le serveur est allumé. Copier le JSON utilise le port actuel et le vrai jeton. N’utilisez pas l’exemple YOUR_TOKEN.

json
{
  "mcpServers": {
    "kerry-studio": {
      "url": "http://127.0.0.1:18765/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Comment l’utiliser dans OpenCode

Certains clients IA de bureau, comme OpenCode, enregistrent un serveur MCP comme binaire local par défaut. Kerry n’est pas ce type de serveur. Il écoute en HTTP sur votre ordinateur. Dans ces applications, enregistrez Kerry par l’URL, pas comme commande.

Le JSON au format mcpServers convient aux clients qui collent une configuration. Dans OpenCode, avec le serveur allumé dans le panneau, lancez :

bash
opencode mcp add kerry-studio --global --url http://127.0.0.1:18765/mcp --header 'Authorization=Bearer YOUR_TOKEN'

Remplacez YOUR_TOKEN par le jeton que Copier le JSON met dans le JSON. Si vous avez changé Port HTTP, utilisez ce port dans l’URL. --global rend Kerry disponible dans tous les projets OpenCode. Si la commande refuse cette option, votre version ne l’a pas. Lancez la même commande sans --global.

Lecture seule et mode complet

Par défaut, le serveur est en lecture seule : l’assistant peut lister les connexions, inspecter le schéma et exécuter des requêtes de lecture : SELECT, SHOW, DESCRIBE, EXPLAIN (y compris ANALYZE d’un SELECT). INSERT, UPDATE, DELETE, SELECT … FOR UPDATE, SELECT INTO, INTO OUTFILE, et les requêtes WITH qui changent des données sont refusés.

La lecture seule ouvre déjà la base dans la session de l’assistant. Sans cela, il n’y a ni schéma ni SELECT. Les onglets SQL de Kerry n’ont pas besoin d’être connectés.

Changer de mode dans le panneau prend effet tout de suite, donc vous n’avez pas besoin de relancer Kerry Studio.

Dans Paramètres → MCP → Lecture seule, Forcer la lecture seule au démarrage du serveur (activé par défaut) garde l’interrupteur Mode lecture seule du panneau coché et verrouillé, et applique la lecture seule chaque fois que le serveur est allumé.

Autorisations

Dans Kerry Studio, Autorisations restreignent les projets et les environnements enregistrés que le serveur MCP local peut utiliser. Sans cette restriction, toute connexion enregistrée est disponible pour l’assistant. Par défaut, tous les projets et environnements sont inclus.

La lecture seule et la lecture et l’écriture ont chacune leur liste. Vous pouvez laisser le mode lecture sur tout le catalogue et, en mode complet, ne débloquer que quelques projets.

Ouvrez Autorisations avec Configurer dans le panneau MCP, depuis Paramètres → MCP, ou depuis la palette (⌘K / CtrlK) sous MCP Autorisations.

Dans Autorisations du serveur MCP, le haut bascule entre Lecture seule et Lecture et écriture. En cours indique laquelle de ces listes le panneau applique maintenant : si Mode lecture seule est activé, la marque est sur Lecture seule ; s’il est désactivé, elle est sur Lecture et écriture. Modifier une liste ne change pas l’autre.

Dans la liste Lecture et écriture, Écriture par défaut définit Insérer, Mettre à jour et Supprimer pour la liste, les trois étant activés par défaut. Chaque projet ou connexion peut s’écarter de cette valeur. Le changement vaut pour la prochaine requête de l’assistant.

Si Autoriser tous les projets et environnements est activé, le serveur utilise tout le catalogue pour cette liste. Désactivez-le quand vous voulez choisir projet par projet.

Avec l’interrupteur désactivé, chaque projet et chaque environnement du projet a son propre contrôle. Sous Inclure automatiquement l’accès à, vous décidez si Nouveaux projets et leurs environnements actuels et Nouveaux environnements sur les projets s’ajoutent tout seuls. La recherche restreint ce qui s’affiche par projet, alias SQL (@alias) ou environnement. Tout activer et Tout désactiver portent sur ce qui est visible. La flèche à côté applique la même action à un environnement : Tout activer dans un environnement ou Tout désactiver dans un environnement.

Quand vous activez ou désactivez Mode lecture seule dans le panneau, Kerry applique la liste correspondante. Le changement vaut pour la prochaine requête de l’assistant. Si le projet n’est pas dans cette liste, Kerry n’ouvre pas la connexion pour l’assistant. Une requête avec @alias, par exemple @billing.orders, pointe vers une connexion enregistrée et est aussi bloquée si cette connexion n’est pas accessible.

Ce à quoi l’assistant peut accéder

Les erreurs de connexion ne renvoient ni nom d’utilisateur, ni hôte, ni mot de passe, ni chemin de fichier. Les résultats SQL que l’assistant reçoit omettent aussi les chemins de fichier, hôtes, URI de connexion et clés. La grille de l’onglet dans Kerry reste telle quelle.

La liste des connexions montre le projet, l’environnement, le type de base et le nom de la base (pour un fichier local, le nom du fichier, pas le chemin).

Avec le serveur allumé, l’assistant reçoit aussi :

  • les noms de tables et de vues
  • les colonnes et les détails de table
  • jusqu’à 500 lignes de chaque résultat SQL que l’assistant exécute
  • le contrôle de l’onglet de diagramme ER dans le workspace ouvert

Contrôler le diagramme ER

Dans Kerry Studio, l’assistant peut utiliser l’onglet de diagramme ER comme vous le feriez. Il ouvre l’onglet de ce projet et de cet environnement s’il n’existe pas encore, ou le met au premier plan s’il est déjà ouvert. Si cet onglet n’est pas encore connecté, utiliser le diagramme (synchroniser, filtrer, recadrer) le connecte et met à jour le schéma. L’assistant ne pilote que les onglets de diagramme ER. Les permissions MCP s’appliquent à l’ouverture, à la synchronisation et au changement d’environnement. Il filtre aussi les tables, change la disposition, met en avant les relations, ajuste le zoom et exporte l’image. À l’export, Kerry enregistre le fichier dans le dossier de Paramètres → MCP. Le bureau est le défaut. S’il n’y arrive pas, il demande où l’enregistrer. L’assistant reçoit le chemin complet. MCP ne peut pas choisir le dossier.

Le SQL sans @alias reste dans une session à part et ne change pas l’onglet. Le SQL avec @alias, par exemple @billing.orders, utilise l’onglet SQL actif.

Pendant que l’assistant pilote le diagramme, l’onglet affiche la marque MCP. Le pied du workspace affiche contrôle l’interface.

Exemples :

  • « Ouvrez le diagramme ER du projet billing dans l’environnement Développement. »
  • « Dans le diagramme, montrez seulement les tables qui sont en relation avec public.orders. »
  • « Recadrez le diagramme et exportez-le en PNG. »

Comment demander dans le chat

Nommez le projet et l’environnement, pas seulement le libellé technique de la connexion (par exemple postgres).

Exemples :

  • « dans le projet billing, environnement Développement, liste les tables »
  • « dans Billing / Développement, quelles colonnes a public.products ? »

L’assistant utilise les connexions enregistrées dans Kerry. Le SQL sans @alias s’exécute dans une session séparée : il ne change ni l’onglet ni la barre latérale Entités. Le SQL avec @alias, par exemple @billing.orders, utilise l’onglet SQL actif, comme Exécuter la requête : @projet.table suit l’environnement de l’onglet. L’onglet actif doit être SQL et lié à ce projet et cet environnement. Seuls les projets enregistrés apparaissent dans Entités.

Ce que l’assistant peut faire

ModeL’assistant peut
Lecture seuleLister les connexions, trouver un projet et un environnement, inspecter tables et colonnes, chercher dans le schéma, exécuter du SQL de lecture, ouvrir et contrôler l’onglet de diagramme ER
CompletTout ce qui précède, plus le SQL d’écriture autorisé dans Autorisations (Insérer, Mettre à jour et Supprimer)

Voir qui est connecté

La section Observabilité du panneau liste les applications qui parlent à Kerry.

  • Le nombre en bas est le nombre d’applications connectées.
  • Chaque carte est une application. Le nombre sur la carte est le nombre de sessions de base que cette application a ouvertes.
  • Un avis apparaît quand une application se connecte, se déconnecte, ou commence à interroger une base, même si le panneau est fermé.

Pour retirer une application : cliquez sur l’icône corbeille de la carte (Couper la connexion) et confirmez. Cela termine la connexion de cette application. Si une autre application utilise encore la même base, elle reste. Si c’était la dernière, Kerry ferme les connexions MCP de cette base.

Auditer le serveur

Dans Kerry Studio, le fichier mcp.log enregistre chaque échange avec l’assistant, avec l’app et la session. Dans le fichier, REQUEST est la requête que l’assistant a envoyée, y compris le SQL. RESPONSE est ce que Kerry a renvoyé. Ouvrez le fichier dans l’en-tête Observabilité du panneau MCP ou dans Paramètres, MCP. Si les journaux sont désactivés, l’icône est désactivée.

Kerry masque la valeur lorsque le nom du champ est le terme de la liste ou le contient. Il masque aussi la valeur si le SQL donne un autre nom à la colonne, l’utilise dans une expression, ou lit le champ dans un JSON et le renvoie sous un autre nom. Cela vaut sur PostgreSQL, MySQL, Oracle et SQLite.

Par défaut, voici ce qui est masqué :

  • Dans le fichier et dans la réponse à l’assistant : valeurs des mots de passe, jetons, autorisation et clés privées, lorsque le champ correspond à la liste par défaut de cette destination.
  • Uniquement dans le fichier mcp.log : valeurs des champs dont le nom est ou contient email, et e-mails qui apparaissent dans le texte, même s’ils ne viennent pas d’une colonne nommée email.
  • Uniquement dans la réponse à l’assistant : chaînes de connexion, clés et extraits d’erreur qui montreraient un hôte, un utilisateur, un chemin ou un mot de passe. Cela ne dépend pas du nom de la colonne.

Le SQL entre dans mcp.log parce que l’audit conserve la requête telle qu’elle est arrivée. Utilisez le fichier pour vérifier si une colonne de votre base apparaît encore avec la valeur réelle dans le RESPONSE. Cela compte pour les champs que Kerry ne connaît pas, comme un nom complet ou un document. Si elle apparaît, dans Valeurs caviardées du panneau MCP ou dans la palette de commandes (⌘K / CtrlK), ajoutez le champ, choisissez la destination (fichier, assistant ou les deux) et si la correspondance est exacte ou contient.

Si vous désactivez les journaux, ce choix est conservé. Si le fichier existe déjà, Kerry demande confirmation et le supprime.

Dépannage

  • Le client IA n’atteint pas Kerry : vérifiez que l’URL utilise 127.0.0.1, pas localhost, et que le port correspond à Port HTTP. Après un changement de port, utilisez Copier le JSON à nouveau.
  • Le client ne se connecte pas après avoir collé le JSON : éteignez et rallumez le serveur dans le panneau, ou relancez le client IA.
  • OpenCode ne se connecte pas : Kerry n’est pas un MCP binaire. Utilisez opencode mcp add avec --url et l’en-tête Authorization. Si la commande refuse --global, omettez l’option.
  • La requête a été refusée : le serveur est en lecture seule, ou ce type d’opération est désactivé dans Autorisations. Activez le mode complet si l’écriture est volontaire, et activez Insérer, Mettre à jour ou Supprimer selon le SQL. SHOW et EXPLAIN d’un SELECT sont des lectures ; FOR UPDATE et SELECT INTO ne le sont pas.
  • Il n’a pas trouvé la base : demandez par projet et environnement (nom ou @alias), pas par le libellé de connexion.
  • Le SQL avec @alias a échoué : focalisez un onglet SQL lié à ce projet et cet environnement, comme Exécuter la requête.
  • Le diagramme ER ne s’est pas ouvert ou l’environnement a été refusé : vérifiez Autorisations et demandez le projet et l’environnement qui figurent dans cette liste. Le panneau MCP n’existe que lorsqu’un workspace est ouvert.

Si vous régénérez le jeton dans le panneau, collez à nouveau le JSON dans le client.