Connectez Query Streams à Claude et posez des questions sur vos bases de données en langage naturel. Claude lit votre schéma, vos requêtes enregistrées et vos Intelligence sémantique Le modèle est en direct, exécute des requêtes SQL en lecture seule via votre agent réseau et n'a jamais accès au mot de passe de la base de données. Votre client d'IA pose la question ; l'agent réseau, son partenaire au sein de votre réseau, se charge du traitement des données. Ce guide couvre claude.ai, Claude Desktop, ChatGPT et Claude Code, ainsi que tous les autres clients MCP.
Version courte. Installez le Agent de réseau Ouvrez ensuite le connecteur situé à côté de votre base de données (en quelques minutes) et ajoutez-en un. Ouvrez ensuite le Liste des flux de requêtes dans le répertoire des connecteurs d'Anthropic, cliquez Connecter, approuvez les autorisations sur l'écran de consentement des flux de requêtes, et demandez à Claude « À quelles bases de données ai-je accès ? » Claude ne peut voir que les données servies par un agent : ignorez l’agent et il vous indiquera qu’il n’y a pas de connecteurs.
Avant de commencer
Il vous faut quatre éléments. Si vous avez trouvé Query Streams dans Claude, l'agent et un connecteur sont les deux seuls qu'il vous reste à configurer.
Un plan qui inclut le MCP
MCP est inclus dans tous les forfaits, même le forfait gratuit. Votre forfait détermine le nombre de clés ou d'applications connectées que vous pouvez gérer, le nombre d'appels par minute que votre client IA peut effectuer, le nombre de lignes renvoyées par une requête et si la suite d'outils analytiques est incluse. Ce que chaque forfait comprend.
Un agent réseau en ligne
L'agent est un petit service qui s'installe à côté de votre base de données et établit une connexion sortante avec Query Streams. Nouveau compte ? Installez-le maintenant depuis my.querystreams.com/télécharger, quelques minutes sur Fenêtres, macOS ou LinuxSi votre équipe exécute déjà des requêtes dans le portail, Excel ou Google Sheets, il est installé.
Au moins un connecteur
Un connecteur est une base de données ou une source d'API enregistrée sur le portail. Claude peut voir tous les connecteurs accessibles depuis votre compte, sous réserve des autorisations que vous lui accordez.
Accès MCP sur votre utilisateur
Les créateurs et propriétaires d'organisations ont automatiquement accès au MCP. Les autres utilisateurs doivent cocher la case d'un administrateur. MCP à côté de leur nom dans Compte → Contrôle d'accès.
Comment ça marche
Claude ne se connecte jamais à votre base de données. Il communique avec le serveur Query Streams MCP dans notre cloud, qui relaie chaque requête via l'unique connexion sortante déjà ouverte par votre agent réseau. L'agent exécute la requête localement et renvoie les lignes de la même manière. Les requêtes et les résultats circulent dans les deux sens sur ce canal unique initié par l'agent ; aucune ouverture n'est donc nécessaire au niveau de votre pare-feu.
OAuth, étendues, audit, limites de débit
une connexion TLS sortante
Trois propriétés découlent de cette conception :
- Aucun justificatif d'identité à Claude. Votre chaîne de connexion à la base de données est stockée sur l'agent. Claude ne possède qu'une autorisation OAuth ou une clé MCP, que vous pouvez révoquer en un clic depuis le portail.
- Lecture seule, appliquée au niveau de l'agent. Seulement
SELECTIONNER,AVECetEXPLIQUERLes déclarations sont acceptées. La vérification s'effectue de votre côté de la connexion, et non dans le cloud ni dans Claude. - Tout est enregistré. Chaque appel d'outil apparaît sur la page MCP. Activité L'onglet et chaque requête dans l'historique des requêtes, attribuée à l'utilisateur qui s'est connecté.
Connectez votre client IA
La page MCP dans le portail (Flux → En direct → MCP) comporte quatre onglets : Connexions, Contexte, Outils et, pour les administrateurs, ActivitéSur Connections, le Connectez un client IA Le bouton ouvre un guide en quatre étapes : Comment votre client IA se connectera-t-il ?, Choisissez votre client IA, Configurez-le et Vérifiez la connexionIl existe deux méthodes d'authentification. Les applications de messagerie instantanée s'authentifient directement depuis l'application et ne nécessitent aucune clé. Les outils de développement, quant à eux, utilisent une clé MCP. Les deux méthodes accèdent au même serveur et aux mêmes outils.
Option A : claude.ai, Claude Desktop et ChatGPT (approbation depuis l’application, aucune clé)
Répertorié dans le répertoire des connecteurs anthropiques. Query Streams est un connecteur approuvé : claude.ai/directory/query-streamsOuvrez l'annonce, cliquez Connecter et approuver ; aucune URL de serveur n’est requise. L’ajout par URL est la solution de repli pour les organisations Claude qui restreignent les connecteurs d’annuaire.
- Ouvrez le Liste des flux de requêtes et cliquez ConnecterLe connecteur se synchronise avec votre compte Claude, et Claude Desktop l'affiche donc sous + → Connecteurs. Vous ne voyez pas l'annonce ? Votre organisation peut restreindre les connecteurs d'annuaire : dans Paramètres → Connecteurs cliquez Ajouter un connecteur personnalisé, nommez-le Flux de requêtes, coller
https://mcp.querystreams.com/mcp, puis dans une conversation, cliquez +, choisir Flux de requêtes et cliquez Connecter. - Un nouvel onglet du navigateur ouvre l'écran de consentement de Query Streams. Connectez-vous si nécessaire, sélectionnez l'organisation, vérifiez les autorisations (voir ci-dessous) et cliquez sur Approuver la connexion.
- De retour à Claude, vous verrez Connecté aux flux de requêtesLa première fois que Claude utilise un outil, celui-ci demande l'autorisation. Choisissez Toujours permettre pour qu'il puisse fonctionner sans avoir à le demander à chaque appel.
Le connecteur est lié à votre compte Claude, et non à un appareil en particulier. Il apparaît donc automatiquement dans les applications mobiles Claude et sur Claude Desktop. Vous pouvez le gérer ou le révoquer à tout moment depuis le portail. MCP → Connexions languette.
ChatGPT. Ajouter des flux de requêtes depuis l'application elle-même : pour l'instant, cela signifie activer le mode développeur dans les paramètres de ChatGPT et y créer la connexion, puis cliquer Se connecter avec Query Streams et l'approbation se fait sur le même écran de consentement. Le guide du portail présente les étapes actuelles de ChatGPT ; une inscription officielle sur ChatGPT est en cours.
Ce n'est pas la même chose que « Ajouter une place de marché ». Dans Claude Desktop, le chat intégré + → Parcourir les connecteurs → Ajouter une place de marché Cette option requiert un dépôt Git pour les places de marché de plugins, et non une URL de serveur MCP. Utilisez celle de l'annonce. Connecter bouton, ou Paramètres → Connecteurs → Ajouter pour la route URL.
Option B : Claude Code, Cursor et autres outils de développement (clé MCP)
Les outils de développement s'authentifient avec une clé que vous générez dans le portail et que vous transmettez. Clé X-MCP en-tête.
- Connectez-vous à mon.querystreams.com, ouvrir MCP et cliquez Connectez un client IA. Choisir Utilisez une clé dans un fichier de configuration et choisissez votre outil.
- Cliquez sur Générer une clé pour votre outil. Nommez-le d'après l'outil et la machine, par exemple : ordinateur portable Claude Code, garder Lire et Exécuter des requêteset choisissez une date d'expiration. Vous pourrez afficher et copier à nouveau la clé ultérieurement depuis le Connexions tabulation. Les touches ressemblent à
qsmcp_suivis de 43 caractères. - Configurez-le Affiche la configuration prête à l'emploi pour Cursor, VS Code, Windsurf, Zed, JetBrains, Gemini CLI, Codex CLI, Continue, Cline et bien d'autres, avec votre clé déjà renseignée. Pour Claude Code, une seule commande suffit :
claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp --header "X-MCP-Key: qsmcp_PASTE_KEY_HERE" - Vérifiez la connexion attend le premier appel de cette touche et dit Connecté.
Pour vérifier à tout moment, demandez « De quels connecteurs Query Streams ai-je accès ? » Le client devrait appeler qs_list_connectors, et la clé Dernière utilisation L'heure affichée dans l'onglet Connexions se met à jour en quelques secondes.
Autorisations
Que la connexion se fasse par OAuth ou par clé, l'accès est contrôlé par trois étendues. L'écran de consentement les affiche ; une clé est créée à partir de celles-ci.
| Portée | Ce que Claude peut faire | Quand l'accorder |
|---|---|---|
| lire | Lister les connecteurs et les agents, parcourir le schéma, lire les descriptions de Semantic Intelligence ainsi que les profils de colonnes et les relations enregistrés, et lister les requêtes enregistrées et les règles d’alerte. | Toujours. Tout le reste s'appuie dessus. |
| analyser | Profiler une table ou découvrir en direct des relations implicites sur le Network Agent, et mettre en file d’attente une exécution de Semantic Intelligence. Sans cela, votre client IA ne voit pas les outils qui lancent une exécution de Semantic Intelligence. | Recommandé. Cela permet à Claude de comprendre la structure de vos données avant d'effectuer des jointures. |
| exécuter | Affiché comme Exécuter des requêtes (lecture seule)Exécutez des requêtes SQL en lecture seule et des requêtes enregistrées, puis renvoyez les lignes en flux continu ; conservez les résultats et exécutez les outils de suivi et d’analyse sur ceux-ci. | Pour ceux qui ont besoin de réponses, et pas seulement de parcourir la structure, désactivez cette option et réservez-la à une fonction de simple consultation. |
Lors de son approbation, l'accès à une application connectée peut être limité à certains connecteurs ; une clé générée est ensuite diffusée à tous les connecteurs de l'organisation. La révocation d'une autorisation ou d'une clé prend effet en cinq minutes environ. Les administrateurs peuvent consulter toutes les autorisations et clés actives de l'organisation dans l'onglet Connexions.
Ce que votre client IA peut faire une fois connecté
Votre client IA consulte les outils Query Streams et sélectionne celui qui convient à votre question ; vous n’avez jamais à les appeler vous-même. Le portail Onglet Outils répertorie chaque outil et chaque mode, indique leur fonction et précise lesquels sont inclus dans votre forfait.
Pour répondre à une question sur vos données, Query Streams guide votre client IA en quatre étapes : lister vos connecteurs, lire les tables de la base de données, lire les colonnes de chaque table qu’il va interroger, puis exécuter une requête en lecture seule. Lire d’abord les colonnes l’empêche de deviner les noms. Quel que soit le forfait, y compris Free :
Cartographiez vos données
Répertoriez les connecteurs, les bases de données et les agents. Consultez l'arborescence de schéma de toute base de données, incluant les descriptions des tables et des colonnes, les types sémantiques, des exemples de valeurs, les étiquettes d'énumération, ainsi que les relations déclarées et découvertes.
Profil et exploration
Effectuez un profilage d'une table pour visualiser la distribution réelle des valeurs avant de rédiger un filtre. Identifiez les jointures entre tables ne comportant aucune clé étrangère déclarée.
Exécuter une requête SQL en lecture seule
Rédigez et exécutez des requêtes SQL en lecture seule dans le dialecte approprié au connecteur. Délai d'expiration par défaut de 60 secondes, jusqu'à cinq minutes ; votre plan détermine le nombre de lignes renvoyées par une requête.
Requêtes enregistrées, fédérées et alertes
Exécutez les requêtes paramétrées enregistrées de votre organisation avec de nouvelles valeurs ; les requêtes fédérées portant sur plusieurs sources sont renvoyées déjà jointes. Consultez les règles d’alerte et leurs déclenchements récents, puis proposez une nouvelle règle en mode simulation.
L'ensemble d'outils analytiques
Avec les abonnements payants, l'agent réseau effectue le travail préparatoire là où se trouvent vos données : il mesure, profile, stocke et analyse les résultats, permettant ainsi à votre client IA d'aborder chaque question avec le contexte déjà préparé et de se concentrer sur la réflexion. L'abonnement gratuit fonctionne comme d'habitude, avec des résultats standard. La présentation complète est disponible dans [lien manquant]. Analysez vos données avec votre client IA.
Gestion du contexte
Noyau personnel et plus. Évaluez la taille d'un résultat avant de le lire (forme): colonnes, estimation de ligne et coût du jeton, aucune ligne. Parcourir une grande base de données zone par zone (niveaux de schémaLimitez les réponses à un budget de jetons, en utilisant uniquement les colonnes et la longueur des cellules de texte dont il a besoin.
Analyse des résultats
Noyau personnel et plus. A profil du résultat complet au lieu des lignes. Résultats maintenus, avec des étiquettes, répondre à des questions de suivi telles que « répartir par région » ou « les 50 lignes suivantes » sans deuxième requête de base de données. fraîcheur des données et modifié depuis Ne lisez que les nouveautés.
Vous gardez le contrôle. Le Onglet Contexte Définit les paramètres par défaut : la limite des cellules de texte, l’affichage du schéma pour les bases de données volumineuses, la taille des résultats et les paramètres d’analyse par défaut, et affiche les données reçues par votre client IA. Il liste également les résultats détenus par chaque agent. Chaque touche permet de modifier les paramètres par défaut, chaque appel est visible dans l’onglet Activité, et un administrateur peut activer ou désactiver cette fonctionnalité. Analyse locale parti pour un agent sous Données → Agents de données.
Ce que comprend votre forfait
MCP est inclus dans tous les forfaits, y compris le forfait gratuit, et ce dernier n'expire jamais.
| Plan | Clés par utilisateur | Clés par organisation | Appels par minute | Lignes par requête | Ensemble d'outils analytiques | Résultats maintenus |
|---|---|---|---|---|---|---|
| Gratuit | 1 | 1 | 30 | 1,000 | Résultats standards | Aucun |
| Noyau personnel | 1 | 1 | 60 | 2,500 | Gestion du contexte, analyse des résultats | 15 minutes, 128 Mo |
| Personnel Plus | 1 | 1 | 90 | 5,000 | Gestion du contexte, analyse des résultats | 15 minutes, 128 Mo |
| Cœur de métier | 2 | 3 | 120 | 10,000 | Gestion du contexte, analyse des résultats, analyse approfondie | 60 minutes, 512 Mo |
| Business Plus | 3 | 5 | 150 | 25,000 | Tous les trois | 60 minutes, 512 Mo |
| Business Max | 5 | 10 | 240 | 50,000 | Tous les trois | 60 minutes, 512 Mo |
| Noyau d'entreprise | 5 | 25 | 300 | 100,000 | Tous les trois | 8 heures, 4 096 Mo |
| Entreprise Plus | 8 | 50 | 450 | 100,000 | Tous les trois | 8 heures, 4 096 Mo |
| Enterprise Max | 10 | 100 | 600 | 100,000 | Tous les trois | 8 heures, 4 096 Mo |
Une application connectée compte comme une clé. Chaque clé peut exécuter au maximum 10 requêtes par minute. Le nombre de lignes par requête correspond au nombre maximal de lignes qu'une requête renvoie à votre client IA ; toute demande supplémentaire entraîne le dépassement de la limite de votre forfait et vous en informe, sans générer d'erreur. Un résultat est conservé pour les questions ultérieures, dans la limite de la durée et de la taille du forfait, et en fonction des ressources disponibles sur l'ordinateur de l'agent. Comparaison de tous les forfaits : la tarification.
Pourquoi l'intelligence sémantique est importante ici
Chaque réponse que Claude reçoit est étiquetée avec le niveau (parmi les trois) dont elle provient, et Claude ajuste son degré de confiance en fonction de ce qu'il voit.
| Étage | Ce que voit Claude | Résultat |
|---|---|---|
| Intelligence sémantique | Descriptions pour chaque table et colonne, types sémantiques, étiquettes d'énumération, exemples de valeurs, classification des faits et des dimensions, jointures déclarées et découvertes. | Claude écrit du SQL de qualité professionnelle dès la première tentative et explique les données en termes métier. |
| Schéma capturé | Noms des tables et des colonnes, types, clés primaires, index, clés étrangères déclarées. | Claude travaille, mais il doit déduire le sens des noms et peut avoir besoin d'une question complémentaire. |
| Schéma en direct | La base de données ne figure pas dans la sélection de capture du connecteur, sa structure est donc lue en direct à partir du catalogue à chaque requête. | Les requêtes continuent de s'exécuter. Claude effectue des analyses avec des exemples de sélection lorsque cela s'avère nécessaire. |
Si une base de données est importante pour votre équipe, effectuez une analyse sémantique une seule fois. Pour les bases de données volumineuses, limitez l'analyse aux tables réellement utilisées par vos requêtes. Comment fonctionne l'intelligence sémantique →
Exemples de messages
Commencez par une question dont vous connaissez déjà la réponse. Posez ensuite des questions complémentaires ; Claude conserve le contexte.
À quelles bases de données et tables ai-je accès, et lesquelles d'entre elles possèdent une intelligence sémantique ?Il cartographie vos connexions et vous indique où les réponses seront les plus pertinentes. Montrez-moi comment les clients sont liés aux commandes dans la base de données des ventes et analysez la colonne « statut des commandes ».Utilise les relations et le profilage des colonnes. Claude vous montrera les codes d'état réels et leur signification. Exécutez la requête enregistrée « Revenu mensuel par région » pour le deuxième trimestre de cette année.Exécute une requête enregistrée et fiable avec des paramètres au lieu de créer sa propre requête SQL. Les 10 produits les plus rentables des 90 derniers jours. Puis, une ventilation par canal.Requête SQL ad hoc dans le dialecte du connecteur, puis une requête de suivi sur le même thread. Pour les plans avec analyse des résultats, la requête de suivi peut provenir du résultat mis en attente, sans seconde requête. Quelles règles d'alerte sont configurées, et certaines d'entre elles se sont-elles déclenchées cette semaine ?Consulte les règles d'alerte et leur état récent.Conseils pour de meilleures réponses
- Utilisez un projet Claude. Ajoutez le connecteur Query Streams à un projet et définissez vos règles métier dans les instructions du projet : base de données par défaut, définitions officielles des requêtes enregistrées et conventions d’appellation. Claude analyse toujours le schéma en temps réel ; les instructions restent donc concises.
- Enregistrez les requêtes que vous considérez comme canoniques. Claude consulte d'abord les requêtes enregistrées, donc « clients actifs » signifie ce que votre équipe entend par là.
- Accorder le périmètre d'analyse. Le profilage d'une colonne avant le filtrage fait toute la différence entre deviner un code d'état et utiliser le bon.
- Demandez un graphique. claude.ai génère des graphiques à partir des lignes renvoyées par Claude.
Ce que ça coûte
MCP n'applique aucun frais supplémentaire, quel que soit le forfait. Deux éléments sont facturés à l'usage :
- Volume de données. Les résultats de requête renvoyés à Claude sont imputés au même budget de data realm que celui partagé par vos usages d’Excel, de Google Sheets, du Portal et de Nova. Via MCP, ils sont mesurés en fonction de chaque octet transmis à Claude — résultats, lectures de schéma et pages de résultats conservés — avant toute compression de transport, car un client d’IA les reçoit sans compression. Les résultats des feuilles de calcul, du Portal et de l’API sont comptabilisés selon le résultat compressé transmis par votre Network Agent. Une réponse ayant échoué n’est jamais comptabilisée. Limitez la taille des questions exploratoires ; avec les forfaits qui incluent la gestion du contexte, demander d’abord à Claude d’estimer la taille d’un résultat (mode : shape) évite de récupérer des lignes dont il n’a pas besoin.
- L'intelligence sémantique fonctionne. Lancer une analyse via Claude facture des crédits IA à votre organisation, tout comme le fait l'exécution depuis le portail. Claude vous demandera votre autorisation avant de procéder.
Dépannage
| Ce que vous voyez | Ce que cela signifie | Réparer |
|---|---|---|
| Claude affirme qu'il n'y a pas de connecteurs, ni d'agent réseau. | Votre compte ne possède pas encore d'agent en cours d'exécution, ou aucune source de données n'a été ajoutée à l'agent. | Installez l'agent à partir de my.querystreams.com/télécharger, ajoutez un connecteur sous Données → Agents de données → Ajouter un connecteur, puis demandez à nouveau. |
| Claude n'affiche aucun outil de flux de requêtes | Le connecteur a été ajouté mais n'a pas été connecté à une conversation, ou l'approbation OAuth n'a jamais été effectuée. | Ouvrez une conversation, cliquez +, choisissez Flux de requêtes, Connecter, et terminez l'écran de consentement. |
CLÉ_MCP_REQUISE ou 401 | Aucune clé ni autorisation n'a atteint le serveur. Pour les clients de clés, il s'agit généralement d'une erreur de copier-coller, comme un saut de ligne en fin de ligne ou une clé dans un en-tête incorrect. | Recopiez la clé dans le Clé X-MCP En-tête. Pour claude.ai, reconnectez-vous depuis le menu +. |
MCP_TOKEN_EXPIRÉ | Le jeton OAuth a expiré après une période d'inactivité. | Claude se rafraîchit normalement automatiquement. Si ce n'est pas le cas, débranchez puis rebranchez le connecteur. |
CLÉ_MCP_RÉVOQUÉE ou MCP_UTILISATEUR_DÉSACTIVÉ | La clé a été révoquée ou l'accès MCP a été désactivé pour votre utilisateur. | Générez une nouvelle clé ou demandez à un administrateur de réactiver MCP sur Compte → Contrôle d'accès. |
MCP_SCOPE_REQUIRED | La subvention ou la clé ne permet pas, le plus souvent, de réaliser cette action. exécuter (Exécuter des requêtes). | Reconnectez-vous et approuvez l'étendue manquante, ou générez une clé qui l'inclut. |
PLAN_MCP_EXPIRÉ | L'abonnement de votre organisation a expiré. | La page MCP du portail affiche l'état actuel du plan et les prochaines étapes. |
MCP_AGENT_NOT_CONNECTED | L'agent réseau propriétaire du connecteur n'est pas connecté actuellement. | Vérifier Agents de données Dans le portail, démarrez le service agent sur son hôte. |
CONNECTEUR MCP NON AUTORISÉ | L'application connectée était limitée à des connecteurs spécifiques lors de son approbation, et celui-ci n'en fait pas partie. | Reconnectez l'application et approuvez un accès plus étendu sur l'écran de consentement des flux de requêtes. |
MCP_DATABASE_NOT_CAPTURED | La base de données n'est pas incluse dans la sélection de capture de schéma du connecteur ; par conséquent, aucune information sémantique ni relation stockée n'est disponible. Les requêtes restent fonctionnelles. | Ajoutez la base de données à la sélection de capture sur le connecteur dans le portail, puis exécutez éventuellement l'intelligence sémantique. |
MCP_RATE_LIMITED | Trop d'appels par minute pour votre forfait. | Attendez un instant. Les sessions intensives bénéficient de l'intelligence sémantique, ce qui permet à Claude de répondre en moins d'appels. |
Délai d'attente de requête MCP | La requête a dépassé son délai d'expiration, fixé à 60 secondes par défaut. | Demandez à Claude d'ajouter un filtre ou une limite inférieure de lignes, ou augmentez le montant. délai_secondes jusqu'à 300. |
MCP_OUTPUT_TOO_LARGE | Le résultat était trop volumineux pour être transmis à votre client IA en une seule réponse. | Demandez moins de colonnes ou de lignes. Pour les forfaits avec gestion du contexte, demandez d'abord le dimensionnement du résultat. |
FONCTIONNALITÉ_MCP_NON_INCLUE | « Votre plan n’inclut pas la gestion du contexte », l’analyse des résultats ou l’analyse approfondie ; ou l’outil est désactivé pour cette clé ou cette organisation. | Demandez à votre client IA de continuer sans, passez à un forfait supérieur ou demandez à un administrateur d'activer l'outil. |
RÉSULTAT_MCP_EXPIRÉ | Le résultat mis en attente n'est plus retenu : il a expiré, a été libéré (parfois prématurément, pour faire place à un résultat plus récent) ou l'agent a redémarré. | Demandez à votre client IA d'exécuter à nouveau la requête avec une pause. |
MCP_WINDOW_BUDGET | L'agent ne peut pas conserver un résultat de cette taille pour le moment, ou bien un suivi nécessiterait plus de mémoire que celle disponible pour les résultats mis en attente. | Libérez un résultat mis en attente ou affinez la requête à l'aide d'un filtre ou en réduisant le nombre de colonnes. |
MCP_AGENT_ANALYSIS_DÉSACTIVÉ | Les résultats et analyses en attente sont désactivés sur cet agent ou pour ce connecteur. | Demandez à un administrateur d'activer Analyse locale pour l'agent sur la page Agents de données, ou autoriser l'analyse sur le connecteur. |
MCP_WINDOW_SQL_REJETÉ | Une requête de suivi n'était pas une simple requête SELECT en lecture seule sur les tables du résultat conservé, ou bien elle mentionnait une colonne absente du résultat. | Effectuez une requête SELECT sur ce résultat, en utilisant ses noms de colonnes. |
MCP_AGENT_VERSION_TROP_ANCIENNE | L'agent a besoin d'une mise à jour avant de pouvoir façonner, profiler, conserver ou analyser les résultats. | Mettre à jour l'agent à partir de Données → Agents de donnéesLes requêtes simples continuent de fonctionner entre-temps. |
| Une requête échoue à cause du nom d’une colonne ou d’une table | Votre client IA a deviné un nom au lieu de lire d’abord la table. | En général, rien. L’erreur reçue répertorie les vraies colonnes de la table ou les tables dont le nom est similaire, ce qui lui permet de corriger la requête lors de sa prochaine tentative. S’il continue à deviner, demandez-lui de lire d’abord les colonnes de la table. |
| violation de lecture seule | Le code SQL contenait autre chose que SELECTIONNER, AVEC ou EXPLIQUER. | C'est voulu. Les écritures ne sont jamais acceptées via MCP. |
Toujours bloqué ? Envoyez un e-mail [email protected].
Sécurité et confidentialité
- Claude reçoit les métadonnées du schéma, les descriptions d'intelligence sémantique (incluant des exemples de valeurs) et les résultats des requêtes que vous effectuez. Avec l'ensemble d'outils analytiques, il reçoit souvent une estimation de taille, un profil ou une réponse en attente, tandis que le résultat complet reste sur l'agent. Les données reçues sont transmises au fournisseur d'IA que vous avez choisi, conformément aux conditions de ce dernier.
- Query Streams ne reçoit ni ne stocke votre conversation avec Claude.
- Les autorisations et clés OAuth sont attribuées par utilisateur et par organisation. Un administrateur peut consulter et révoquer chaque autorisation et clé depuis la page MCP.
- Vous trouverez tous les détails dans notre Politique de confidentialité et Conditions d'utilisation.
Foire aux questions
Dois-je ouvrir un port ou utiliser un VPN ?
Non. L'agent établit une connexion TLS sortante sur le port 443. Si le protocole HTTPS sortant fonctionne, MCP fonctionne également.
Claude peut-il modifier mes données ?
Non. L'agent n'accepte que les requêtes de lecture. Claude peut mettre en file d'attente une analyse d'intelligence sémantique et proposer une règle d'alerte en mode test ; les deux opérations écrivent dans les métadonnées de Query Streams, jamais dans votre base de données.
Quels autres outils d'IA fonctionnent ?
Tout outil compatible avec MCP : ChatGPT, Cursor, Claude Code, Windsurf, Zed, VS Code Copilot, JetBrains AI, Gemini CLI, Codex CLI, Continue, Cline et bien d’autres. Le portail Connectez un client IA Le guide propose une configuration prête à l'emploi pour chaque cas.
Qu'est-ce qu'un résultat retenu ?
Avec les forfaits incluant l'analyse des résultats, votre client IA peut demander à l'agent de conserver un résultat complet pendant un certain temps. Les questions complémentaires, comme une ventilation par région ou l'affichage de la page suivante, sont ensuite traitées à partir de cette copie, sans nécessiter de nouvelle requête à la base de données. La durée et la taille du résultat conservé varient selon le forfait choisi.
Quels forfaits incluent la suite d'outils analytiques ?
La gestion du contexte et l'analyse des résultats sont incluses dans la version Personal Core et les versions supérieures ; une analyse plus approfondie est disponible avec la version Business Core et les versions supérieures. La table de planification contient les détails.
Cela change-t-il le forfait gratuit ?
Non. Le forfait gratuit fonctionne comme toujours, avec des résultats standards.
Est-ce compatible avec plusieurs organisations ?
Chaque subvention ou clé est liée à une seule organisation. Connectez-vous une seule fois par organisation.
Quelle est la différence entre celui-ci et Nova ?
Nova est l'assistant intégré au portail Query Streams et utilise le même modèle d'intelligence sémantique. Utilisez Nova pour obtenir des réponses directement dans Query Streams ; utilisez MCP pour intégrer vos données à Claude, en complément de toutes vos autres activités.
Guides spécifiques aux connecteurs
Chaque guide détaille le même lien avec des exemples pour chaque source.
Bases de données : Microsoft SQL Server · PostgreSQL · MySQL · MariaDB · Oracle · Flocon de neige · Google BigQuery · SQLite · Microsoft Access · DuckDB · Supabase
Apis: Rayure · Shopify · HubSpot · Annonces Google · Google Analytics 4 · Google Search Console · ShipStation · iTick
Dossiers de fichiers et de journaux (L'agent analyse un dossier et transforme les fichiers en tableaux) : Système de fichiers · Dossier CSV · Dossier en parquet · Dossier Excel · Dossier SQLite · Dossier JSONL · Fichier CSV multi-enregistrements · Journaux de machines · Journaux du serveur Web · Journaux de conteneurs · Journaux d'application · Journaux système · Journaux personnalisés
Bases de données hébergées (PostgreSQL, MySQL, MariaDB et SQL Server gérés, accessibles par l'agent via TLS) : Néon · Amazon RDS · Base de données Azure pour PostgreSQL · Azure Database pour MySQL · Azure SQL · Google Cloud SQL · Google AlloyDB · Bases de données gérées par DigitalOcean · Aiven · Pont croustillant · Heroku Postgres · Rendre · Chemin de fer · Fly.io Postgres · Bases de données gérées par Vultr · Bases de données gérées par OVHcloud · Bases de données gérées par Scaleway · Base de données OCI avec PostgreSQL · MySQL HeatWave · Bases de données IBM Cloud pour PostgreSQL · MariaDB SkySQL · Xata · Échelle de temps Cloud · PostgreSQL à l'échelle planétaire · Prisma Postgres · Koyeb · Nil
Connectez Claude à vos données
Installez l'agent une seule fois, en quelques minutes. Ensuite, la connexion à Claude se fait en un clic : sans clé, sans fichier de configuration, sans VPN. Conçu pour être en lecture seule.
Installez l'agent Ouvrir la page MCP Comment fonctionne MCP
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish