Voir les catégories

Comment connecter MySQL à Claude / Cursor via MCP (Configuration du serveur MySQL MCP)

28 min de lecture

SERVEUR MCP MySQL

Interroger MySQL avec Claude ou Cursor via MCP.

Connectez MySQL (sur site, AWS RDS, Azure Database pour MySQL ou Google Cloud SQL) à Claude ou Cursor avec une seule clé MCP. L'intelligence du schéma gère les particularités des dialectes (classement insensible à la casse, mots réservés entre guillemets inversés, etc.). MAINTENANT() - INTERVALLE n JOUR, LIMITE n) L'IA écrit donc du code MySQL valide dès sa première tentative.

Pas de trous dans le pare-feu Une seule clé, tous les connecteurs Données en temps réel, sans délai de cache Apportez votre propre outil d'IA

Query Streams est une plateforme d'intégration de données sécurisée et en temps réel qui intègre toutes les bases de données et API SaaS de votre compte dans Claude, Cursor, ChatGPT et Grok, grâce à une seule clé MCP et sans modification du pare-feu. Ce guide explique en détail comment connecter le connecteur MySQL MCP afin que votre outil d'IA puisse répondre à des questions en langage clair sur les commandes, les clients, les catalogues de produits et toutes autres données MySQL (jointures, agrégations, exploration de schémas, rapports ad hoc), sans que vous ayez à copier-coller des exportations CSV depuis MySQL Workbench, phpMyAdmin, DBeaver ou HeidiSQL. Pour en savoir plus, rendez-vous sur QueryStreams.com. et Inscrivez-vous gratuitement pour commencer à poser de vraies questions MySQL à votre outil d'IA.

Que vous offre Query Streams MCP pour MySQL ?

D'autres serveurs « MySQL MCP » disponibles en open source connectent l'outil d'IA directement à une chaîne de connexion MySQL. Bien que fonctionnel, ce système ajoute un mot de passe de base de données à la configuration du client d'IA, limite l'outil d'IA à ce seul point de terminaison MySQL et ne fournit aucun historique des requêtes effectuées par l'IA. Le serveur Query Streams MCP pour MySQL résout un problème plus global : une seule clé pour tous les connecteurs, un historique complet des requêtes et l'outil d'IA ne conserve jamais vos identifiants MySQL.

Aucun trou dans le pare-feu entrant

L'agent réseau établit une unique liaison cloud chiffrée sortante vers Query Streams. Votre client IA se connecte au cloud, jamais à votre serveur MySQL. Aucun port à ouvrir, aucune adresse IP à autoriser, aucun VPN, aucun écouteur MySQL exposé sur Internet.

Une seule clé, tous les connecteurs

La même clé MCP est accessible à toutes les bases de données et API SaaS connectées à votre compte. Ajoutez un connecteur Stripe ou PostgreSQL demain : l’outil d’IA le détectera à côté de vos tables MySQL sans qu’il soit nécessaire de le ressaisir.

L'intelligence schématique intégrée

L'IA prend en compte les descriptions sélectionnées par l'IA, les types sémantiques, les listes de valeurs d'énumération et les clés étrangères découvertes pour chaque colonne MySQL, et pas seulement les données brutes. schéma_information Il génère du code SQL précis dès la première tentative, même sur des schémas MySQL anciens avec des noms de colonnes cryptiques.

Accès en lecture seule appliqué à l'agent

Même un LLM halluciné ne peut pas délivrer SUPPRIMER, MISE À JOUR, ou TRONQUER via Query Streams MCP. L'agent réseau rejette tout ce qui n'est pas SELECTIONNER, AVEC, ou EXPLIQUER avant même que MySQL ne voie la requête SQL.

Limites de débit par clé

Par défaut, 60 requêtes et 10 exécutions par minute sont autorisées, configurables par clé. Une boucle d'appel d'outil d'IA incontrôlée génère un impact sur le nombre de jetons alloués, et non sur votre pool de connexions MySQL ou votre facture d'hébergement.

Comment cela fonctionne sans ouvrir les ports du pare-feu

L'agent réseau Query Streams s'installe une seule fois sur une machine pouvant accéder à votre serveur MySQL et établit une liaison TLS sortante vers le cloud via le protocole réseau standard de MySQL — aucune donnée entrante n'est exposée et l'outil d'IA ne voit jamais votre chaîne de connexion MySQL. Comment fonctionne une connexion sortante uniquement ?

Client IA

Curseur, Claude,
ChatGPT, Grok

Serveur QS MCP

HTTP en continu
Authentification par clé X-MCP

Agent de réseau

Sur votre réseau
Sortie de liaison cloud

Base de données MySQL

chaîne de connexion
détenu par l'agent

Aucun port entrant requis — l'agent compose les numéros sortants, jamais l'inverse.

La touche MCP que vous donnez à Cursor ou Claude est limitée (lire / analyser / exécuter), révocable à tout moment et limitée en nombre d'utilisations par clé. L'outil d'IA fait appel à ces outils MCP pour fonctionner :

querystreams-mcp · catalogue d'outils
qs_list_organisationslire
Renvoie l'organisation liée à la clé appelante.
qs_list_agentslire
Liste les agents du réseau et leur état en ligne.
qs_list_connectorslire
Liste les connecteurs de données (une entrée par serveur de base de données ou API).
qs_get_connector_schemalire
Renvoie les bases de données, tables et colonnes MySQL que l'IA peut interroger, avec enrichissement Schema Intelligence lorsque disponible.
table de profils qsanalyser
Valeurs d'échantillon, distributions, détection d'énumérations, types sémantiques — à la demande.
qs_list_saved_querieslire
Des modèles SQL paramétrés préconfigurés, approuvés par l'équipe. L'IA les exécute sans jamais voir le code SQL.
qs_run_saved_queryexécuter
Exécute une requête enregistrée par clé_de_modèle avec des paramètres optionnels de remplacement.
qs_run_queryexécuter
Exécute une requête SELECT sur un connecteur. Un validateur en lecture seule s'exécute au niveau de l'agent, avant que MySQL ne traite la requête SQL.

Pourquoi Schema Intelligence rend Query Streams MCP différent

La plupart des serveurs « MCP pour MySQL » du paysage open source offrent la même configuration à votre outil d'IA. schéma_information MySQL livre un inconnu. Des noms de colonnes. Des types de données. Peut-être une clé primaire. Le LLM doit deviner la suite. statut_id = 3 signifie, qu'est-ce que usr_eml magasins, ou si articles_commande.id_commande se joint réellement à commandes.id (Aucune clé étrangère n'a jamais été déclarée, ce qui était courant sur les anciens schémas MyISAM antérieurs à l'imposition des clés étrangères par InnoDB, et sur les schémas MySQL 5.6 où les développeurs ont omis les déclarations de clés étrangères pour des raisons de « performance »). C'est pourquoi la première requête SQL que la plupart des LLM écrivent sur un schéma nu est incorrecte : non pas parce que le LLM est mauvais, mais parce qu'il ne dispose pas des données nécessaires pour fonctionner correctement.

Query Streams MCP renvoie ce même schéma enrichi de Intelligence schématique (IS) — Métadonnées sélectionnées par IA et profilées à partir de votre vrai Les données MySQL permettent à chaque outil de schéma de renvoyer le schéma de base plus six couches de connaissances organisées, et le LLM cesse de deviner. Pourquoi Schema Intelligence distingue Query Streams MCP →

Pour concrétiser cela, voici ce que le client IA récupère d'une seule requête. qs_get_table_schema appel contre une base de données de commerce électronique MySQL typique (clients, commandes, articles_commandés, produits, paiements, catégories) — d'abord sans intelligence schématique, puis avec.

Sans intelligence schématique source_de_données : schéma_capturé
// ce que voit le LLM == TABLEAU : clients == – id int(11) [PK, NON NULL] - e-mail varchar(255) NOT NULL - nom varchar(200) – créé_à horodatage NON NULL == TABLEAU : commandes == – id int(11) [PK] – identifiant_client int(11) NON NULL - montant total decimal(10,2) NON NUL - statut varchar(20) NOT NULL – date_de_commande horodatage NON NULL == TABLEAU : articles_commandés == – id int(11) [PK] – id_commande int(11) NON NULL – id_produit int(11) NON NULL - quantité int(11) NON NULL - prix unitaire decimal(10,2) NON NUL == TABLEAU : produits == – id int(11) [PK] - nom varchar(200) - catégorie varchar(80) – sku varchar(64) == TABLEAU : paiements == – id int(11) [PK] – id_commande int(11) NON NULL - méthode varchar(20) NOT NULL - montant decimal(10,2) NON NUL == TABLEAU : catégories == – id int(11) [PK] - nom varchar(80) Clés étrangères : (aucun déclaré) si_recommandation : État: « not_run » Ce qui manque pour cet appel : – Clés étrangères découvertes par l’IA – Valeurs d’exemple par colonne + détection d’énumération – Descriptions des tables et des colonnes – Classifications des types sémantiques – Balisage du domaine métier Remarque : « uniquement des types, sans contexte sémantique »
Avec l'intelligence schématique source de données : intelligence du schéma
// ce que voit le LLM == TABLEAU : clients [DIM, domaine:clients] == « Une ligne par client enregistré. L'adresse e-mail est unique pour chaque client actif. » - identifiant int(11) [PK] identifiant - e-mail varchar(255) courriel Exemple : [email protected], [email protected] - nom varchar(200) nom_personne – créé_à horodatage date_iso Exemple : 2026-04-28 14:02:11 == TABLEAU : commandes [FAIT, domaine : ventes] == « Lignes d'en-tête de commande client ; une par paiement. total_amount correspond au total général en USD. » - identifiant int(11) [PK] identifiant – identifiant_client int(11) identifiant FK -> customers.id (100% de chevauchement, confiance 0,99) - montant total décimal(10,2) devise_USD Plage de valeurs : 0,00 – 4 820,00 ; moyenne : 142,30 - statut varchar(20) code_statut (énumération) payé (54 %) | expédié (24 %) | livré (12 %) | en attente (5 %) annulé (3 %) | remboursé (2 %) – date_de_commande horodatage date_iso == TABLEAU : articles_commandés [FAIT, domaine : ventes] == « Une ligne par produit et par commande. Revenu = SOMME(quantité * prix_unitaire). » – id_commande int(11) identifiant FK -> orders.id (chevauchement de 98 %, confiance de 0,95) – id_produit int(11) identifiant FK -> products.id (100% de chevauchement, confiance 0,99) - quantité int(11) comptoir - prix unitaire décimal(10,2) devise_USD == TABLEAU : produits [DIM, domaine:produits] == – nom varchar(200) contenu_texte - catégorie varchar(80) code_catégorie (énumération) FK -> categories.name (100% de chevauchement, conf 0,99) – sku varchar(64) identifiant Exemple : ['QS-001-MINT','QS-014-DARK','QS-027-AMBER'] == TABLEAU : paiements [FAIT, domaine : finance] == – id_commande int(11) identifiant FK -> orders.id (100% de chevauchement, confiance 0,99) - méthode varchar(20) méthode_de_paiement (énumération) carte (78 %) | PayPal (14 %) | virement bancaire (6 %) | espèces (2 %) - montant décimal(10,2) devise_USD

