Ligar o Claude à Google Ads, sem chave e sem código

A primeira versão do conector pedia-lhe que criasse uma chave de leitura na SaveAds e a colasse depois no endereço do conector. Funcionava, mas obrigava um anunciante a lidar com um segredo: copiá-lo no momento certo, perceber que viajava dentro de um URL, criar outro se se perdesse. E um endereço que leva uma chave acaba, mais cedo ou mais tarde, num histórico do navegador ou numa captura de ecrã.

O Claude sabe agora executar o fluxo OAuth definido pelo protocolo MCP, e a SaveAds acompanhou. Cola o endereço sem mais nada; o Claude descobre sozinho que é precisa uma aprovação, e é a si que ela é pedida, numa janela SaveAds. Já não há nada para copiar, nem nada para perder.

Os conectores já configurados com uma chave continuam a funcionar. Para passar à aprovação, remova o conector antigo no Claude, adicione-o de novo e revogue depois a chave de que já não precisa. O ChatGPT, cujos conectores personalizados nem sempre oferecem OAuth, pode ainda exigir uma.

Três condições. Quando o Claude diz que «não vê nada», é quase sempre a segunda que falta.

• Uma conta Google Ads ligada à SaveAds — através da autorização Google habitual, revogável na sua conta Google. O Claude não se liga à Google Ads: liga-se à SaveAds, que lê a Google Ads.
• Dados já sincronizados — os números vêm dos dados que a SaveAds já importou, e não de uma chamada em direto à Google. Uma conta ligada há cinco minutos pode ainda não ter uma única linha.
• Uma subscrição do Claude que permita conectores personalizados — depende do seu plano Anthropic e, numa empresa, das definições do seu administrador. Do lado da SaveAds, o conector está aberto em todos os planos, incluindo o Gratuito.

Um servidor MCP não dá «acesso à conta»: expõe ferramentas concretas, cada uma com os seus parâmetros e os seus limites. Eis a lista completa, com os nomes que o Claude mostra quando as chama.

• list_ad_accounts — as contas ligadas em todas as plataformas, com a respetiva moeda e estado. O Claude começa aqui para nunca inventar um nome de conta.
• get_performance — despesa, cliques, impressões, conversões e custo por aquisição num período, dia a dia, com o total da carteira e a repartição por conta.
• list_campaigns — as campanhas, da que mais gasta para a que menos gasta, com orçamento, CPC máximo, conversões e estado.
• list_search_terms — as pesquisas que as pessoas escreveram de facto, com o seu custo e as suas conversões. Só na Google Ads: as outras plataformas não expõem estes dados.
• list_recommendations — as recomendações da SaveAds, o seu grau de confiança, e o que foi aceite, aplicado ou rejeitado.
• list_optimizations — o registo das alterações realmente feitas — orçamento, licitação, palavra-chave negativa, pausa — com a data, o autor e o motivo.
• search — uma pesquisa em todo o espaço de trabalho: nomes de contas, nomes de campanhas, termos de pesquisa, recomendações.
• fetch — o detalhe completo de um resultado encontrado com search.

Um conector adicionado em claude.ai pertence à sua conta Claude, e não ao seu navegador: volta a encontrá-lo na aplicação para computador e no telemóvel, sem repetir a configuração.

No Claude Code, o assistente de linha de comandos, o mesmo endereço adiciona-se com um único comando: claude mcp add --transport http saveads https://save-ads.com/api/mcp. O comando /mcp lança depois a mesma aprovação, no navegador. É a opção certa se gera os seus relatórios por script ou os guarda num repositório.

Em todo o lado, é o mesmo servidor, as mesmas oito ferramentas e a mesma aprovação, que retira com um clique.

Cada chamada a uma ferramenta consome um pedido da sua reserva mensal de IA da SaveAds — a mesma reserva do assistente integrado e das análises. Por isso, o que conta não é a pergunta, mas o número de ferramentas que o Claude chama para lhe responder.

Uma auditoria completa passa normalmente por seis ferramentas: contas, desempenho, campanhas, termos de pesquisa, recomendações e registo de alterações. Conte com pelo menos seis pedidos, mais se o Claude explorar o espaço de trabalho com search e fetch. Uma pergunta pontual, como «quanto gastei na semana passada?», custa um ou dois.

Dois hábitos evitam esgotar a reserva: juntar as perguntas numa só mensagem, e pedir ao Claude que anuncie as ferramentas que tenciona chamar antes de o fazer. Cada resposta do servidor indica também quanto resta, e o Claude tem instruções para o avisar antes de chegar a zero.

O histórico segue a mesma regra. Se pedir doze meses e o seu plano cobrir três, a resposta assinala-o, e o Claude tem de lho dizer em vez de apresentar três meses como um ano.

O Claude rende mais em tarefas longas, que encadeiam várias leituras e pedem um raciocínio coerente do princípio ao fim. Os pedidos que melhor funcionam dão-lhe uma ordem de trabalho e um resultado preciso.

• A auditoria por etapas — «Audita a minha conta Google Ads nos últimos trinta dias: primeiro o acompanhamento de conversões, depois a despesa desperdiçada, depois os orçamentos. Quantifica cada constatação.»
• A caça ao desperdício — «Lista os termos de pesquisa que custam dinheiro sem converter, agrupa-os por intenção e sugere palavras-chave negativas.»
• A investigação — «O meu custo por conversão disparou a meio de agosto: cruza a curva diária com o registo de alterações e diz-me o que mudou nesse dia.»
• A segunda opinião — «Aqui estão as recomendações pendentes: quais te parecem discutíveis, e que dados faltam para decidir?»
• O relatório para o cliente — «Escreve uma nota de uma página para um diretor não técnico: o que funcionou, o que custou dinheiro, o que mudamos no próximo mês.»

O Claude não recebe a sua palavra-passe da Google nem o token que permite à SaveAds ler a Google Ads. Fala apenas com o servidor MCP da SaveAds, com um token que só serve para uma coisa: ler a sua conta.

Do lado da SaveAds, nenhum token é guardado em claro: a base de dados conserva apenas a sua impressão digital. A troca de aprovação é protegida por PKCE, e o token de acesso expira ao fim de uma hora — o Claude renova-o sozinho enquanto a aprovação existir.

A sua subscrição é verificada a cada pedido. Se um pagamento falhar, o Claude não fica sem resposta: recebe uma mensagem que explica a causa, com a ligação para a faturação, e transmite-lha. O acesso é retomado assim que a subscrição estiver regularizada.

Para cortar tudo, abra o separador Claude / GPT na SaveAds e retire a aprovação: o acesso termina em menos de um minuto, seja qual for a conversa em curso.

As mensagens de erro do servidor estão escritas para serem lidas pelo Claude, que lhas transmite. Os cinco casos mais frequentes:

• Nenhuma conta encontrada — a Google Ads ainda não está ligada à SaveAds, ou a primeira sincronização ainda não terminou.
• Um erro de autenticação ao adicionar — as definições de autenticação do conector foram alteradas. Deixe-as como estão: o Claude deteta-as sozinho.
• Acesso desconhecido, expirado ou revogado — a aprovação foi retirada. Remova o conector no Claude e adicione-o de novo.
• Demasiados pedidos — um limite protege o servidor contra ciclos de chamadas. Espere um minuto e junte as suas perguntas.
• Um período mais curto do que o pedido — é a profundidade de histórico do seu plano, que a resposta assinala.