Connectez Query Streams à Claude et interrogez vos bases de données en langage naturel. Claude lit en temps réel votre schéma, vos requêtes enregistrées et votre modèle Schema Intelligence, 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. Ce guide couvre claude.ai, Claude Desktop et Claude Code, ainsi que tous les autres clients MCP.
Version courte. Query Streams is in the Anthropic Connectors Directory. In claude.ai open Settings → Connectors → Browse connectors, trouver Flux de requêtes, 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 ? » That’s it.
Avant de commencer
Il vous faut quatre choses. La plupart des comptes possèdent déjà les trois premières.
Un plan qui inclut le MCP
MCP est inclus dans tous les forfaits, même le forfait gratuit. Ce qui varie selon le forfait, c'est le nombre de touches ou d'applications connectées que vous pouvez gérer et le nombre d'appels par minute que Claude peut passer ; le forfait gratuit autorise une touche ou une application connectée et 30 appels par minute.
Un agent réseau en ligne
L'agent est un petit service qui s'exécute à proximité de votre base de données et établit une connexion sortante avec Query Streams. Si votre équipe exécute déjà des requêtes dans le portail, Excel ou Google Sheets, il est déjà installé. Guide d'installation →
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-vous à Claude
Il existe deux méthodes d'authentification. Les applications de messagerie instantanée utilisent OAuth et ne nécessitent aucune clé. Les outils de développement, quant à eux, requièrent une clé MCP. Les deux méthodes accèdent au même serveur et aux mêmes outils.
Option A : claude.ai et Claude Desktop (OAuth, sans clé)
Listed in the Anthropic Connectors Directory. Query Streams is an approved connector: claude.ai/directory/query-streams. On claude.ai and in Claude Desktop you can connect it with one click from Parcourir les connecteurs; no server URL needed. The custom-connector route below still works and is what to use if your Claude organization restricts directory connectors.
- Sur claude.ai ouvrir Settings → Connectors → Browse connectors, Rechercher Flux de requêtes et cliquez Connecter (or open the directory listing directly). In Claude Desktop the same option is under Paramètres → Connecteurs. Can’t see it? Your organization may restrict directory connectors: click Ajouter un connecteur personnalisé instead, name it Flux de requêtes and paste
https://mcp.querystreams.com/mcp. - Ouvrez n'importe quelle conversation, cliquez sur + bouton à côté de la boîte de message, choisissez 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 → Applications connectées languette.
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 Paramètres → Connecteurs → Ajouter.
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 → Mes clés et cliquez Générer une clé. Nommez-le d'après l'outil et la machine, par exemple : ordinateur portable Claude Codeet choisissez ses portées.
- Copiez la clé maintenant. Vous pourrez l'afficher et la copier à nouveau plus tard. Mes clésLes clés ressemblent à
qsmcp_suivis de 43 caractères. - Pour Claude Code, exécutez :
claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp --header "X-MCP-Key: qsmcp_PASTE_KEY_HERE" - Pour Cursor, VS Code, Windsurf, Zed, JetBrains, Gemini CLI, Codex CLI, Continue et Cline, ouvrez le MCP → Connexion Dans l'onglet correspondant du portail, vous trouverez une configuration prête à l'emploi pour chaque client, avec votre clé déjà renseignée.
Pour vérifier, 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 s'affiche dans l'onglet « Mes clés » 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 Schema Intelligence, lister les requêtes enregistrées et les règles d'alerte. | Toujours. Tout le reste s'appuie dessus. |
| analyser | Les tables de profil (valeurs d'exemple, distributions, types sémantiques), la découverte des relations implicites et la mise en file d'attente d'une exécution de Schema Intelligence. | Recommandé. Cela permet à Claude de comprendre la structure de vos données avant d'effectuer des jointures. |
| exécuter | Exécutez des requêtes SQL en lecture seule et des requêtes enregistrées, puis renvoyez les lignes en flux continu. | 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. |
Une application connectée peut être limitée à certains connecteurs lors de son approbation ; une clé générée est distribué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 sur la page MCP.
Ce que Claude peut faire une fois connecté
Claude dispose d'un petit ensemble d'outils. Vous ne les nommez jamais vous-même ; Claude choisit celui qui convient le mieux à votre question. En clair :
Comprenez 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.
Utilisez vos requêtes enregistrées
Répertoriez les requêtes paramétrées enregistrées de votre organisation et exécutez-les avec différents paramètres. Les requêtes fédérées portant sur plusieurs sources s'exécutent côté serveur et renvoient des lignes déjà jointes.
Exécuter des requêtes SQL ad hoc
Rédigez et exécutez des requêtes SQL en lecture seule dans le dialecte approprié au connecteur. Par défaut, les résultats sont limités à 1 000 lignes et le délai d'expiration à 60 secondes ; ces deux paramètres sont configurables.
Consulter les alertes
Consultez la liste des règles d'alerte, leur état actuel et les déclenchements récents. Claude peut proposer une nouvelle règle en mode test ; une personne l'active sur la page Alertes.
Améliorer le modèle
Vérifiez la couverture de Schema Intelligence par base de données et, avec votre accord, planifiez une analyse afin d'obtenir de meilleures réponses à l'avenir.
Pourquoi l'intelligence schématique 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 des schémas | 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, exécutez Schema Intelligence 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 schématique →
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 disposent de la fonctionnalité Schema Intelligence ?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 un suivi sur le même fil de discussion. 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 comptabilisés dans le même budget de données que vos applications Excel, Google Sheets, Portal et Nova. Comme MCP fonctionne via HTTP sans compression de bout en bout, sa taille est mesurée en octets non compressés. Ainsi, un résultat de 1 Mo coûte environ 1 Mo, alors que le même résultat renvoyé à Excel coûte généralement entre 150 et 250 Ko.
limite_aperçuPertinent pour les questions exploratoires. - L'intelligence schématique 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 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. | 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É | Cette clé est réservée à certains connecteurs, et celui-ci n'en fait pas partie. | Modifiez la liste des connecteurs autorisés de la clé dans Mes clés, ou utilisez une autre clé. |
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 de schéma 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 Schema Intelligence. |
MCP_RATE_LIMITED | Trop d'appels par minute pour votre forfait. | Attendez un instant. Les sessions intensives bénéficient de l'intelligence schématique, 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 important pour être communiqué à Claude en une seule réponse. | Demandez moins de colonnes ou de lignes. Claude vous le suggérera généralement lui-même. |
| 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. |
Vous êtes toujours bloqué ? Ouvrez un ticket sur my.querystreams.com/support ou par courriel [email protected].
Sécurité et confidentialité
- Claude reçoit les métadonnées du schéma, les descriptions Schema Intelligence incluant des exemples de valeurs, ainsi que les résultats des requêtes que vous effectuez. Ces résultats sont transmis au fournisseur d'IA que vous avez choisi, conformément aux conditions de ce fournisseur.
- 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 exécution de Schema Intelligence 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, etc. La page MCP du portail propose une configuration prédéfinie pour chacun d’eux.
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 Schema Intelligence. 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 opérations.
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 en une minute environ
Pas de clé, pas de fichier de configuration, pas de VPN. En lecture seule, par conception.
Ouvrir la page MCP Comment fonctionne MCP
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish