> ## 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. # Conecte agentes de IA com o servidor MCP da querying.ai > Dê ao Claude Code, ao Codex ou a qualquer cliente MCP ferramentas para consultar mecanismos de IA, fazer scraping de páginas, pesquisar prompts e gerenciar monitores GEO. O servidor MCP da querying.ai expõe a API como ferramentas do [Model Context Protocol](https://modelcontextprotocol.io/). Ele usa os mesmos mecanismos, a mesma fila, os mesmos formatos de resultado e as mesmas chaves de API da API REST, e não armazena sua chave nem suas tarefas. | | | | - | - | | Endpoint | `https://mcp.querying.ai/mcp` | | Transporte | Streamable HTTP | | Autenticação | `Authorization: Bearer ` | ## Conecte um cliente Primeiro, coloque sua chave na variável de ambiente `QUERYING_API_KEY`. Obtenha uma em [Chaves de 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}' ``` Mantenha as aspas simples. Com aspas duplas, seu shell expande a chave uma vez e o Claude Code grava o valor no arquivo de configuração dele. **Codex** Adicione a `~/.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** Para clientes que leem um arquivo `mcp.json`: ```json theme={"theme":"css-variables"} { "mcpServers": { "querying": { "url": "https://mcp.querying.ai/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } } ``` Qualquer outro cliente Streamable HTTP funciona se enviar estes cabeçalhos em cada requisição: ```http theme={"theme":"css-variables"} Authorization: Bearer Accept: application/json, text/event-stream Content-Type: application/json ``` Uma requisição sem cabeçalho bearer retorna `401`. Uma chave inválida é informada na primeira chamada de ferramenta, como erro da ferramenta. ## Ferramentas As ferramentas que enviam tarefas custam o mesmo que a chamada equivalente à API. As ferramentas somente leitura são gratuitas. ### Tarefas e pesquisa | Ferramenta | O que faz | Créditos | | - | - | - | | `run_prompt` | Envia um prompt a um mecanismo e espera o resultado. | O preço do mecanismo | | `submit_prompt` | Envia um prompt e devolve na hora a tarefa na fila. | O preço do mecanismo | | `get_task` | Devolve o status de uma tarefa e, quando ela termina, o resultado. | Grátis | | `scrape_page` | Lê uma página web ou um PDF de texto como Markdown (`WEB_SCRAPE`) e espera o resultado. | 1 por URL | | `read_product` | Lê uma página de produto de uma loja (`COMMERCE_PRODUCT`) e espera preço, estoque, imagens, imagens da descrição, especificações e opções. | 3 por página | | `research_prompts` | Encontra as perguntas que as pessoas fazem a assistentes de IA sobre um tema, ordenadas por demanda de busca, com um `monitorSet` pronto para `create_monitor`. Mercados US e KR. | 11 | | `run_product_lookup` | Pergunta aos mecanismos de compras com IA sobre um produto e até 5 concorrentes e espera o resultado: se cada mecanismo os mostra, vendedores, preços, sites citados e quais surgem nos prompts de compra. Mercados US e KR. | 10 por produto, 5 por prompt de compra | | `get_product_lookup` | Devolve uma consulta de Product Lookup por id, em resumo ou completa. | Grátis | `run_prompt` e `submit_prompt` recebem `taskType`, `prompt` e, opcionalmente, `country`, `idempotencyKey`, `include` e `page` (1 a 10, para `GOOGLE_SERP` e `NAVER_SERP`). Veja [Mecanismos](/pt/engines/overview.md) para os mecanismos e seus preços, e [Prompt Research](/pt/research/prompt-research.md) para as entradas da pesquisa. Para `COMMERCE_SERP`, envie `site` e `query` no lugar de `prompt`, com `limit` opcional (1 a 40); veja [Commerce Search](/pt/engines/commerce-serp.md). `read_product` recebe `url` e, opcionalmente, `country` e `idempotencyKey`; veja [Commerce Product](/pt/engines/commerce-product.md). `run_product_lookup` recebe `product`, `country` e, opcionalmente, `competitors`, `prompts`, `engines` e `idempotencyKey`; veja [Product Lookup](/pt/research/product-lookup.md). Ela devolve um resumo: por produto, os mecanismos que o mostram, a faixa de preço, os 10 principais vendedores e sites citados e uma linha por mecanismo; por prompt de compra, os produtos que cada mecanismo mostrou ou citou pelo nome. Isso é cerca de um décimo da resposta completa. Passe `detail: "full"` para obter cada listagem, página citada e id de tarefa. ### Monitores GEO Cada ferramenta de monitor faz uma chamada à API com a sua chave, então propriedade, escopo da chave e limites do plano valem como no REST. Veja [Monitoramento GEO](/pt/monitors.md). | Ferramenta | O que faz | Créditos | | - | - | - | | `get_monitor_capabilities` | Mecanismos de monitor, créditos por tarefa, limites e definições das métricas. Chame antes de configurar um monitor. | Grátis | | `list_monitors` | Seus monitores, com consolidados de 30 dias. | Grátis | | `get_monitor` | A visão de detalhe legada de um monitor. | Grátis | | `create_monitor` | Cria um monitor e inicia a primeira execução. Cada execução envia uma tarefa por prompt, ponto e amostra em cada mecanismo. | Por execução; veja [Custo e agenda](/pt/monitors.md#custo-e-agenda) | | `update_monitor` | Altera campos, ou pausa e retoma com `enabled`. | Grátis; mais prompts ou mecanismos aumentam o custo de cada execução | | `delete_monitor` | Exclui um monitor e seu histórico de pontuação. Não pode ser desfeito. | Grátis | | `run_monitor` | Inicia uma execução agora. | As tarefas de uma execução, cobradas como uma execução agendada | | `get_monitor_analytics` | Taxas de menção e citação, comparação entre períodos, share of voice, linhas por mecanismo e por prompt. | Grátis | | `get_monitor_sources` | Domínios ou páginas citados, paginados com `nextCursor`. | Grátis | | `get_monitor_results` | Linhas pontuadas, com texto da resposta e fontes quando `includeEvidence` é true. | Grátis | | `get_monitor_answer` | O Markdown, as fontes e o contexto de pontuação de uma resposta. | Grátis | | `suggest_monitor_prompts` | Rascunha ideias de prompts a partir de informações da marca. Nada é salvo. | Grátis; 30 chamadas por hora, uma a cada 20 segundos | | `get_monitor_alerts` | Histórico de alertas e se o alerta está armado. | Grátis | | `test_monitor_alert` | Envia um e-mail de alerta de teste. Limitado a 3 por monitor a cada 5 minutos (`429 RATE_LIMITED`). | Grátis | ## Timeouts `run_prompt`, `scrape_page`, `read_product` e `research_prompts` fazem polling até a tarefa terminar. Elas esperam `timeoutSeconds` (padrão 180, máximo 900). Se a tarefa ainda estiver em execução, a ferramenta retorna um erro `TASK_TIMEOUT` com o `taskId`. A tarefa continua sendo executada; chame `get_task` com esse id para coletá-la. `run_product_lookup` faz polling da consulta da mesma forma. Ela espera 210 segundos por padrão para terminar dentro de um timeout de cliente de 240 segundos, e a maioria das consultas termina em 2 a 3 minutos. Se a consulta ainda estiver em execução, a ferramenta devolve um erro `LOOKUP_TIMEOUT` com o `lookupId`; chame `get_product_lookup` com esse id. Configure o timeout de ferramentas do seu cliente acima de `timeoutSeconds`. O exemplo do Codex usa `tool_timeout_sec = 240` para o padrão de 180 segundos. Se o seu cliente só permite chamadas de ferramenta curtas, use `submit_prompt` e depois `get_task`. ## Erros Os erros de ferramenta voltam como JSON no resultado da ferramenta: | Código | Significado | | - | - | | Códigos de erro da API, como `KEY_SCOPE_DENIED` | A API rejeitou a chamada; o status e os detalhes vêm incluídos. Veja [Erros](/pt/concepts/errors.md). | | `VALIDATION_ERROR` | A entrada da ferramenta era inválida. | | `TASK_TIMEOUT` | A espera terminou antes de a tarefa terminar. Inclui `taskId`. | | `LOOKUP_TIMEOUT` | A espera terminou antes de todas as consultas do Product Lookup terminarem. Inclui `lookupId` e os mecanismos pendentes. | | `TASK_FAILED` | A tarefa falhou. Inclui `taskId` e o resultado da tarefa. | ## Cobrança Toda chamada de ferramenta é cobrada da conta dona da chave, pelos mesmos preços da API REST. As configurações da chave valem: um [escopo de mecanismos ou limite diário de créditos](/pt/authentication.md#configurações-da-chave) na chave limita o que o agente pode gastar. Dê a cada agente uma chave própria, com escopo e limite diário. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.