Dossier Excel → Claude · avec Query Streams
Avec Query Streams, posez des questions en anglais courant à Claude sur votre fichier Excel Folder : l’Agent déjà présent dans votre réseau exécute les requêtes SQL en lecture seule, et aucun mot de passe de base de données ne parvient jamais à l’IA. Comptez environ dix minutes, et l’offre Free suffit.
Commencez gratuitement
Ce que vous obtiendrez
Claude peut répondre à des questions sur un dossier de classeurs Excel grâce à des requêtes en lecture seule sur les tables qu'il construit à partir de vos fichiers. Il vous indique le fichier d'origine de chaque réponse, sans jamais avoir besoin de vous connecter, de saisir un chemin d'accès ou de modifier votre pare-feu : l'agent, déjà présent sur votre réseau, lit le dossier et renvoie uniquement les lignes. Une fois l'agent installé, la connexion à Claude prend environ 90 secondes si vous êtes à l'aise avec l'interface de configuration. Voici un exemple :
Quels classeurs alimentent fileset.data_orders, et combien de lignes proviennent de chacun ?
La feuille de commandes provient de trois classeurs régionaux. Le classeur Ouest contient le plus grand nombre de lignes.
| _fichier_source | nombre_de_lignes | première_ligne_id |
|---|---|---|
| Regions/West-orders-2026.xlsx | 4210 | Regions/West-orders-2026.xlsx:orders:000000 |
| Régions/East-orders-2026.xlsx | 3876 | Regions/East-orders-2026.xlsx:orders:000000 |
| Régions/Commandes-centrales-2026.xlsx | 2954 | Régions/Commandes-Centrales-2026.xlsx:commandes:000000 |
Vous voulez que je compare le total des commandes par région pour ce trimestre ?
Comparez les commandes de septembre des différentes régions. Laquelle est en retard, et pourquoi ?
Chaque classeur correspond à une région et ils fusionnent en un seul tableau. GROUPE PAR sur fileset.data_orders les couvre tous :
| Région | Ordres | Revenu | par rapport à août |
|---|---|---|---|
| Ouest | 4,210 | 1,210,400 | +6% |
| Est | 3,880 | 1,041,200 | +3% |
| Nord | 1,905 | 402,100 | −19% |
Nord est en retard, et ce n'est pas la demande : deux références (NX-200, NX-210Les commandes qui représentaient un tiers du chiffre d'affaires de North en août sont désormais nulles depuis le 9 septembre. Il s'agit donc d'une rupture de stock, et non d'un problème de ventes.
Vous préférez ne pas du tout connecter de client IA ? Concernant le plan d'affaires, Nova Nova est l'assistant intégré à Query Streams. Il utilise les mêmes outils que votre client IA, ainsi que des fonctionnalités supplémentaires : il génère et valide la requête SQL par rapport à votre modèle d'intelligence sémantique, transforme la réponse en graphique et enregistre le résultat sous forme de requête exécutable par votre équipe depuis Excel, Google Sheets ou l'API REST, sans clé, sans connecteur ni installation. Utilisez MCP si vos équipes utilisent déjà Claude, Cursor ou ChatGPT ; utilisez Nova si vous souhaitez que les réponses soient intégrées au portail.
Le Dossier Excel Cette carte fusionne un dossier de classeurs .xlsx en tables SQL, une par feuille, permettant ainsi à Claude de répondre aux questions portant sur l'ensemble des classeurs simultanément. Il ne s'agit pas d'un module complémentaire pour Excel. L'agent lit les classeurs sur son ordinateur, met les lignes en cache et les transmet à Claude via MCP, en relisant chaque classeur dès qu'il est modifié.
Ce dont vous aurez besoin
Un compte Query Streams
MCP est inclus dans tous les forfaits, même le forfait gratuit. Le forfait gratuit permet une clé ou une application connectée, ce qui est suffisant pour ce guide. Inscrivez-vous sur mon.querystreams.com.
L'agent sur un ordinateur capable d'ouvrir le dossier
Version 2.6.0 ou ultérieure. Le dossier peut se trouver sur cet ordinateur ou sur un partage de fichiers accessible. L'agent s'exécute en tant que service ; saisissez donc les partages comme suit : \\serveur\partage\dossiernon pas comme une lettre de lecteur mappée. Sous Windows, vous pouvez vous connecter à un partage avec un identifiant enregistré ; sous Linux ou macOS, vous devez d'abord monter le partage (sous Linux, sous Windows). /mnt ou /médias, un Mac sous /VolumesVous êtes nouveau chez l'agent ? Installez-le sur Windows, macOS ou Linux.
MCP activé pour vous
Les créateurs, propriétaires et administrateurs y ont accès dès le départ. Tous les autres ont besoin d'un administrateur pour activer le contrôle parental. MCP interrupteur à côté de leur nom sous Compte → Contrôle d'accèsEn attendant, la page MCP indique « MCP est désactivé pour votre compte ».
Un client IA
Claude sur le web, Claude Desktop ou les applications mobiles Claude se connectent sans clé. Claude Code, Cursor, ChatGPT et une dizaine d'autres outils sont également compatibles ; le portail propose une configuration prédéfinie pour chacun d'eux.
Où se déroule le travail ? Sur l'ordinateur exécutant l'Agent, celui-ci analyse le dossier, copie les lignes dans un cache local et exécute la requête SQL écrite par Claude sur ce cache. Les fichiers ne quittent jamais cet ordinateur, et aucune action non autorisée par Claude n'est effectuée.
Configurez-le en quatre étapes
-
Indiquez à l'agent le dossier
Dans le portail ouvert Données → Agents de donnéesTrouvez l'agent qui peut ouvrir le dossier et cliquez dessus. Ajouter un connecteur bouton. Sous le Fichiers et dossiers pilule cliquez sur le Dossier Excel carte. Le magicien vous guide ensuite à travers Dossiers, Vérifier, Paramètres, Royaume et Revoir:
- Dossiers
- Tapez le Dossiers racine, un par ligne, comme chemins d'accès sur l'ordinateur de l'agent. Analyser les sous-dossiers est allumé, Profondeur maximale est 8. Inclure des motifs commence par le bon glob pour ce type de fichier ; ajouter Exclure les motifs si le dossier contient des fichiers indésirables. Une lettre de lecteur mappée affiche un avertissement orange : l’Agent ne peut pas la voir, utilisez donc le
\\serveur\partagechemin à la place. - Vérifier
- L'agent lit un échantillon de 64 fichiers maximum et affiche ce qu'il va créer. Rien n'est encore créé. Prêt à créer Cela signifie que chaque fichier échantillonné correspond. Une bannière orange, « {n} des {m} fichiers seront mis de côté », liste les fichiers qui ne correspondent pas. Afficher les fichiers concernés et pourquoiVous pouvez créer le connecteur et le corriger ultérieurement. Si le dossier contient plusieurs mises en page, un panneau bleu s'affiche. Passez à une table par mise en page.
- Paramètres
- Intervalle de balayage (toutes les heures par défaut, de toutes les 5 minutes à une fois par jour) correspond à la fréquence à laquelle l'agent recherche les fichiers nouveaux, modifiés et disparus. Surveillez le dossier pour les modifications Réagit en quelques secondes sur les disques locaux. Lorsqu'un fichier disparaît est Supprimez ses lignes par défaut.
- Royaume, Critique
- Sélectionnez le domaine de données auquel les lignes sont rattachées, vérifiez le récapitulatif et cliquez Créer un connecteurLe premier scan démarre immédiatement ; celui du connecteur Manifeste L'onglet affiche ce qu'il a construit et les fichiers qu'il a mis de côté.
- Il n'y a pas Nom de la table champ. Les feuilles deviennent des tableaux tels que
commandes de données. - Inclure des motifs commence par
**/*.xlsx. Utiliser Feuilles limiter les feuilles qui deviennent des tableaux. - Choisissez un Mise en page du tableau. Une disposition épinglée (par défaut) Convient aux cahiers d'exercices qui partagent tous les mêmes feuilles. Une table par mise en page des dossiers adaptés que les gens assemblent à la main, jusqu'à 25 mises en page.
- Sur VérifierL'agent lit un échantillon et liste les tables qu'il va créer. Si les classeurs présentent des mises en page différentes, un panneau bleu propose des options. Passez à une table par mise en pageUn fichier qui n'est pas un véritable classeur s'affiche sous Afficher les fichiers concernés et pourquoi, par exemple « illisible en tant qu'Excel : non lisible en tant que classeur XLSX ».
-
Voyez quelles tables vous obtenez
Tout se trouve dans le
ensemble de fichiersschéma. Les tables sont nommées automatiquement, car il n'y a pas de schéma prédéfini. Nom de la table champ. Chaque rangée contient_fichier_sourceet_row_id.Tableau Ce qu'il contient fileset.data_ordersAvec Une mise en page épinglée, un tableau par feuille nommé données_<feuille>, contenant les lignes de cette feuille provenant de chaque classeur.ensemble de fichiers.budgetAvec Une table par mise en page, un tableau par mise en page, nommé d'après la partie commune des noms de fichiers, ou d'après le nom de la feuille s'il ne reste rien d'utilisable. ensemble de fichiers.fichiersUne ligne par classeur existant, avec son chemin d'accès, sa taille et sa date de modification. fileset.files_eventsL'historique des modifications, y compris un dériveUne ligne pour chaque classeur mis de côté et la raison.Chaque connecteur de dossier fournit également à Claude les mêmes tables de comptabilité, le tout dans le
ensemble de fichiersschéma:Tableau Ce qu'il contient fichiersChaque fichier présent dans le dossier : chemin d’accès, nom, extension, taille, dates de création et de modification. Demandez « Que contient ce dossier ? » et Claude vous lira ces informations. fichiers_événementsHistorique des modifications : une ligne par fichier apparu, modifié, disparu ou mis de côté ( dérive), avec le temps enévénement_àet la raison dansdétail.annuaires,volumesTaille et nombre des dossiers, et disques ou partages sur lesquels résident les fichiers racines. _fichier_source,_row_idDeux colonnes par ligne de données : le fichier d’origine et un identifiant unique au sein de ce fichier. Grouper par _fichier_sourcecomparer les fichiers. -
Connectez-vous à Claude
Ouvrir Flux → En direct → MCPIl y a deux entrées, et elles mènent au même endroit :
Applications de messagerie instantanée · sans cléclaude.ai, Claude Desktop, ChatGPT
Dans claude.ai et Claude Desktop, ouvrez le Liste des flux de requêtes dans le répertoire des connecteurs d'Anthropic, cliquez Connecter et approuver. L'ajouter par URL,
https://mcp.querystreams.com/mcpIl s'agit de la solution de repli. Dans ChatGPT, vous ajoutez des flux de requêtes depuis l'application (en mode développeur pour le moment) et vous vous connectez avec les flux de requêtes. Dans les deux cas, une page de flux de requêtes s'ouvre : choisissez l'organisation et les autorisations, puis cliquez sur Approuver la connexionRien à copier. La connexion apparaît sur le Connexions onglet et peut être révoqué à cet endroit.Outils de développement · une cléClaude Code, Curseur, VS Code et amis
Sur la page MCP, cliquez Connectez un client IALe guide demande Comment votre client IA se connectera-t-il ?: choisir Utilisez une clé dans un fichier de configuration, choisissez votre outil, puis Générer une clé pour il : un Nom de la clé, Lire et Exécuter des requêtes coché, un Expiration (Jamais, 30 jours, 90 jours ou 1 an). Configurez-le affiche l'extrait avec la légende renseignée, et Vérifiez la connexion attend le premier appel.
Les deux méthodes utilisent les mêmes trois autorisations, que vous choisissez sur l'écran de consentement ou sur la clé :
- Lire
- Consultez les connecteurs, parcourez les tables et les colonnes, lisez vos requêtes enregistrées et vos règles d'alerte. Ne renvoie jamais les données des lignes.
- Exécuter des requêtes
- Exécutez des requêtes SQL en lecture seule et des requêtes enregistrées via votre agent et renvoyez les lignes. Sans cela, votre client IA peut décrire vos données, mais pas y répondre.
- Analyser
- Profilez les tables, découvrez les relations et mettez en file d’attente une exécution de Semantic Intelligence. Le profilage et la découverte sont gratuits ; une exécution de Semantic Intelligence consomme des crédits Nova AI et le quota de données. L’écran de consentement ne la présélectionne donc jamais.
Vous avez perdu la clé ? Il est répertorié sur le Connexions languette: Afficher la clé complète le montre à nouveau et Copier la clé complète Il est copié. Révoquez-le à cet endroit si un ordinateur portable est perdu ; chaque client l’utilisant échoue à son prochain appel, dans un délai d’environ cinq minutes.
Choisissez ensuite la recette du Claude que vous utilisez. L'adresse du serveur est la même partout :
https://mcp.querystreams.com/mcp.Claude sur le web, Claude Desktop et mobile pas de clé
- Ouvrez le Liste des flux de requêtes dans le répertoire des connecteurs d'Anthropic et cliquez ConnecterSur ordinateur de bureau, il se trouve alors sous + → Connecteurs.
- Solution de repli, si votre organisation masque les connecteurs d'annuaire : Paramètres → Connecteurs → Ajouter un connecteur personnalisé, nom Flux de requêtes, URL
https://mcp.querystreams.com/mcp, champs OAuth vides, Ajouter; puis dans une conversation + → Flux de requêtes → Connecter. - Un onglet Flux de requêtes s'ouvre. Connectez-vous si nécessaire, sélectionnez l'organisation et consultez. Lire et Exécuter des requêtes, éventuellement Limiter à des connecteurs spécifiques, et cliquez Approuver la connexion.
- De retour dans Claude, vous voyez « Connecté aux flux de requêtes ». La première fois que Claude utilise un outil, il vous demande de choisir. Toujours permettre.
Si vous l'ajoutez manuellement dans Claude Desktop, utilisez Paramètres → Connecteurs → Ajouter, pas le chat intégré Ajouter une place de marché Cette option nécessite un dépôt Git. Les connecteurs se synchronisent avec votre compte Claude, ce qui permet aux applications mobiles et à l'application de bureau de la prendre en charge automatiquement. Les noms des menus sont ceux d'Anthropic et peuvent être déplacés.
Code Claude clé
Une seule commande, avec votre clé de l'onglet Connexions :
Terminalclaude mcp add --transport http querystreams https://mcp.querystreams.com/mcp \ --header "X-MCP-Key: qsmcp_PASTE_YOUR_KEY_HERE"
Cela décrit le projet actuel
.mcp.json. Ajouter--scope utilisateurPour avoir des flux de requêtes dans chaque projet. Exécuter/mcpÀ l'intérieur du code Claude, pour voir le lien.Curseur clé
Ouvrir Paramètres du curseur → MCP → Ajouter un nouveau serveur MCP, ou modifier
.cursor/mcp.jsonà la racine de votre espace de travail :.cursor/mcp.json{ "mcpServers": { "querystreams": { "url": "https://mcp.querystreams.com/mcp", "headers": { "X-MCP-Key": "qsmcp_PASTE_YOUR_KEY_HERE" } } } }Redémarrez le curseur ou exécutez MCP : Redémarrer les serveurs; un
flux de requêtesLe badge apparaît dans la barre d'état du MCP.Vous utilisez autre chose ? Le portail Connectez un client IA guide contient des recettes prêtes à l'emploi pour ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev et JetBrains AI, ainsi qu'un Coller et fusionner l'outil qui laisse tomber le
flux de requêtesAjoutez cette entrée à un fichier de configuration existant. Tout client compatible MCP sur HTTP fonctionne : serveurhttps://mcp.querystreams.com/mcp, en-têteClé X-MCP(unAutorisation : PorteurL'en-tête avec la même clé fonctionne également). -
Posez votre première question
Commencez par un élément que vous pouvez vérifier en ouvrant le dossier, afin de voir Claude prendre le bon tableau. Trois méthodes qui fonctionnent bien avec un dossier de classeurs Excel :
- « Quels classeurs se trouvent dans le dossier, et qui les a modifiés en dernier ? »
- Claude interroge
ensemble de fichiers.fichiers(Exécuter des requêtes) et liste chaque classeur avecmodifié_utcetpropriétaireLe champ propriétaire est renseigné uniquement sous Windows. - « Montrez-moi les colonnes de fileset.data_orders et les dix commandes les plus importantes. »
- Claude lit d'abord le schéma de la table (Lecture), puis exécute une opération.
SELECTIONNERtrié selon la colonne du montant avecLIMITE 10via votre agent (Exécuter des requêtes). - « Des cahiers d’exercices ont-ils été mis de côté cette semaine ? Pourquoi ? »
- Claude interroge
fileset.files_eventspourdérivelignes, filtrées et triées parévénement_à(Exécuter des requêtes). Vous obtenez chaque classeur et la raison dansdétail.
Pour confirmer le câblage, demandez « De quels connecteurs Query Streams ai-je accès ? »Claude appelle
qs_list_connectors, le guide du Portail Vérifiez la connexion étape dit Connecté, et la clé ou l'application sur le Connexions L'onglet affiche son Dernière utilisation en quelques secondes.
C'est ça. Déposez un nouveau fichier dans le dossier et, après la prochaine analyse, Claude pourra répondre à partir de celui-ci. Les fichiers n'ont jamais quitté l'ordinateur sur lequel ils se trouvaient, et personne n'a saisi de mot de passe dans une IA.
Accéder à un fichier sur un partage réseau
L'agent ouvre les fichiers en tant que service en arrière-plan, et non en tant qu'utilisateur. Par conséquent, un fichier situé sur un autre ordinateur nécessite une étape supplémentaire. Cette étape dépend de l'ordinateur sur lequel l'agent est exécuté.
Si le test ne parvient pas à accéder à l'action, recherchez ces mots dans son résultat : injoignable Cela signifie que l'ordinateur de l'agent n'a reçu aucune réponse du serveur. Sous Linux ou Mac, non monté Cela signifie que le partage doit encore être monté, et ce message inclut la commande de montage exacte pour votre serveur.
Des dossiers sur un partage ? Sous Windows, une seule connexion permet de couvrir tous les dossiers ajoutés depuis le même serveur. Surveillez le dossier pour les modifications Cela fonctionne également sur un partage, au mieux de nos capacités ; l'analyse planifiée garantit que chaque modification est prise en compte.
Affichage des fichiers nouveaux, modifiés et supprimés
Fichiers nouveaux et modifiés
Sur chaque Intervalle de balayage L'agent compare la taille et la date de modification de chaque fichier avec son registre. Un nouveau fichier compatible est ajouté ; un fichier modifié est relu intégralement, de sorte qu'une table ne contient jamais deux versions d'un même fichier. Activer Surveillez le dossier pour les modifications Réagir en quelques secondes sur un disque local.
Fichiers supprimés
Un fichier qui disparaît perd ses lignes, sauf si vous l'avez choisi Conserver les lignes, marquer comme suppriméesSi un partage devient inaccessible et que la plupart des fichiers disparaissent simultanément, l'Agent conserve le dernier inventaire valide au lieu de tout supprimer.
Fichiers mis de côté
Un fichier qui ne correspond pas à la mise en page, qui ne peut pas être ouvert ou qui est verrouillé est mis de côté : aucune de ses lignes n’est chargée, et fichiers_événements Ce système enregistre le fichier concerné et la raison de cette modification. Une nouvelle tentative est automatiquement lancée lors de la prochaine modification. Il n'existe pas de bouton « Réanalyser ».
Ce que voit Claude
Données mises à jour lors de la dernière analyse. Aucun outil MCP ne déclenche d'analyse ; demandez donc « Quand ces données ont-elles été mises à jour pour la dernière fois ? » et Claude lira les dernières informations. événement_à dans fichiers_événements pour toi.
Ce que Claude peut faire une fois connecté
Votre client IA visualise les outils Query Streams et sélectionne celui qui convient le mieux à votre question. Le portail Outils onglet répertorie tous les outils et modes inclus dans votre forfait. Query Streams demande à votre client IA de lire les colonnes de chaque table avant d’effectuer une requête, afin qu’il utilise les noms réels au lieu de les deviner. Dans tous les forfaits, y compris Free :
Cartographiez vos données
Connecteurs, bases de données et agents ; les tables et les colonnes de votre fichier Excel avec descriptions, exemples de valeurs et jointures une fois l’intelligence sémantique exécutée.
Profil et exploration
Analysez une colonne avant de l’utiliser comme filtre ; découvrez des jointures que personne n’a déclarées. Les exécutions en direct nécessitent Analyze.
Exécuter une requête SQL en lecture seule
Une requête SELECT dans le dialecte approprié pour le dossier Excel, d'une durée de 60 secondes par défaut et de 5 minutes maximum. Votre plan détermine le nombre maximal de lignes renvoyées par une requête. (Exécuter les requêtes)
Requêtes enregistrées, fédérées et alertes
Exécutez les requêtes enregistrées approuvées par votre équipe avec de nouvelles valeurs ; les requêtes fédérées seront automatiquement jointes. Consultez les règles d’alerte et rédigez-en une à titre de test.
L'ensemble d'outils analytiques. Avec les abonnements payants, l'agent prépare le terrain à l'emplacement de votre fichier Excel, permettant ainsi à votre client IA de se concentrer sur le traitement des données. La version gratuite fonctionne comme d'habitude.
Gestion du contexte
Noyau personnel et plusÉvaluez la taille d'un résultat avant de le lire (forme), parcourir une grande base de données zone par zone (niveaux), et limiter les réponses à un budget de jetons avec uniquement les colonnes et les longueurs de cellules dont elle a besoin.
Analyse des résultats
Noyau personnel et plusA profil du résultat complet au lieu des lignes. Résultats maintenus avec des étiquettes, répondez aux questions de suivi et regroupez les totaux sans deuxième requête. fraîcheur des données et modifié depuis Ne lisez que les nouveautés.
Les valeurs par défaut sont disponibles sur le Contexte onglet: limite de cellules de texte, vue du schéma, taille des résultats, paramètres d'analyse par défaut et résultats mis en attente.
Les noms des outils, si vous souhaitez les reconnaître dans les réponses de votre client IA
| Autorisation | Outils |
|---|---|
| Lire | qs_list_organisations qs_list_agents qs_list_connectors qs_get_si_status qs_get_connector_schema qs_find_tables qs_get_table_schema qs_get_relationships table de profils qs qs_découvrir_les_relations qs_list_saved_queries qs_alerts qs_result (op=windows) |
| Analyser | qs_request_si_analyse qs_setup_si qs_get_task_status, répertorié uniquement pour les clés disposant d’Analyze ; exécutions en direct de table de profils qs et qs_découvrir_les_relations |
| Exécuter des requêtes | qs_run_query qs_run_saved_query fraîcheur des données qs qs_result (toute autre op) qs_result_release qs_create_alert_rule (propositions seulement) |
Pourquoi l'intelligence sémantique est importante ici
Chaque réponse que reçoit Claude est étiquetée avec l'origine de la structure, et Claude ajuste son degré de confiance envers ce qu'il voit.
| Étage | Ce que voit Claude | Résultat |
|---|---|---|
| Intelligence sémantique | Descriptions pour chaque table et colonne, exemples de valeurs, significations des énumérations, jointures déclarées et découvertes. | Claude rédige du premier coup le bon code SQL pour votre dossier Excel et explique les données en termes adaptés à votre activité. |
| Schéma capturé | Noms des tables et des colonnes, types, clés. | Claude travaille, mais il déduit le sens des noms et peut demander un complément d'information. |
| Schéma en direct | La base de données se trouve en dehors de la zone de capture du connecteur, sa structure est donc lue en direct à chaque requête (nécessite l'autorisation d'exécuter des requêtes ; SQL Server, MySQL et PostgreSQL). | Les requêtes continuent de s'exécuter. Claude effectue des explorations avec de petites sélections lorsque cela s'avère nécessaire. |
Si une base de données est importante, exécutez l'analyse sémantique une seule fois. Nova → Intelligence. Le Connexions L'onglet affiche un panneau de couverture par connecteur. Comment fonctionne l'intelligence sémantique.
Ce que les plans permettent
MCP est inclus dans tous les forfaits, même le forfait gratuit, sans frais supplémentaires. Chaque forfait définit le nombre de touches ou d'applications connectées que vous pouvez gérer et le nombre d'appels par minute que votre client IA peut effectuer.
| Plan | Clés par utilisateur | Clés par organisation | Appels par minute |
|---|---|---|---|
| Gratuit | 1 | 1 | 30 |
| Noyau personnel | 1 | 1 | 60 |
| Personnel Plus | 1 | 1 | 90 |
| Cœur de métier | 2 | 3 | 120 |
| Business Plus | 3 | 5 | 150 |
| Business Max | 5 | 10 | 240 |
| Noyau d'entreprise | 5 | 25 | 300 |
| Entreprise Plus | 8 | 50 | 450 |
| Enterprise Max | 10 | 100 | 600 |
Une application connectée compte comme une clé. En plus du débit par minute, chaque clé peut exécuter au maximum 10 requêtes par minute. Une requête s'exécute pendant 60 secondes maximum, sauf si votre client IA en demande davantage (jusqu'à cinq minutes). Votre plan définit également le nombre de lignes renvoyées par une requête et, avec l'ensemble d'outils analytiques, la durée et la taille maximales des résultats conservés. le guide complet du MCP répertorie tous les forfaits. Ce que votre client IA reçoit est décompté de votre quota Data Realm, le même quota que celui utilisé par vos requêtes Excel et Sheets : l’utilisation par l’agent IA (MCP) comptabilise chaque octet transmis à votre client IA, qu’il s’agisse de résultats, de lectures de schéma ou de pages de résultats conservées, avant toute compression de transport négociée par votre client. Les requêtes de feuilles de calcul, quant à elles, comptabilisent le résultat compressé transmis par votre Network Agent. Les exécutions de Semantic Intelligence lancées depuis votre client IA consomment des crédits Nova AI, exactement comme celles lancées depuis le Portal. Consultez la page des prix pour les indemnités.
Le garder en sécurité
Lecture seule, vérifiée par l'agent
Seules les instructions SELECT sont exécutées. La vérification a lieu sur l'ordinateur qui exécute l'agent, avant que votre fichier Excel ne prenne connaissance du code SQL ; par conséquent, aucune modification des données ne peut être apportée par votre client d'IA.
Aucune accréditation en IA
L'identifiant du dossier Excel reste sur l'agent. Claude détient une clé ou une connexion Query Streams, que vous pouvez révoquer depuis la page MCP ; la modification prend effet en cinq minutes environ.
Tout est enregistré
Chaque appel d'outil apparaît sur le MCP Activité Chaque requête est enregistrée dans l'onglet « Historique des requêtes » et associée au client de type MCP, à la personne ayant effectué l'exécution via la clé ou la connexion. Le texte SQL et la clé elle-même ne sont jamais consignés dans le journal d'activité.
Ce que reçoit le fournisseur d'IA
Les noms des tables et des colonnes, les descriptions d'intelligence sémantique (y compris des exemples de valeurs) et les lignes des requêtes que vous effectuez sont transmis. Avec l'ensemble d'outils analytiques, l'agent obtient souvent une estimation de taille, un profil ou une réponse en attente, tandis que le résultat complet reste disponible pour l'agent. Les données qu'il reçoit sont transmises au fournisseur d'IA auquel vous vous êtes connecté, conformément à ses conditions d'utilisation. Query Streams n'a jamais accès à vos conversations.
Bonnes prochaines étapes
- Exécuter l'intelligence sémantique sur le connecteur afin que Claude voie les descriptions des colonnes de votre propre feuille.
- Demandez à quel point les données sont récentes. Claude consulte les données de la dernière analyse et les réponses des plus récentes.
événement_àdansfichiers_événements. - Consultez le guide du dossier Excel à Fusionner plusieurs fichiers Excel en un seul tableau pour chaque réglage.
Quand quelque chose ne fonctionne pas
| Ce que vous voyez | Ce que cela signifie | Réparer |
|---|---|---|
| Votre client IA n'affiche aucun outil de flux de requêtes | Le connecteur a été ajouté mais jamais branché, ou la clé a été collée au mauvais endroit. | À Claude : + → Flux de requêtes → ConnecterDans un outil de développement : redémarrez-le, puis utilisez Vérifiez la connexion dans le guide du portail. |
CLÉ_MCP_REQUISE ou 401 | Aucune clé n'a atteint le serveur, généralement à cause d'une ligne de saut de ligne parasite lors d'un copier-coller ou d'une clé placée dans un en-tête incorrect. | Copiez à nouveau la clé depuis l'onglet Connexions et envoyez-la dans le Clé X-MCP en-tête. |
MCP_UTILISATEUR_DÉSACTIVÉ | Un administrateur a désactivé MCP pour votre utilisateur. | Demandez-leur de tourner le MCP remettre en marche sous Compte → Contrôle d'accès. |
MCP_SCOPE_REQUIRED ou MCP_SCOPE_DÉFINI | La clé ou la connexion ne dispose pas de l'autorisation pour cette action, généralement l'exécution de requêtes. | Modifiez la clé dans l'onglet Connexions et cochez la case. Exécuter des requêtes, ou reconnectez l'application et approuvez-la. |
MCP_KEY_ORG_LIMIT_DÉPASSÉ | Votre limite de clés est atteinte. Avec la version gratuite, cela correspond à une clé ou une application connectée. | Révoquez un forfait que vous n'utilisez plus ou passez à un forfait supérieur. |
MCP_AGENT_NOT_CONNECTED ou MCP_AGENT_NON_INSCRIT | L'agent propriétaire de votre fichier de dossier Excel n'est pas connecté actuellement. | Ouvrir Données → Agents de données et démarrer l'agent sur son ordinateur. |
MCP_DATABASE_NOT_CAPTURED | La base de données se trouve en dehors de la zone de capture du connecteur ; par conséquent, aucun schéma ni aucune information sémantique n'y sont stockés. Les requêtes restent fonctionnelles. | Ajoutez-le à la sélection de capture du connecteur, puis exécutez Semantic Intelligence si vous souhaitez des réponses plus riches. |
MCP_RATE_LIMITED | Trop d'appels par minute pour votre forfait, ou plus de 10 requêtes par minute sur une seule clé. | Attendez un instant. L'intelligence sémantique permet à Claude de répondre en moins d'appels. |
Délai d'attente de requête MCP ou MCP_OUTPUT_TOO_LARGE | La requête a dépassé son délai d'expiration ou a renvoyé plus d'informations que votre client IA ne peut en traiter en une seule réponse. | Demandez moins de lignes ou de colonnes, ou un filtre par date. Pour les forfaits avec gestion du contexte, demandez d'abord le dimensionnement du résultat. |
MCP_DATA_REALM_EXHAUSTED | Le quota de données de votre organisation pour la période est épuisé. | Attendez que le solde soit réinitialisé ou rechargez-le depuis le portail. |
FONCTIONNALITÉ_MCP_NON_INCLUE | Votre plan n'inclut pas la gestion du contexte, l'analyse des résultats ou l'analyse approfondie, ou cet 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 actuellement, ou bien un suivi nécessiterait plus de mémoire que celle disponible. | 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 connecteur. | Demandez à un administrateur d'activer Analyse locale sur la page Agents de données, ou autorisez 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 le résultat conservé, ni ne nommait une colonne qui n'apparaît pas dans le 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ées; les requêtes simples continuent de fonctionner en attendant. |
| violation de lecture seule | La requête SQL n'était pas une requête SELECT. | C'est voulu. Aucune écriture ne transite par le MCP. |
Questions que se posent les gens
Mes cahiers d'exercices contiennent des feuilles différentes. Que se passe-t-il ?
Avec Une mise en page épingléeUn classeur auquel il manque une feuille épinglée est mis de côté et aucune de ses lignes ne se charge. L'étape Vérifier propose Passez à une table par mise en page, ce qui donne à chaque mise en page sa propre table, jusqu'à 25. Les noms des tables ne changent jamais tant que la mise en page reste épinglée.
Un classeur avec une nouvelle mise en page s'affichera-t-il automatiquement ?
Non. Il est mis de côté avec une note indiquant qu'il s'agit d'une nouvelle disposition. Modifiez et enregistrez une option de connecteur, par exemple : FeuillesL'agent échantillonne à nouveau le dossier. Les noms des tables existantes sont conservés.
Puis-je utiliser un dossier synchronisé depuis OneDrive ?
Oui, lorsque les fichiers sont stockés sur l'ordinateur. Définissez le dossier sur Gardez toujours cet appareil alluméL'agent ne télécharge pas les fichiers stockés uniquement dans le cloud, et l'espace réservé dans le cloud n'est pas lu.
Claude lit-il mes fichiers ?
Non. L'agent lit les fichiers sur son propre ordinateur et conserve les lignes dans un cache local. Claude envoie des requêtes SQL à Query Streams, l'agent les exécute sur ce cache, et seules les lignes nécessaires à la requête sont renvoyées. Claude n'ouvre jamais de fichier et ne peut ni le modifier, ni le déplacer, ni le supprimer.
Dois-je ouvrir un port ou utiliser un VPN ?
Non. L'agent établit une seule connexion sortante sur le port 443, et les requêtes comme les lignes transitent par ce port. Si le protocole HTTPS sortant fonctionne, cela fonctionne également.
Le dossier peut-il se trouver sur un partage réseau, ou dans OneDrive ou Dropbox ?
Un partage fonctionne tant que l'ordinateur de l'agent peut l'ouvrir ; saisissez-le comme suit : \\serveur\partage\dossierEn effet, l'agent s'exécute en tant que service et ne peut pas voir les lecteurs mappés sur votre session. Sous Windows, ajoutez l'identifiant de partage à partir du dossier. Attestation Si le partage n'autorise l'accès qu'à des personnes nommées, modifiez cette colonne. Sous Linux ou macOS, montez d'abord le partage (les identifiants enregistrés ne sont pas utilisés). Pour un dossier cloud synchronisé, configurez-le pour conserver les fichiers sur cet appareil ; l'agent ignore les fichiers de substitution du cloud.
Le forfait gratuit couvre-t-il vraiment cela ?
Oui. L'offre gratuite est un forfait permanent, et non une période d'essai. MCP est inclus dans tous les forfaits ; l'offre gratuite permet une touche ou une application connectée et 30 appels par minute. Les connecteurs de dossiers n'ont pas de limite de fichiers. Consultez la liste complète des fonctionnalités de l'offre gratuite sur la page dédiée. page de tarification.
Quels outils d'IA fonctionnent en dehors de Claude ?
Tout ce qui prend en charge MCP sur HTTP : ChatGPT, Cursor, VS Code avec Copilot, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev et JetBrains AI disposent tous d’une solution toute prête dans le guide « Connecter un client d’IA » du portail.
Guides associés
Chaque guide pour Excel Folder
Ce n'est pas tout à fait votre configuration ?
- Vous avez seulement besoin d'une liste de fichiers avec leur taille, leur date et leurs modifications ? Le système de fichiers le fait sans lire les fichiers. File System
Problème de configuration ?
- L'agent indique que le fichier ou le dossier n'existe pas, ou que l'accès est refusé ? Les lecteurs réseau mappés, les partages réseau, OneDrive et les dossiers personnels Linux nécessitent chacun une solution → Où l'agent peut lire des fichiers à partir de
- L'agent est indiqué comme hors ligne, ou les options « Tester la connexion » et « Parcourir » sont grisées ? Vérifiez que l'agent est en ligne → L'agent est-il en ligne ?


