Como funciona

O AdsGPT chega ao seu agente de IA de duas formas. Ambas se comunicam com o mesmo servidor e atuam com a mesma conta.

	Servidor MCP	Plugin
O que é	Um servidor MCP remoto em `https://mcp.adsgpt.dev`	O servidor MCP mais as skills do AdsGPT, empacotados para cada cliente
Onde funciona	Qualquer cliente compatível com servidores MCP remotos com OAuth	Claude, Claude Code, Codex e Grok
O que o modelo recebe	As ferramentas	As ferramentas e as skills

O servidor MCP

O servidor expõe as ferramentas do AdsGPT: listar suas contas, gerar relatórios e consultas sobre elas, alterar orçamentos e status e planejar e lançar campanhas. Ele roda na nuvem, então nada é executado na sua máquina.

Ele oferece as ferramentas das plataformas que sua organização conectou: as ferramentas google_ads_* aparecem somente quando o Google Ads está conectado.

O plugin e suas skills

Skills são instruções que o modelo lê quando uma tarefa precisa delas: como planejar uma campanha passo a passo, como escrever anúncios dentro dos limites de cada formato, como revisar os gastos e as regras de cada plataforma e tipo de campanha. Com elas, o modelo faz as perguntas certas e acerta as campanhas na primeira tentativa.

O plugin contém apenas as skills, que são texto, o endereço do servidor e um manifesto para cada cliente. Ele não tem scripts, hooks nem binários.

Seu agente faz login no AdsGPT com OAuth 2.1, o padrão que os clientes MCP usam. Não há chaves de API para copiar:

Na primeira vez que o agente chama o AdsGPT, o servidor responde que precisa de autorização.
O agente abre a página de login do AdsGPT no seu navegador.
Você faz login, escolhe a organização em que o agente vai trabalhar e aprova o acesso.
O agente guarda o token e o renova por conta própria.

Primeiro, o agente solicita ads:read, que permite ler. Na primeira vez que uma ferramenta altera algo, ele também solicita ads:write. Você pode revogar o acesso de um agente no AdsGPT a qualquer momento.

Aprovações

Cada ferramenta do AdsGPT declara se apenas lê ou se altera algo, e seu agente usa isso para decidir quando perguntar a você:

Leituras, como relatórios e consultas, são executadas sem perguntar na maioria dos clientes.
Alterações, como um orçamento, um status ou um lançamento, sempre pedem a sua aprovação antes. Seu agente informa o que está prestes a alterar, com os valores atuais e os novos.

Uma nova campanha é um plano, salvo com save_blueprint e verificado com cada plataforma. Você aprova o plano inteiro uma única vez, com launch_blueprint, e suas campanhas são lançadas pausadas, a menos que você peça o contrário.

O que o AdsGPT recebe

O servidor recebe as chamadas que seu agente faz às ferramentas, com suas entradas, como uma conta, uma consulta, um plano de campanha ou textos de anúncios. Ele nunca recebe a sua conversa. Segurança e privacidade traz os detalhes.