MCP : utiliser STYD depuis vos apps d'IA

English version

Utiliser STYD depuis Claude (MCP)

Ajoutez Speak To Your Database (STYD) à Claude depuis l’annuaire de Claude ou comme connecteur personnalisé, puis interrogez les données de votre entreprise sans quitter votre conversation Claude.

De quoi s’agit-il ?

STYD répond à vos questions métier à partir de vos données Odoo et de vos bases PostgreSQL ou MySQL. Une fois STYD connecté à Claude, vous posez vos questions en langage courant dans Claude ; STYD calcule la réponse à partir de vos données, avec vos propres accès, et la renvoie à Claude en indiquant comment elle a été obtenue.

Lecture seule. STYD ne fait que lire vos données : il ne peut rien créer, modifier ni supprimer, ni dans Odoo ni dans vos bases.

Ce qu’il vous faut

  • Un espace de travail STYD avec des prompts disponibles (prompts gratuits ou forfait) et au moins une connexion (Odoo, PostgreSQL ou MySQL). Une connexion PostgreSQL ou MySQL peut répondre dès que son Data Guide a été exécuté. Sur Odoo, un propriétaire ou un administrateur de l’espace devra peut-être d’abord associer votre compte STYD à votre utilisateur Odoo.
  • Un rôle qui permet de poser des questions : propriétaire, administrateur ou membre. Les lecteurs peuvent consulter STYD, mais pas poser de questions, ni depuis Claude ni ailleurs.
  • Des applications d’IA autorisées dans l’espace de travail. Elles le sont par défaut ; un propriétaire ou un administrateur peut les désactiver (voir Qui garde la main).
  • Une offre Claude qui permet d’ajouter des connecteurs personnalisés.

Se connecter

Adresse du connecteurhttps://speaktoyourdatabase.com/mcp
  1. Dans Claude, ajoutez STYD. Ouvrez la fiche de STYD dans l’annuaire de Claude et ajoutez-le depuis cette page — ou ouvrez Paramètres → Connecteurs, choisissez Ajouter un connecteur personnalisé, donnez-lui un nom (par exemple « STYD ») et collez l’adresse ci-dessus. Choisissez ensuite Se connecter.
  2. Connectez-vous à STYD. Une page STYD s’ouvre dans votre navigateur. Si vous n’êtes pas connecté, la page « Continuer vers Speak To Your Database » s’affiche : continuez avec Google, ou saisissez votre adresse e-mail et ouvrez le lien de connexion que STYD vous envoie. Si vous êtes déjà connecté, STYD passe directement à l’étape suivante.
  3. Autorisez. STYD vous demande « Autoriser « Claude » à utiliser votre compte STYD ? ». La page indique le nom de l’application (déclaré par l’application elle-même), l’adresse vers laquelle vous serez renvoyé, ce que l’application pourra faire — lire les données auxquelles vous avez déjà accès, en lecture seule, poser des questions qui utilisent les prompts de l’espace de travail concerné, dans tous vos espaces de travail, y compris ceux que vous rejoindrez plus tard — et le compte STYD avec lequel vous êtes connecté. Vérifiez le compte, puis choisissez Autoriser. Refuser annule la demande.
  4. De retour dans Claude. Vous revenez dans Claude, où le connecteur apparaît comme connecté. Posez votre question dans une conversation où le connecteur STYD est activé.

En cas de problème

  • « Cette demande a expiré » ou « Cette demande n’est pas valide » : retournez dans Claude et reconnectez-vous.
  • Connecté avec le mauvais compte : déconnectez-vous de STYD, connectez-vous avec le bon compte, puis relancez la connexion depuis Claude.
  • « Pas encore disponible » : la connexion d’applications d’IA n’est pas encore ouverte pour votre compte. Contactez-nous si vous en avez besoin.

Ce que Claude peut faire

STYD met cinq outils à la disposition de Claude. Tous se contentent de lire.

Lister les espaces de travail list_workspaces
Liste les espaces de travail STYD dont vous faites partie, votre rôle dans chacun et si les applications d’IA y sont autorisées.
Lister les connexions list_connections
Liste les connexions Odoo, PostgreSQL et MySQL que vous pouvez interroger, chacune avec son espace de travail et son état (prête ou non).
Décrire les données disponibles describe_available_data
Montre à quoi une connexion peut répondre : sur Odoo, les domaines métier que vous pouvez lire et des exemples de questions ; sur PostgreSQL ou MySQL, les tables que vous pouvez interroger, leurs descriptions et les termes métier définis par le propriétaire.
Poser une question ask_question
Envoie une question à STYD et renvoie la réponse avec la façon dont elle a été calculée ; une question de suivi dans la même conversation Claude poursuit la même conversation STYD.
Obtenir une réponse get_answer
Récupère une réponse dont le calcul a pris plus de 45 secondes environ.

Exemples de questions

Odoo

  • “Quel a été notre chiffre d’affaires le mois dernier ?”
  • “Quels clients ont des factures en retard, et combien nous doivent-ils ?”

PostgreSQL ou MySQL

  • “Quels ont été nos 5 meilleurs clients par montant total dépensé l’an dernier ?”

L’exemple PostgreSQL ou MySQL correspond à la base de ventes d’un disquaire (clients, factures, morceaux) ; interrogez vos propres tables avec vos propres mots. Précisez dans la question la période, le client, le produit ou le statut. La réponse arrive dans la langue de la question.

Coût

Chaque réponse coûte un prompt à l’espace de travail concerné par la question, quel que soit son contenu — y compris une réponse indiquant que les données ne contiennent pas l’information, une demande de précision ou un refus. Chaque réponse indique à Claude le nombre de prompts utilisés. Ce sont les mêmes prompts que dans le chat de STYD ; vous suivez la consommation dans Paramètres → Utilisation.

Gratuit

  • Lister les espaces de travail et les sources de données, décrire ce que l’on peut demander, récupérer une réponse encore en cours de calcul.
  • Une question que STYD n’exécute pas — par exemple parce que l’espace de travail n’a plus de prompts, que les applications d’IA y sont désactivées, que votre rôle ne permet pas de poser de questions, ou que trop de questions ont été envoyées en même temps.
  • Une question qui échoue sur une erreur.
  • Sur Odoo : une réponse qui signale une erreur ou qu’Odoo est injoignable, que les questions Odoo sont désactivées pour la connexion ou que votre compte n’est pas encore associé à un utilisateur Odoo — ainsi qu’une réponse donnée pendant une indisponibilité temporaire du service de questions Odoo de STYD.

Limites et sécurité

  • Lecture seule. Les questions sur vos bases s’exécutent en mode lecture seule et Odoo est uniquement lu. STYD ne modifie jamais vos données.
  • Les espaces de travail ne se mélangent jamais. Chaque question porte sur une connexion d’un seul espace de travail, chaque résultat nomme son espace de travail, et le prompt est décompté de cet espace. Si vous appartenez à plusieurs espaces de travail, Claude les voit séparément.
  • Vous voyez ce que vous voyez dans STYD. Claude agit en votre nom, avec votre rôle et vos propres accès. Sur Odoo, vous ne voyez que ce que votre utilisateur Odoo associé peut lire (sur une connexion configurée avec une clé API Odoo, ce que peut lire l’utilisateur Odoo de cette clé). Sur PostgreSQL et MySQL, les tables qu’un propriétaire ou un administrateur vous a masquées sont exclues. Claude n’ouvre que vos propres conversations STYD, jamais celles d’un autre membre.
  • Toujours masqués : mots de passe, jetons, clés, numéros de carte ou de compte bancaire. Les longues listes sont limitées à 50 lignes.
  • Limites de débit : jusqu’à 30 questions par minute et par personne dans chaque espace de travail, et au plus 8 questions en attente par personne et 20 par espace de travail. Au-delà, STYD vous demande de patienter un instant avant de réessayer ; rien n’est décompté.
  • Les données restent des données. Les valeurs d’une réponse proviennent de vos enregistrements ; Claude reçoit la consigne de les traiter comme des données, jamais comme des instructions.

Qui garde la main

Propriétaires et administrateurs de l’espace de travail

  • Activer ou désactiver les applications d’IA : Paramètres → Applications IA → Réglage de l’espace de travail → « Autoriser les applications d’IA (MCP) ». Lorsqu’elles sont désactivées, les applications d’IA reçoivent un message l’indiquant et rien n’est exécuté. Le chat de STYD n’est pas concerné.
  • Voir qui s’est connecté : Paramètres → Applications IA → « Applications connectées des membres » liste chaque membre qui a connecté une application d’IA, le nom de l’application, l’adresse vers laquelle elle renvoie, la date de connexion et la dernière utilisation dans cet espace de travail. Cette liste est en lecture seule : chaque membre déconnecte lui-même ses applications. Retirer un membre de l’espace de travail lui en retire aussi l’accès depuis Claude.

Chaque utilisateur

  • Dans Claude : ouvrez Paramètres → Connecteurs, puis déconnectez ou supprimez le connecteur STYD.
  • Dans STYD : Paramètres → Applications IA → « Vos applications connectées » → Déconnecter, puis confirmez. L’application perd l’accès immédiatement. Vous seul voyez cette liste.
  • Faites les deux pour être sûr que la connexion est fermée des deux côtés. Une connexion inutilisée pendant 30 jours prend fin d’elle-même, et toute connexion prend fin au bout de 90 jours ; Claude vous demande alors de vous reconnecter.

Confidentialité et assistance

Les questions posées depuis Claude et les réponses de STYD sont conservées dans l’historique de vos conversations STYD, comme les questions posées dans STYD, avec le nom de l’application (par exemple « via Claude »). Consultez la politique de confidentialité et les conditions d’utilisation.

Besoin d’aide ? Passez par la page d’assistance ou écrivez à contact@speaktoyourdatabase.com.