Les six couches de l'intelligence schématique ajoutent

Chaque couche traite une catégorie de questions auxquelles le LLM devrait normalement répondre par estimation. Le profilage SI optionnel s'effectue sur vos données MySQL sans modifier votre schéma ni écrire dans votre base de données, et se met à jour automatiquement lorsque votre schéma est modifié. Ce que Schema Intelligence apporte et comment elle reste à jour →

Descriptions sélectionnées par l'IA

Description claire et concise de chaque base de données, schéma, table et colonne — générée une seule fois et mise à jour lors de toute modification de votre schéma. Évaluation de la fiabilité : les descriptions rédigées par les utilisateurs sont toujours privilégiées.

commandes : « En-têtes de commandes clients ;
« Une rangée par caisse. »

Classification des tableaux

Chaque table est étiquetée FACT (événements transactionnels), DIM (référence descriptive) ou LOOKUP (petites tables de correspondance), plus un domaine métier — ventes, RH, SEO, finance, support et 14 autres.

commandes [FAIT, domaine:ventes]
clients [DIM, domaine:clients]

Types sémantiques par colonne

Dix-huit types sont pris en charge : currency_usd, email, date_iso, status_code, percentage, ranking_position, identifier, url, person_name, etc. L’IA génère des requêtes SQL MySQL adaptées au dialecte de chaque type.

montant_total : devise_usd
Courriel : courriel · Date de commande : date_iso

Valeurs d'exemple issues de données réelles

Des lignes aléatoires sont apparues au LLM afin qu'il reconnaisse des modèles qu'aucun schéma ne peut montrer : les conventions de formatage, les valeurs encodées, les styles d'abréviation et la forme réelle de vos chaînes de caractères.

sku : ['QS-001-MINT', 'QS-014-DARK',
'QS-027-AMBRE']

Détection d'énumérations avec distributions

Les colonnes à faible cardinalité (50 valeurs distinctes ou moins, soit au maximum 5 % de lignes uniques) sont associées à leur liste complète de valeurs, avec le nombre de lignes correspondantes. L'IA ne tient jamais compte de la casse ni de l'orthographe.

Statut : payé (54 %) | expédié (24 %)
| livré (12 %) | en attente (5 %) …

Découverte implicite de clés étrangères

L'analyse du chevauchement des données entre les tables identifie les jointures qui ne sont pas déclarées comme des contraintes DDL. Ces jointures sont stockées avec les clés étrangères formelles et leurs scores de confiance, et sont renvoyées par qs_get_relationships.

order_items.order_id -> orders.id
(Chevauchement de 98 %, conf 0,95)

Même invite de commande, requête SQL différente

La preuve se trouve dans le code SQL que l'outil d'IA écrit réellement. Même session Cursor, même modèle Claude, même invite. « Quels ont été les 5 produits les plus rentables au cours des 30 derniers jours ? » Sans l'intelligence schématique, le LLM doit deviner. Avec elle, il sait.

Sans intelligence schématique
— Première tentative de LLM contre un schéma nu : SELECTIONNER identifiant_produit, SOMME(prix unitaire) AS recettes DE articles_commandés date_de_commande >= '2024-01-01' ET statut = 'Payé' ORDER BY recettes DESC LIMITE 5 ERREUR : la date et le statut de la commande ne figurent pas dans les articles de la commande La date et le statut de la commande sont associés aux commandes, et non aux articles. pas de jointure — order_items n'est pas horodaté La fonction SUM(prix_unitaire) ignore la quantité et donne un revenu erroné. date codée en dur — « 30 derniers jours » est dynamique « Payé » est incorrect (les valeurs réelles sont en minuscules). Renvoie l'identifiant du produit, et non le nom du produit.
Avec l'intelligence schématique
— Première tentative de LLM avec SI activé : SELECTIONNER p.id, p.name, SOMME(oi.quantité * oi.prix_unitaire) AS recettes DE commandes o JOINDRE articles_commandés ON oi.order_id = o.id JOINDRE produits p ON p.id = oi.product_id o.date_commande >= MAINTENANT() – INTERVALLE 30 JOUR ET o.status = 'payé' GROUPE PAR p.id, p.name ORDER BY recettes DESC LIMITE 5 5 lignes. Réussi du premier coup. Les étiquettes FACT/DIM ont guidé la structure de jointure La découverte de la clé étrangère a révélé order_id -> orders.id order_date a vu le type sémantique = date_iso La recherche d'énumération a sélectionné la lettre minuscule correcte 'paid' Fonction NOW() idiomatique MySQL – INTERVALLE 30 JOURS
Vous ne souhaitez pas exécuter Schema Intelligence ? MCP fonctionne toujours — les outils de schéma renvoient des métadonnées brutes (types, clés primaires, clés étrangères formelles, index) et chaque réponse dégradée contient un si_recommandation bloquer l'information à l'IA sur ce qui lui manque, y compris une option d'appel unique pour activer l'intégration de systèmes en cours de conversation via qs_request_si_analyse. Comment fonctionne Schema Intelligence et combien de temps cela prend-il ?

Connectez AWS RDS, Azure Database ou Google Cloud SQL MySQL à Claude

