> ## Documentation Index > Fetch the complete documentation index at: https://docs.querying.ai/llms.txt > Use this file to discover all available pages before exploring further. # Connecter des agents IA au serveur MCP de querying.ai > Donnez à Claude Code, Codex ou à tout client MCP des outils pour interroger les moteurs d'IA, scraper des pages, rechercher des prompts et gérer des moniteurs GEO. Le serveur MCP de querying.ai expose l'API sous forme d'outils [Model Context Protocol](https://modelcontextprotocol.io/). Il utilise les mêmes moteurs, la même file, les mêmes formes de résultat et les mêmes clés d'API que l'API REST, et il ne stocke ni votre clé ni vos tâches. | | | | - | - | | Endpoint | `https://mcp.querying.ai/mcp` | | Transport | Streamable HTTP | | Authentification | `Authorization: Bearer ` | ## Connecter un client Placez d'abord votre clé dans la variable d'environnement `QUERYING_API_KEY`. Obtenez-en une depuis [Clés d'API](https://querying.ai/dashboard/keys). **Claude Code** ```bash theme={"theme":"css-variables"} claude mcp add --transport http querying \ https://mcp.querying.ai/mcp \ --header 'Authorization: Bearer ${QUERYING_API_KEY}' ``` Conservez les guillemets simples. Avec des guillemets doubles, votre shell développe la clé une fois et Claude Code enregistre sa valeur dans son fichier de configuration. **Codex** Ajoutez à `~/.codex/config.toml` : ```toml theme={"theme":"css-variables"} [mcp_servers.querying] url = "https://mcp.querying.ai/mcp" bearer_token_env_var = "QUERYING_API_KEY" tool_timeout_sec = 240 ``` **mcp.json** Pour les clients qui lisent un fichier `mcp.json` : ```json theme={"theme":"css-variables"} { "mcpServers": { "querying": { "url": "https://mcp.querying.ai/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } } ``` Tout autre client Streamable HTTP fonctionne s'il envoie ces en-têtes à chaque requête : ```http theme={"theme":"css-variables"} Authorization: Bearer Accept: application/json, text/event-stream Content-Type: application/json ``` Une requête sans en-tête bearer renvoie `401`. Une clé invalide est signalée au premier appel d'outil, sous forme d'erreur d'outil. ## Outils Les outils qui soumettent des tâches coûtent autant que l'appel d'API équivalent. Les outils en lecture seule sont gratuits. ### Tâches et recherche | Outil | Rôle | Crédits | | - | - | - | | `run_prompt` | Soumet un prompt à un moteur et attend le résultat. | Le prix du moteur | | `submit_prompt` | Soumet un prompt et renvoie immédiatement la tâche en file. | Le prix du moteur | | `get_task` | Renvoie le statut d'une tâche, et son résultat une fois terminée. | Gratuit | | `scrape_page` | Lit une page web ou un PDF texte en Markdown (`WEB_SCRAPE`) et attend le résultat. | 1 par URL | | `read_product` | Lit une page produit d'une boutique (`COMMERCE_PRODUCT`) et attend son prix, son stock, ses images, ses images de description, ses caractéristiques et ses options. | 3 par page | | `research_prompts` | Trouve les questions que les gens posent aux assistants IA sur un sujet, classées par demande de recherche, avec un `monitorSet` prêt pour `create_monitor`. Marchés US et KR. | 11 | | `run_product_lookup` | Interroge les moteurs d'achat IA sur un produit et jusqu'à 5 concurrents et attend le résultat : si chaque moteur les montre, marchands, prix, sites cités et ceux que font ressortir les prompts d'achat. Marchés US et KR. | 10 par produit, 5 par prompt d'achat | | `get_product_lookup` | Renvoie une recherche Product Lookup par id, en résumé ou en entier. | Gratuit | `run_prompt` et `submit_prompt` prennent `taskType`, `prompt` et, en option, `country`, `idempotencyKey`, `include` et `page` (de 1 à 10, pour `GOOGLE_SERP` et `NAVER_SERP`). Consultez [Moteurs](/fr/engines/overview.md) pour les moteurs et leurs prix, et [Prompt Research](/fr/research/prompt-research.md) pour les paramètres de recherche. Pour `COMMERCE_SERP`, envoyez `site` et `query` à la place de `prompt`, avec `limit` en option (de 1 à 40) ; consultez [Commerce Search](/fr/engines/commerce-serp.md). `read_product` prend `url` et, en option, `country` et `idempotencyKey` ; consultez [Commerce Product](/fr/engines/commerce-product.md). `run_product_lookup` prend `product`, `country` et, en option, `competitors`, `prompts`, `engines` et `idempotencyKey` ; voir [Product Lookup](/fr/research/product-lookup.md). Il renvoie un résumé : pour chaque produit, les moteurs qui le montrent, sa fourchette de prix, les 10 premiers marchands et sites cités et une ligne par moteur ; pour chaque prompt d'achat, les produits que chaque moteur a montrés ou nommés. C'est environ un dixième de la réponse complète. Passez `detail: "full"` pour obtenir chaque fiche, page citée et id de tâche. ### Moniteurs GEO Chaque outil de moniteur effectue un appel d'API avec votre clé : la propriété, les moteurs autorisés de la clé et les limites du plan s'appliquent comme en REST. Consultez [Suivi GEO](/fr/monitors.md). | Outil | Rôle | Crédits | | - | - | - | | `get_monitor_capabilities` | Moteurs de moniteur, crédits par tâche, limites et définitions des métriques. Appelez-le avant de configurer un moniteur. | Gratuit | | `list_monitors` | Vos moniteurs avec leurs agrégats sur 30 jours. | Gratuit | | `get_monitor` | La vue détaillée historique d'un moniteur. | Gratuit | | `create_monitor` | Crée un moniteur et lance sa première exécution. Chaque exécution soumet une tâche par prompt, point et échantillon sur chaque moteur. | Par exécution ; voir [Coût et calendrier](/fr/monitors.md#coût-et-calendrier) | | `update_monitor` | Modifie des champs, ou met en pause et reprend avec `enabled`. | Gratuit ; plus de prompts ou de moteurs augmentent le coût de chaque exécution | | `delete_monitor` | Supprime un moniteur et son historique de scores. Irréversible. | Gratuit | | `run_monitor` | Lance une exécution immédiatement. | Les tâches d'une exécution, facturées comme une exécution planifiée | | `get_monitor_analytics` | Taux de mention et de citation, comparaison de périodes, part de voix, lignes par moteur et par prompt. | Gratuit | | `get_monitor_sources` | Domaines ou pages cités, paginés avec `nextCursor`. | Gratuit | | `get_monitor_results` | Lignes scorées, avec le texte de la réponse et les sources quand `includeEvidence` vaut true. | Gratuit | | `get_monitor_answer` | Le Markdown, les sources et le contexte de scoring d'une réponse. | Gratuit | | `suggest_monitor_prompts` | Propose des idées de prompts à partir des informations sur la marque. Rien n'est enregistré. | Gratuit ; 30 appels par heure, un toutes les 20 secondes | | `get_monitor_alerts` | Historique des alertes et état d'armement de l'alerte. | Gratuit | | `test_monitor_alert` | Envoie un e-mail d'alerte de test. Limité à 3 par moniteur toutes les 5 minutes (`429 RATE_LIMITED`). | Gratuit | ## Délais d'attente `run_prompt`, `scrape_page`, `read_product` et `research_prompts` interrogent la tâche jusqu'à ce qu'elle se termine. Ils attendent `timeoutSeconds` (180 par défaut, 900 au maximum). Si la tâche est toujours en cours, l'outil renvoie une erreur `TASK_TIMEOUT` avec le `taskId`. La tâche continue de s'exécuter ; appelez `get_task` avec cet id pour la récupérer. `run_product_lookup` interroge la recherche de la même façon. Il attend 210 secondes par défaut pour se terminer dans un timeout client de 240 secondes, et la plupart des recherches se terminent en 2 à 3 minutes. Si la recherche est toujours en cours, l'outil renvoie une erreur `LOOKUP_TIMEOUT` avec le `lookupId` ; appelez `get_product_lookup` avec cet id. Réglez le délai d'outil de votre client au-delà de `timeoutSeconds`. L'exemple Codex utilise `tool_timeout_sec = 240` pour la valeur par défaut de 180 secondes. Si votre client n'autorise que des appels d'outil courts, utilisez `submit_prompt` puis `get_task`. ## Erreurs Les erreurs d'outil reviennent en JSON dans le résultat de l'outil : | Code | Signification | | - | - | | Codes d'erreur de l'API comme `KEY_SCOPE_DENIED` | L'API a refusé l'appel ; le statut et les détails sont inclus. Consultez [Erreurs](/fr/concepts/errors.md). | | `VALIDATION_ERROR` | L'entrée de l'outil était invalide. | | `TASK_TIMEOUT` | L'attente a pris fin avant la fin de la tâche. Inclut `taskId`. | | `LOOKUP_TIMEOUT` | L'attente a pris fin avant toutes les requêtes de la recherche de produit. Inclut `lookupId` et les moteurs encore en attente. | | `TASK_FAILED` | La tâche a échoué. Inclut `taskId` et le résultat de la tâche. | ## Facturation Chaque appel d'outil est facturé au compte propriétaire de la clé, aux mêmes prix que l'API REST. Les réglages de la clé s'appliquent : [des moteurs autorisés ou une limite quotidienne de crédits](/fr/authentication.md#réglages-de-la-clé) sur la clé limitent ce que l'agent peut dépenser. Donnez à un agent sa propre clé restreinte avec une limite quotidienne. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.