> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/mcp/pt/exoclick-mcp-tools.md). # Ferramentas disponíveis Uma vez ligado, o seu assistente de IA terá acesso às seguintes ferramentas. Não precisa de as chamar diretamente — basta colocar a sua pergunta em linguagem natural e a IA usará automaticamente a ferramenta adequada. ## O que uma ligação está autorizada a fazer Quando liga um cliente de IA, escolhe um nível de acesso para cada capacidade:
NívelSignificado
LeituraA IA pode visualizar estes dados.
EscritaA IA pode visualizar estes dados e fazer alterações.
Sem acessoA IA não pode usar esta capacidade de forma alguma.
Estas definições apenas restringem o que a IA pode fazer. Uma ligação nunca pode fazer mais do que a sua conta já permite. As capacidades que a sua conta não possui, e as capacidades que ainda não estão disponíveis, não são mostradas. Consulte [Ligação do Cliente de IA](/mcp/pt/exoclick-mcp-connecting-ai-client.md) para ver onde isto é definido. ## **Estatísticas** Veja dados de desempenho da sua conta, com filtragem e agrupamento flexíveis. Disponível para anunciantes e publicadores, cada um limitado aos seus próprios dados. **Acesso:** Leitura ### Estatísticas do anunciante Consulte as estatísticas do seu anunciante com opções flexíveis de filtragem e agrupamento. Esta ferramenta permite analisar impressões, cliques, conversões, receita, custos e outras métricas de desempenho em qualquer combinação de dimensões. #### O que pode perguntar * Desempenho da campanha num intervalo de datas * Detalhes por país, dispositivo, navegador, sistema operativo, zona ou qualquer outra dimensão disponível * Melhores ou piores desempenhos por qualquer métrica * Comparações entre períodos de tempo * Vistas filtradas (por exemplo, estatísticas de uma campanha ou zona específica) #### Exemplos de pedidos * *Dá-me as campanhas com melhor desempenho por gasto nos últimos 7 dias.* * *Qual é o meu eCPA por país este mês?* * *Compara as minhas impressões desta semana com as da semana passada, agrupadas por tipo de dispositivo.* * *Quais zonas tiveram o CR mais baixo ontem?* Consulte as estatísticas do seu anunciante com opções flexíveis de filtragem e agrupamento. Esta ferramenta permite analisar impressões, cliques, conversões, custos e outras métricas de desempenho em qualquer combinação de dimensões. ### Estatísticas do publicador Consulte as estatísticas do seu publicador com opções flexíveis de filtragem e agrupamento. Esta ferramenta permite analisar impressões, cliques, eCPM e outras métricas de desempenho em qualquer combinação de dimensões. #### O que pode perguntar * Desempenho da zona num intervalo de datas * Detalhes por país, dispositivo, navegador, sistema operativo, zona ou qualquer outra dimensão disponível * Melhores ou piores desempenhos por qualquer métrica * Comparações entre períodos de tempo * Vistas filtradas (por exemplo, estatísticas de uma campanha ou zona específica) #### Exemplos de pedidos * *Dá-me as zonas com maior receita nos últimos 7 dias.* * *Qual é o meu eCPM por país este mês?* * *Compara as minhas impressões desta semana com as da semana passada, agrupadas por tipo de dispositivo.* * *Quais zonas dentro do meu multi-formato tiveram os melhores resultados ontem?* ## Campanhas Veja a configuração da sua campanha sem sair da conversa Esta é uma ferramenta **apenas para anunciantes** . **Acesso:** Leitura ou Escrita ### Visualização #### **O que pode perguntar** * Uma lista das suas campanhas, filtrada por estado (em execução, em pausa) ou pesquisada por nome * A configuração completa de uma única campanha (se pedir uma campanha que não exista ou pertença a outra conta, a ferramenta devolve um erro claro de "não encontrado".) * Quantas campanhas tem num determinado estado * O lance mínimo para um formato e categoria num determinado país * Que opções de segmentação a sua conta pode usar Uma lista de campanhas devolve o id, o nome e o estado de cada campanha. Perguntar sobre uma campanha devolve a configuração completa, abrangendo: | Área | O que está incluído | | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Identidade | Nome, id, grupo de campanha, tipo de campanha, data de criação. | | Formato do anúncio | Tipo de anúncio e etiqueta, tamanho do criativo. | | Preços | Modelo de preços (CPM, CPC, etc.), preço, algoritmo de otimização, bidder associado. | | Orçamento e entrega | Limites de orçamento total e diário, montante gasto, limites de impressões, modo de entrega, limitação de frequência. | | Agendamento | Datas de início e fim, fuso horário, divisão por período do dia. | | Segmentação | Países e regiões, idiomas, navegadores, sistemas operativos, dispositivos, operadoras, ISPs, categorias, interesses, palavras-chave, intervalos de IP, sites, zonas, inventário RTB e listas de retargeting. Cada um é devolvido como uma lista segmentada e uma lista bloqueada. | | Regras de zona e rede | Se as zonas estão segmentadas ou bloqueadas, definições da rede de parceiros, etiquetas e categorias de produtos bloqueadas. | | Criativos | Cada variação com o respetivo URL de destino, URL de apresentação, oferta, estado e estado de aprovação, além de um total resumido de variações aprovadas, pendentes, rejeitadas e em pausa. | Quando um campo contém um id interno, a resposta também inclui o nome legível ao lado, para que a IA possa responder em linguagem simples em vez de ids brutos. #### **Exemplos de pedidos** * *Quantas campanhas ativas tenho?* * *Mostra-me todas as campanhas em pausa.* * *Lista as minhas campanhas no grupo 5, ordenadas por nome.* * *Tenho alguma campanha a segmentar a Alemanha?* Os resultados são paginados. Para contas com muitas campanhas, a IA tratará automaticamente da paginação ao longo de vários pedidos. ### Criação e atualização Disponível quando a ligação recebeu acesso de Escrita para esta capacidade. Sem isso, todas as escritas devolvem um erro de permissão. As ligações existentes mantêm-se apenas de leitura até voltar a ligá-las e definir Campanhas como Escrita. #### **O que pode perguntar:** * Criar uma campanha, incluindo o nome, tipo de anúncio, modelo de preços, lance, segmentação e criativos * Atualizar as definições e a segmentação de uma campanha, incluindo o intervalo de datas e a divisão por período do dia * Ativar ou pausar uma campanha * Adicionar ou atualizar variações criativas e ativá-las ou pausá-las individualmente * Copiar uma campanha, opcionalmente renomeando-a ou alterando o seu tipo de anúncio * Adicionar zonas a uma campanha ou remover zonas de uma campanha O LLM apenas disponibiliza os tipos de anúncio, categorias, modelos de preços e opções de segmentação disponíveis para a sua conta. #### **Exemplos de pedidos:** * *Cria uma campanha de banner CPM chamada Summer Sale, a segmentar Espanha, com lance de 0,50.* * *Adiciona uma variação 300x250 à campanha X a apontar para example.com.* * *Aumenta o lance da campanha X para 0,80.* * *Pausa as variações da campanha X.* * *Copia a campanha X e segmenta zonas em vez disso.* * Segmentar zonas X e/ou Bloquear zona X Cada alteração é resumida antes de ser aplicada, por isso nada é escrito até confirmar. #### **O que esperar** | Situação | Comportamento | | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Uma campanha nova | Criada em pausa, a menos que peça para a colocar em execução. | | Uma campanha copiada | Mantém o estado da campanha original. | | Criativos | Use ativos já existentes na sua biblioteca de multimédia, referenciados por id ou por nome. Se um nome corresponder a mais do que um ativo, ser-lhe-á perguntado qual deles e nada será alterado. | | Lances e orçamentos | Definidos na moeda da sua conta. Lances abaixo do preço mínimo para o país e formato são rejeitados. | | Formatos não disponíveis para si | Não podem ser usados tipos de anúncio e definições reservados a administradores, ou desativados na sua rede. | | Ainda não suportado | Carregamento de ativos, campanhas Smart Bid e Dynamic CPA, arquivamento, retargeting comportamental, segmentação por interesses e segmentação personalizada específica da rede. | ## Sites e Zonas Explore os seus sites e zonas de anúncios de forma conversacional, liste-os, filtre-os e pesquise-os, e aprofunde a configuração de qualquer site ou zona individual, incluindo as etiquetas e categorias de produtos que uma zona bloqueia. Esta é uma ferramenta **apenas para publicadores** . **Acesso:** Leitura ou Escrita ### Visualização * Uma lista dos seus sites ou zonas, filtrada por estado, tipos de site ou tipo de anúncio, ou pesquisada por nome * As zonas pertencentes a um determinado site * A configuração completa de um único site ou zona * Quais das suas zonas estão ativas **Perguntar sobre um site devolve:** | Área | O que está incluído | | ------------- | --------------------------------------------------- | | Identidade | Nome, id, URL, descrição. | | Classificação | Tipo de site (website, aplicação, etc.), categoria. | | Estado | Estado ativo e estado de aprovação. | **Perguntar sobre uma zona devolve uma configuração muito mais completa, abrangendo:** | Área | O que está incluído | | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | Identidade | Nome, id, id do site pai e nome. | | Formato | Tipo de anúncio e etiqueta do publicador, tamanho, se a zona é responsiva e, para zonas multi-formato, as zonas filhas e respetivos layouts. | | Preços | CPM mínimo, tipo de piso (suave ou rígido), modelos de preços. | | Controlos de entrega | Limitação de frequência, limitação de impressões, taxa de atualização de anúncios, restrições do navegador, anúncios de recurso. | | Aspeto | Posição fixa, borda e cor, cores do texto, fonte, definição de miniatura. | | Vídeo | Definições de pre-roll, mid-roll e post-roll, configuração VAST, suporte a wrapper VAST, VMAP, sobreposição CTA, tempo de salto. | | Definições de pop-up | Método de acionamento, classes de acionamento, atraso, recurso, comportamento em novo separador. | | Bloqueio | Etiquetas que o publicador bloqueia, categorias de produtos bloqueadas, regras de conformidade. | | Categoria | Categoria principal e subcategoria. | | Sinalizadores | Estado ativo, acompanhamento de inventário, nível de certificação, bid shading, BURL, diálogo de transparência publicitária. | Quando um campo contém um id interno, a resposta também inclui o nome legível ao lado, para que a IA possa responder em linguagem simples em vez de ids brutos. Os resultados são paginados, por isso as contas grandes são devolvidas em lotes em vez de tudo de uma vez. #### **Exemplos de pedidos** * *Quais das minhas zonas estão ativas?* * *Qual é a configuração no site X?* * *Lista todas as zonas no meu site X.* * *Quais das minhas zonas têm um piso de CPM definido?* * *Mostra-me as etiquetas bloqueadas na zona X.* * *Lista os meus sites que ainda aguardam aprovação.* ### **Criação e atualização** Disponível quando a ligação recebeu acesso de Escrita para esta capacidade. Sem isso, todas as escritas devolvem um erro de permissão. As ligações autorizadas antes de os níveis de acesso serem introduzidos são apenas de leitura até voltar a ligá-las. #### **O que pode perguntar:** * Criar um site * Criar uma zona de qualquer tipo de anúncio suportado, incluindo RTB, widget nativo, VAST em vídeo, web push, in-page push e multi-formato * Atualizar o nome, descrição ou categoria de um site * Atualizar as definições de uma zona ou movê-la para um site diferente #### **Exemplos de pedidos:** * *Criar um novo site para example.com na categoria Entretenimento.* * *Adiciona uma zona de banner, 300x250, ao meu site X.* * *Renomeia a zona 1234567 para Topo da Página Inicial.* * *Move a zona 1234567 para o meu outro site.* Cada alteração é resumida antes de ser aplicada, por isso nada é escrito até confirmar. #### **O que esperar** | Situação | Comportamento | | -------------------------------- | --------------------------------------------------------------------------------------------------------- | | Um novo site | Pode ser devolvido como não verificado, caso em que a verificação é concluída no painel de administração. | | Alterar a categoria de um site | Devolve o site ao estado de aprovação pendente. | | O URL e o tipo de um site | Definidos na criação e não podem ser alterados depois. | | O tipo de anúncio de uma zona | Definidos na criação e não podem ser alterados depois. | | Zonas de banner e banner móvel | Exigem um tamanho. | | Zonas RTB | Exigem um parceiro de ad exchange e não têm tamanho. | | Formatos não disponíveis para si | Formatos reservados a administradores, ou desativados na sua rede, não podem ser criados. | ## **Referência: ferramentas por capacidade** Se o seu cliente de IA mostrar nomes brutos de ferramentas, esta é a lista completa. | Ferramenta | Capacidade | Acesso | | ----------------------------------- | ------------------------- | ----------------- | | get\_advertiser\_global\_statistics | Estatísticas (anunciante) | Leitura | | get\_publisher\_global\_statistics | Estatísticas (publicador) | Leitura | | get\_campaigns | Campanhas | Leitura | | get\_campaign | Campanhas | Leitura | | get\_campaign\_groups | Campanhas | Leitura | | get\_zone\_targeting\_options | Campanhas | Leitura | | get\_minimum\_prices | Campanhas | Leitura | | create\_campaign | Campanhas | Escrita | | update\_campaign | Campanhas | Escrita | | copy\_campaign | Campanhas | Escrita | | add\_campaign\_variation | Campanhas | Escrita | | play\_campaign\_variations | Campanhas | Escrita | | pause\_campaign\_variations | Campanhas | Escrita | | add\_campaign\_zones | Campanhas | Escrita | | remove\_campaign\_zones | Campanhas | Escrita | | get\_sites | Sites e zonas | Leitura | | get\_site | Sites e zonas | Leitura | | get\_zones | Sites e zonas | Leitura | | get\_zone | Sites e zonas | Leitura | | create\_site | Sites e zonas | Escrita | | update\_site | Sites e zonas | Escrita | | create\_zone | Sites e zonas | Escrita | | update\_zone | Sites e zonas | Escrita | | get\_collection | Suporte | Sempre disponível | ## Repositório público de competências Juntamente com o Servidor MCP, o ExoClick tem acesso a um [**repositório público de competências pré-construídas**](https://github.com/EXADS/ai-skills), que são prompts e fluxos de trabalho otimizados, concebidos para tarefas publicitárias comuns. Estas competências dão-lhe uma vantagem inicial com abordagens comprovadas para tarefas como análise diária de desempenho, revisões de otimização de campanhas e relatórios. | Competência | O que faz | | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | daily-top-campaigns | Mostra as suas campanhas de anunciante com melhor desempenho para um único dia. | | statistics-analysis | Analisa o desempenho do anunciante ao longo de um intervalo de datas e compara-o com uma janela anterior. | | fetch-advertiser-statistics | Obtém estatísticas do anunciante por quaisquer dimensões suportadas, utilizável isoladamente ou como bloco de construção para outras competências. | | fetch-publisher-statistics | Obtém estatísticas do publicador por quaisquer dimensões suportadas. | As competências são totalmente opcionais. O Servidor MCP funciona com qualquer pedido ou pergunta que escreva por si. O repositório de competências existe simplesmente para o ajudar a começar mais depressa e beneficiar de fluxos de trabalho que foram testados e refinados pela equipa da ExoClick. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.exoclick.com/mcp/pt/exoclick-mcp-tools.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.