La plupart des serveurs MySQL en production fonctionnent aujourd'hui sur un service cloud géré plutôt que sur un serveur dédié. Query Streams MCP fonctionne de la même manière avec MySQL géré sur tous les principaux clouds ; seule la configuration de l'agent réseau et la méthode d'authentification diffèrent. Vous trouverez ci-dessous les trois scénarios de déploiement les plus courants, ainsi que la configuration recommandée pour chacun.

AWS RDS pour MySQL / Aurora MySQL

Pair EC2 / VPC

Installez l'agent réseau sur une petite instance EC2 dans le même VPC et groupe de sous-réseaux comme instance RDS pour une latence réseau inférieure à la milliseconde. db.t4g.micro est largement suffisant pour l'empreinte du pool de connexions du trafic MCP typique ; augmentez la capacité uniquement si vous avez de nombreux utilisateurs de requêtes enregistrées simultanées.

  • Auth. Authentification de la base de données IAM recommandé ; l’authentification par mot de passe est prise en charge en cas de repli.
  • Aurora MySQL : orienter l'agent vers le groupe lecteur point de terminaison — MCP est en lecture seule au niveau de l'agent, le point de terminaison d'écriture n'est donc jamais nécessaire.
  • Basculement multi-AZ : RDS gère cela de manière transparente ; l'agent se reconnecte automatiquement.
  • Sortie : la sortie HTTPS de l'agent vers agent.querystreams.com Fonctionne via n'importe quelle passerelle NAT standard ou route de sortie VPC — aucune règle de pare-feu personnalisée.

Base de données Azure pour MySQL (serveur flexible)

Réseau virtuel / lien privé

Installez l'agent réseau sur une machine virtuelle Azure dans le même réseau virtuel comme serveur flexible (ou utilisez un point de terminaison privé / une liaison privée). Les noms de domaine pleinement qualifiés (FQDN) se terminent par *.mysql.database.azure.com; B1ms éclatable est un bon niveau de départ pour l'hôte de l'agent.

  • Auth. Azure AD / Microsoft Entra ID Authentification recommandée pour la production ; authentification SQL (nom d’utilisateur/mot de passe) prise en charge.
  • SSL : Azure requiert TLS par défaut ; l’agent l’applique automatiquement et fixe le bundle Microsoft RootCA.
  • Serveur unique (ancien modèle) : Toujours pris en charge pour le moment ; le calendrier de retrait de Microsoft s'applique. Migrez vers Flexible Server lorsque cela vous conviendra : la chaîne de connexion de l'agent change, mais tout ce qui se trouve au-dessus de l'agent reste identique.
  • Sortie : Le flux de sortie standard des réseaux virtuels Azure fonctionne sans modification ; aucune règle supplémentaire n'est nécessaire pour le pare-feu Azure.

Google Cloud SQL pour MySQL

GCE / Cloud Run

Installez l'agent réseau sur une machine virtuelle GCE dans le même projet et région Utilisez votre instance Cloud SQL ou exécutez-la sur Cloud Run avec une sortie VPC directe. Une adresse IP publique est autorisée, mais l'utilisation d'une adresse IP privée via la connexion aux services privés Cloud SQL est recommandée.

  • Auth. Authentification de la base de données IAM Recommandé ; authentification par mot de passe prise en charge.
  • Proxy d'authentification Cloud SQL : Compatible — l’agent se connecte via le proxy lorsqu’il est configuré. La plupart des installations ignorent le proxy car l’agent se trouve déjà dans le VPC.
  • Génération: Toutes les générations de Cloud SQL pour MySQL sont prises en charge (le protocole de communication est le protocole MySQL standard).
  • Sortie : Cloud Run + sortie VPC directe, ou une instance GCE avec sortie par défaut, atteignent tous deux agent.querystreams.com sans modifier le pare-feu.
L'agent qui compose le numéro sortant est identique sur les trois clouds. Que votre instance MySQL soit hébergée sur AWS RDS, Azure Database for MySQL ou Google Cloud SQL, la connexion cloud entre l'agent réseau et Query Streams utilise le même protocole HTTPS sortant. agent.querystreams.com Sur le port 443. Aucune modification du pare-feu entrant n'est requise sur aucun cloud : pas de liste blanche d'adresses IP, pas de VPN, pas de NAT punchthrough. Conformément aux recommandations de sécurité de Microsoft, AWS et Google, privilégiez l'authentification par base de données IAM/Azure AD aux mots de passe à longue durée de vie lorsque le moteur le prend en charge ; le gestionnaire d'informations d'identification de l'agent gère les trois méthodes.
Nova AI

MCP ne vous convient pas ? Essayez plutôt Nova AI.

Ignorez complètement la configuration JSON : Nova AI est intégré au portail web Query Streams et pose les mêmes questions en langage clair à votre connecteur MySQL — même agent, même application de la règle de lecture seule, même intelligence de schéma, aucune tuyauterie MCP.

Découvrez Nova AI

Conditions préalables

Avant de commencer, assurez-vous d'avoir :

  1. Un compte Query Streams gratuit sur mon.querystreams.com.
  2. L'agent réseau Query Streams installé sur une machine pouvant accéder à votre serveur MySQL — voir Téléchargez l'agent Query Streams.
  3. Un connecteur MySQL configuré avec l'agent — voir la configuration existante configuration du connecteur Les instructions relatives à la chaîne de connexion sont conservées par l'agent, qui détient le mot de passe de l'utilisateur MySQL (ou les identifiants IAM/Azure AD pour MySQL cloud géré) ; l'outil d'IA n'y a jamais accès.
  4. Tout client d'IA compatible MCP. Ce guide présente Cursor, Claude Desktop, ChatGPT et Grok ; si vous utilisez Windsurf, Zed, Continue, Cline, VS Code Copilot, Codex ou Goose, la configuration reste globalement la même.
  5. Cinq minutes.
Vous ne configurez l'agent qu'une seule fois. Le même agent qui alimente les modules complémentaires Excel et Google Sheets de Query Streams, le générateur de requêtes Web et Nova AI est également utilisé par MCP. L'ajout de MCP à un compte Query Streams existant se résume à la génération d'une clé ; l'agent et le connecteur MySQL sont déjà opérationnels.
1

Générer une clé MCP

De la part de /mcp Dans la page Flux de requêtes, créez une clé avec les étendues souhaitées.

2

Déposez-le dans votre client IA

Un seul extrait JSON pour Cursor, Claude, ChatGPT ou Grok. La même clé partout.

3

Poser une question

« Quels étaient nos 10 meilleurs clients en termes de valeur à vie ? » — l’IA utilise les outils appropriés, et vous obtenez la réponse.

Étape 1 : Générer une clé MCP dans les flux de requêtes

Connectez-vous à Query Streams et ouvrez le page MCP (ou connectez-vous d'abord à mon.querystreams.com et cliquez MCP (dans le menu de navigation de gauche). Cliquez Générer une clé, donnez à la clé un nom reconnaissable (quelque chose comme curseur-ordinateur portable ou bureau de Claude), et choisissez les portées que vous souhaitez associer à cette clé :

  • lire — L'IA peut parcourir les connecteurs et lire les schémas. Indispensable pour tout le reste.
  • analyser L'IA peut profiler les tables et découvrir les relations (valeurs d'exemple, distributions, types sémantiques). Cette fonctionnalité est optionnelle, mais fortement recommandée pour MySQL, car la compréhension de la structure des données est cruciale lorsque le modèle LLM génère des jointures entre des schémas existants.
  • exécuter — L'IA peut effectivement exécuter des requêtes SQL. Sans cela, elle ne peut lire que les métadonnées du schéma.

Pour un flux de travail classique du type « laisser Claude analyser mes données MySQL », les trois étendues sont appropriées. Pour une clé que vous transmettez à un collègue ou à un client moins digne de confiance, supprimez-la. exécuter et autorisez-les uniquement à consulter. Vous pouvez révoquer n'importe quelle clé à tout moment depuis cette même page ; le client IA le verra. CLÉ_MCP_RÉVOQUÉE Lors de son prochain appel, le fonctionnement s'arrête immédiatement. Il n'y a pas de délai de propagation.

Copiez la clé maintenant : Query Streams l’affiche une seule fois, puis ne conserve qu’un hachage. Si vous la perdez, générez-en une nouvelle. La clé ressemble à ceci : qsmcp_ suivi de 48 caractères aléatoires, ce que votre client IA envoie dans le Clé X-MCP En-tête de requête.

Étape 2 : Ajoutez Query Streams MCP à votre client d’IA

La configuration est identique pour tous les clients compatibles MCP : une entrée de serveur MCP pointant vers https://mcp.querystreams.com avec votre clé dans le Clé X-MCP En-tête. Choisissez votre client ci-dessous.

Curseur
Curseur ~/.cursor/mcp.json
// Modifier ~/.cursor/mcp.json
{
  "mcpServers": {
    "flux de requêtes": {
      "url": "https://mcp.querystreams.com",
      "en-têtes": {
        "Clé X-MCP": "qsmcp_CLÉ_PASSER_ICI"
      }
    }
  }
}
Claude Desktop
Claude Desktop claude_desktop_config.json
// Paramètres → Développeur → Modifier la configuration
{
  "mcpServers": {
    "flux de requêtes": {
      "url": "https://mcp.querystreams.com",
      "en-têtes": {
        "Clé X-MCP": "qsmcp_CLÉ_PASSER_ICI"
      }
    }
  }
}
ChatGPT
ChatGPT Applications et connecteurs
// Paramètres → Applications et connecteurs → Ajouter un MCP
URL du serveur  https://mcp.querystreams.com
En-tête d'authentification Clé X-MCP
Valeur d'en-tête qsmcp_COLLER_LA_CLÉ_ICI

Nécessite un abonnement ChatGPT payant
// (Plus / Pro / Team / Enterprise).
Grok
Grok Outils MCP distants
// Grok → Paramètres → Outils
{
  "mcp_servers": [{
    "nom": "flux de requêtes",
    "url": "https://mcp.querystreams.com",
    "auth_header": "Clé X-MCP",
    "auth_value": "qsmcp_..."
  }]
}

Redémarrez votre client IA. Au prochain démarrage, il détectera les huit outils Query Streams MCP mentionnés ci-dessus et les affichera dans sa palette d'outils. Dans Cursor et Claude Desktop, vous pouvez le vérifier en saisissant : « liste des connecteurs » — l'IA devrait appeler qs_list_connectors et renvoyez votre connecteur MySQL ainsi que tout autre élément que vous avez configuré.

Étape 3 : Poser une question MySQL à l’IA

Vous n'écrivez pas de SQL : c'est l'IA qui s'en charge. Vous posez une question, l'IA choisit l'outil MCP approprié, l'agent exécute la requête sur votre base de données MySQL et la réponse vous est renvoyée sous forme de texte et de tableaux. Voici trois exemples de requêtes à tester :

