Connecter des agents IA au serveur MCP de querying.ai

Le serveur MCP de querying.ai expose l’API sous forme d’outils Model Context Protocol. 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 <API key>`

Connecter un client

Placez d’abord votre clé dans la variable d’environnement QUERYING_API_KEY. Obtenez-en une depuis Clés d’API.

Claude Code
Codex
mcp.json

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.

Ajoutez à ~/.codex/config.toml :

[mcp_servers.querying]
url = "https://mcp.querying.ai/mcp"
bearer_token_env_var = "QUERYING_API_KEY"
tool_timeout_sec = 240

Pour les clients qui lisent un fichier mcp.json :

{
  "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 :

Authorization: Bearer <API key>
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 pour les moteurs et leurs prix, et Prompt Research 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. read_product prend url et, en option, country et idempotencyKey ; consultez Commerce Product. run_product_lookup prend product, country et, en option, competitors, prompts, engines et idempotencyKey ; voir Product Lookup. 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.

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
`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.
`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 sur la clé limitent ce que l’agent peut dépenser. Donnez à un agent sa propre clé restreinte avec une limite quotidienne.

Premiers pas

Concepts clés

Moteurs de réponse

Recherche et données web

Options de requête

Analyses

Suivi GEO

Compte et données

Connecter des agents IA au serveur MCP de querying.ai

Connecter un client

Outils

Tâches et recherche

Moniteurs GEO

Délais d’attente

Erreurs

Facturation

​Connecter un client

​Outils

​Tâches et recherche

​Moniteurs GEO

​Délais d’attente

​Erreurs

​Facturation

Connecter un client

Outils

Tâches et recherche

Moniteurs GEO

Délais d’attente

Erreurs

Facturation