« Quelle est l’évolution de notre chiffre d’affaires quotidien au cours des 30 derniers jours ? »
Revenu
L'IA appelle qs_get_connector_schema découvrir le commandes, articles_commandés, clients, et produits tables, puis qs_run_query avec une requête SELECT qui regroupe par DATE(o.order_date), rejoint commandes à articles_commandéset les agrégats SOMME(oi.quantité * oi.prix_unitaire)Il utilise les conventions MySQL. WHERE o.order_date >= NOW() - INTERVAL 30 DAY pour la limite de temps et la valeur d'énumération découverte par SI « payé » Pour exclure les commandes en attente et annulées, vous obtenez un résultat de 30 lignes indiquant le jour, le chiffre d'affaires brut, le nombre de commandes et le panier moyen. L'IA signale généralement les baisses du week-end, la croissance hebdomadaire et toute anomalie détectée, sans que vous ayez à le demander.
« Quels produits sont en rupture de stock ? »
Inventaire
L'IA inspecte produits pour une colonne d'inventaire ou de stock (Schema Intelligence la présente comme une comptoir type sémantique), est corrélé aux 30 derniers jours de quantité_articles_commandés La demande et les prévisions de stock sont analysées. Le résultat est un tableau classé indiquant le nom du produit, le stock actuel, la demande quotidienne moyenne et le nombre de jours avant rupture de stock prévus. L'IA met généralement en évidence les produits dont le stock est inférieur à 14 jours. réorganiser les candidats et les regroupe par catégorie afin que l'équipe des achats puisse regrouper ses bons de commande.
« Montrez-moi les meilleurs clients qui n'ont pas passé de commande depuis plus de 60 jours. »
Rétention
L'IA utilise clients joint à commandes avec un MAX(o.order_date) agrégé par client, filtré à HAVING MAX(o.order_date) < NOW() - INTERVAL 60 DAY, et classés selon leur valeur historique sur toute leur durée de vie (SOMME(o.montant_total) (sur l'historique complet du client). Le résultat est une liste ciblée de clients inactifs à forte valeur ajoutée, avec leur adresse e-mail, la date de leur dernière commande, le nombre de jours écoulés depuis cette dernière commande et leurs dépenses totales. L'IA suggère généralement une campagne de reconquête et signale les clients dont l'inactivité coïncide avec un remboursement ou une demande d'assistance. Vous pouvez explorer ces informations plus en détail. « Pourquoi Acme-corp a-t-elle cessé de passer commande ? » et l'IA tirera paiements et l'historique des commandes.

Lors du premier appel à un outil par l'IA, votre client peut afficher une fenêtre de confirmation vous demandant d'approuver cet appel. Il s'agit du flux de consentement standard de MCP, et non d'une fonctionnalité ajoutée par Query Streams. Une fois l'approbation donnée, l'IA poursuivra la conversation sans problème. Vous pouvez modifier ce consentement à tout moment dans les paramètres de votre client.

Avis de facturation transparent : l’utilisation de MCP est facturée en octets non compressés.

Le transport HTTP Streamable de MCP ne peut pas compresser de manière fiable de bout en bout, il est donc facturé octets non compressés où les clients d'Excel, Sheets, Query Builder et Nova sont facturés octets compressésUne requête d'agrégation MySQL de 3 Mo coûte environ 3 Mo via MCP contre environ 400 à 600 Ko sur ces transports, car les données MySQL avec des valeurs d'énumération VARCHAR répétées (statuts, catégories, méthodes de paiement) sont compressées environ 5 à 7 fois via LZ4. Mêmes données, transport différent, taille facturable différente. Comment fonctionne la facturation par domaine de données selon les différents modes de transport →

Foire aux questions

Dois-je ouvrir des ports ou utiliser un VPN pour cela ? +
Aucune règle de trafic entrant, redirection de ports, NAT punchthrough ni VPN. L'agent réseau établit une connexion TLS sortante (port 443) et votre client IA atteint https://mcp.querystreams.com depuis l'internet public — si le protocole HTTPS sortant fonctionne sur l'hôte de l'agent, MCP fonctionne. Découvrez comment fonctionne une connexion sortante uniquement →
Quels outils d'IA puis-je utiliser avec Query Streams MCP ? +
Tout client compatible avec le protocole MCP (Model Context Protocol) ouvert — Claude Desktop, Claude Code, Cursor, ChatGPT (payant), Grok, Gemini CLI, Windsurf, Zed et plus de 500 autres. Utilisez votre outil d'IA habituel ; vous n'avez pas besoin d'en changer. Liste complète des clients d'IA pris en charge →
Puis-je révoquer une clé MCP ? +
Oui — trois interrupteurs d'arrêt d'urgence indépendants (un par touche à partir du /mcp page, par organisation via les paramètres du plan et au niveau de la plateforme), aucune de ces opérations ne nécessitant une rotation du mot de passe de la base de données ou un redémarrage de l'agent. Plus d'informations sur la sécurité des clés MCP →
Comment l'utilisation de MCP est-elle facturée en fonction de mon espace de données ? +
Les appels d'exécution MCP déduisent du même budget de domaine de données que celui utilisé par Excel, Google Sheets, Web Query Builder et Nova AI — un seul budget de consommation pour chaque méthode d'accès. La taille mesurée pour MCP diffère. Les autres clients utilisent notre connexion cloud compressée (nous facturons). octets compressésMCP fonctionne via Streamable HTTP, qui ne prend pas en charge de manière fiable la compression de bout en bout pour tous les clients et proxys. Par conséquent, nous facturons octets non compressésUn résultat agrégé MySQL de 3 Mo renvoyé à Excel occupe généralement entre 400 et 600 Ko de votre espace de données (LZ4 compresse les valeurs d'énumération VARCHAR répétées par un facteur 5 à 7) ; le même résultat de 3 Mo renvoyé à Cursor via MCP occupe environ 3 Mo. Nous préférons être transparents à ce sujet afin que vous en soyez informés dès le départ plutôt que d'avoir une mauvaise surprise à la fin de votre cycle de facturation.
Est-ce que Query Streams MCP fonctionne avec MySQL 5.7 / 8.0 / 8.1, Percona Server ou Aurora MySQL ? +
Oui, l'agent réseau utilise le pilote standard MySQL Connector/NET. MySQL 5.7+ (Édition communautaire + Édition entreprise), MySQL 8.0 et 8.1, Percona Server pour MySQL (un remplacement direct du moteur XtraDB), Module complémentaire MariaDB-as-MySQL (compatible avec le protocole de câblage au niveau de la couche de connexion), et AWS Aurora MySQL sont tous pris en charge. Pour les clusters Aurora MySQL, configurez l'agent pour qu'il pointe vers le point de terminaison du lecteur de cluster ; l'agent s'exécute uniquement sur ce point. SELECTIONNER Les requêtes sont effectuées via l'application du mode lecture seule MCP, de sorte que le point de terminaison d'écriture n'est jamais nécessaire. Les options d'authentification incluent mot de passe natif MySQL, cache_sha2_password (la valeur par défaut de MySQL 8), Authentification de base de données AWS IAM, Azure AD / Microsoft Entra ID sur Azure Database pour MySQL, et Authentification de la base de données Google IAM Sur Cloud SQL pour MySQL, le protocole SSL/TLS avec certificats d'autorité de certification personnalisés est entièrement pris en charge. Pour les instances MySQL 5.6 plus anciennes, veuillez contacter le support ; une solution de repli est disponible. Conseil : Enregistrez chaque instance MySQL que vous exploitez comme un connecteur distinct. Vos instances « production-oltp-mysql » et « warehouse-replica-mysql » peuvent être deux connecteurs séparés utilisant la même clé. Le LLM sélectionne le connecteur approprié en fonction de la requête (les recherches ponctuelles sont traitées par OLTP, les agrégations volumineuses par le réplica de lecture ou l'entrepôt de données). Le serveur MCP n'a pas accès aux informations d'identification ; seul l'agent y a accès.
En quoi cela diffère-t-il du fait d'exécuter moi-même un serveur MySQL MCP open-source ? +
Un serveur MySQL MCP dédié (des projets communautaires existent sur GitHub) nécessite un serveur MCP par source de données. Pour que Claude puisse accéder à vos données MySQL, Google Search Console, Stripe et Snowflake, il vous faudrait quatre serveurs MCP configurés séparément dans chaque client AI, chacun avec ses propres identifiants, son propre modèle de portée et son propre historique d'audit. Query Streams MCP est une solution unique qui permet d'accéder à tous les connecteurs associés à votre compte. Vous bénéficiez également de Schema Intelligence, de l'application du mode lecture seule au niveau de l'agent, des limites de débit par clé et d'un journal d'audit. journaux d'événements, et le même pipeline de facturation de domaine de données que vous utilisez déjà — autant d'éléments qu'un MCP MySQL direct ne vous offre pas.
Que se passe-t-il si l'IA tente d'écrire ou de supprimer des données ? +
Elle est rejetée par l'agent avant même que la source de données ne voie la requête SQL. qs_run_query L'appel est analysé par un validateur en lecture seule codé en dur qui n'autorise que SELECTIONNER, AVEC, et EXPLIQUER instructions ; tout autre retour VIOLATION EN LECTURE SEULE et n'atteint jamais MySQL. Le validateur s'exécute dans le processus agent sur votre réseau, et non dans le cloud ; une surface d'attaque cloud compromise ne pourrait donc pas le contourner. (Vous pouvez ajouter un utilisateur en lecture seule côté MySQL, par exemple : GRANT SELECT ON db.* à un dédié qs_lecture seule (utilisateur) en plus si vous voulez une double sécurité — le validateur de l'agent est indépendant des autorisations MySQL que vous avez configurées.)
Puis-je voir la question exacte posée par l'IA ? +
Oui. Chaque appel d'outil MCP écrit une ligne dans journaux d'événements avec l'organisation, l'utilisateur, la clé, la portée, la latence et le code de résultat. L'administrateur de l'organisation peut répondre à la question « Qui a utilisé MCP la semaine dernière, quel connecteur et quelle question a-t-il posée ? » en une seule requête. Notez que nous enregistrons les informations suivantes : nom et métadonnées de l'outilIl ne s'agit pas du texte SQL ni des lignes renvoyées ; ces éléments transitent par la connexion cloud et ne sont jamais enregistrés dans les journaux cloud. Pour un audit SQL complet, activez l'audit côté base de données sur le moteur sous-jacent ; pour MySQL en particulier, il s'agit de… journal d'audit plugin (MySQL Enterprise Audit), le Module de journalisation d'audit Percona pour les installations communautaires / Percona, ou votre pipeline de journalisation général / de requêtes lentes existant.
Dois-je exécuter Schema Intelligence pour utiliser Query Streams MCP ? +
Non - Schema Intelligence est optionnel par (connecteur, base de données) paireet MCP fonctionne parfaitement sans cela. L'IA reçoit un schéma minimal (types, clés primaires, clés étrangères formelles, index) et écrit des requêtes basiques. Avec l'intégration système activée, l'IA reçoit six couches supplémentaires de métadonnées organisées : (1) Des descriptions générées par l'IA pour chaque base de données, table et colonne ; (2) classifications de tables (FACT pour les événements transactionnels, DIM pour les références descriptives, LOOKUP pour les petits mappages de codes) plus une balise de domaine métier (ventes, RH, SEO, finance, support et 14 autres) ; (3) un type sémantique sur chaque colonne (currency_usd, email, date_iso, status_code, percentage, ranking_position, identifier, url, person_name, et 9 autres) qui permet une génération SQL MySQL correcte pour le dialecte ; (4) des valeurs d'exemple issues de vos données réelles afin que le LLM reconnaisse des modèles qu'aucun schéma ne peut montrer ; (5) Détection d'énumérations avec distribution complète des valeurs pour les colonnes à faible cardinalité ; et (6) Les clés étrangères découvertes par l'IA à partir du chevauchement des données entre les tables ont été mises en évidence par qs_get_relationshipsSans SI, chaque réponse d'outil de schéma contient également un si_recommandation En listant précisément ce qui manque à l'appel, l'IA peut lire cela et proposer de déclencher l'intégration de l'IA en cours de conversation via qs_request_si_analyseLe temps d'exécution est proportionnel au nombre de tables : une petite base de données de moins de 100 tables est analysée en une dizaine de minutes ; une base de données de taille moyenne (quelques centaines de tables) en 15 à 25 minutes ; une grande base de données d'entreprise avec plus de 1 500 tables peut nécessiter entre 45 et 60 minutes pour une analyse complète. L'intégration logicielle (SI) s'exécute via votre agent réseau sur vos données (jamais dans le cloud), n'écrit jamais dans votre base de données, ne modifie jamais votre schéma et s'actualise de manière incrémentielle lorsque votre schéma change. Ainsi, les exécutions suivantes, après l'ajout ou la modification de tables, sont beaucoup plus rapides que la première. Résultat : avec l'intégration logicielle activée, votre client d'IA écrit du SQL correct du premier coup beaucoup plus souvent qu'avec n'importe quel serveur « MCP pour X » qui se contente de fournir le LLM. schéma_information.
Et si j'ajoute un autre connecteur plus tard, comme Stripe ou PostgreSQL ? +
Rien ne change côté client — la même clé atteint le nouveau connecteur dès que l'agent l'appaire (qs_list_connectors (Il le récupère automatiquement). Un seul bloc de configuration couvre l'intégralité de votre compte, actuel et futur. Pourquoi une seule touche couvre tous les connecteurs →
Dois-je configurer MCP juste pour discuter avec mes données ? +
Non - Nova AI est intégré au portail Query Streams et fonctionne avec tous les connecteurs (y compris MySQL) sans installation ni fichier de configuration MCP. Utilisez Nova pour interagir avec vos données dans Query Streams ; utilisez MCP lorsque vous souhaitez que votre propre client d’IA (Claude, Cursor, ChatGPT, etc.) accède aux mêmes données : même agent, mêmes connecteurs, même intelligence schématique sous-jacente. En savoir plus sur Nova AI →
Query Streams MCP est-il compatible avec AWS RDS pour MySQL, Azure Database pour MySQL ou Google Cloud SQL pour MySQL ? +
Oui, les services MySQL gérés sur tous les principaux clouds sont entièrement pris en charge. AWS RDS pour MySQL (déploiements mono-instance et multi-AZ), AWS Aurora MySQL clusters (pointez vers le point de terminaison du lecteur de cluster — l'agent s'exécute uniquement SELECTIONNER), Azure Database pour MySQL (serveur unique et serveur flexible), et Google Cloud SQL pour MySQL (Toutes générations) fonctionnent immédiatement. Installez l'agent réseau dans le même VPC, VNet ou région GCP que votre instance DBaaS pour des requêtes à faible latence. L'agent utilise les identifiants MySQL standard. Authentification de la base de données IAM sur RDS, Azure AD / Microsoft Entra ID sur Azure Database pour MySQL, Authentification de la base de données IAM Sur Cloud SQL, ou via une authentification par mot de passe simple, la connexion cloud entre l'agent et Query Streams reste identique quel que soit le service DBaaS hébergeant votre moteur ; tout ce qui se trouve en aval de l'agent correspond à votre infrastructure existante, et Query Streams n'a jamais accès aux identifiants de la base de données.

Commencer

Connectez votre outil d'IA à vos données MySQL en cinq minutes.

Une seule clé MCP permet d'accéder à MySQL (sur site, AWS RDS, Azure Database pour MySQL ou Google Cloud SQL), à toutes les autres bases de données et à tous les connecteurs API de votre compte Query Streams, avec un journal d'audit complet, des limites de débit par clé et sans aucune modification du pare-feu. Claude, Cursor, ChatGPT et Grok sont immédiatement opérationnels.

Guides associés : Téléchargez l'agent Query Streams | Configuration du connecteur de base de données | Tous les guides du serveur MCP | Nova AI text-to-SQL

Catégorie : Serveur MCP

Mots-clés : mcp, Claude, curseur, MySQL, base de données, base de données open source, AWS RDS, base de données Azure, Cloud SQL, Aurora MySQL

Description : Connectez MySQL à Claude ou Cursor via Query Streams MCP. Compatible RDS, Azure et Cloud SQL. Configuration en 5 minutes, uniquement pour les requêtes sortantes.

Updated on 16 juin 2026

Powered by BetterDocs