Vibe Ads

Gerenciador de Google Ads com inteligência artificial para negócios de serviços locais. 37 categorias. Configuração em 5 minutos. $20/mês.

GitHub

Documentação

@vibeads/mcp

Fale com sua conta do Google Ads pelo Claude Desktop, Cursor ou qualquer cliente MCP.

Feito para negócios de serviços locais: 35 categorias, 32 delas com palavras-chave ajustadas, benchmarks de CPC e modelos de funil.

O servidor oficial do Model Context Protocol para VibeAds. Pergunte ao Claude coisas como "quais termos de pesquisa estão desperdiçando meu orçamento?" ou "qual é a minha pontuação de saúde da conta?" e receba respostas extraídas dos seus dados de campanha em tempo real.

Diferente dos servidores MCP genéricos para Google Ads, este é pré-ajustado para negócios de serviços locais e consolida mais de 35 regras de diagnóstico em uma única pontuação de saúde da conta de 0 a 100 em 6 dimensões. Nos planos Pro/Max, ele também pode elaborar estratégias de campanha, executar otimizações protegidas, adicionar grupos de anúncios e iniciar fluxos de publicação, sempre com aprovação humana para qualquer ação que envolva gastos.

Recursos

🎯 Foco em serviços locais — 27 verticais de serviços domésticos mais 8 de geração de leads profissionais; 32 delas têm sementes de palavras-chave próprias, benchmarks de CPC, segmentos de público e modelo de funil
📊 Pontuação de saúde da conta 0-100 — ponderada em 6 dimensões (Rastreamento, Palavras-chave, Orçamento, Criativos, Segmentação, Performance)
🔍 Detecção de desperdício em termos de pesquisa — encontra cada real gasto em termos sem conversão
💡 Consolidação de diagnósticos — mais de 35 regras do mecanismo de otimização da VibeAds, classificadas por gravidade
✍️ Ferramentas de escrita (Pro/Max) — elabore estratégias, aprove otimizações e inicie fluxos de publicação pelo gateway da VibeAds
🔒 Seguro por design — ferramentas de leitura não podem modificar nada; ferramentas de escrita operam dentro das proteções de segurança da VibeAds, e a publicação sempre exige aprovação humana no navegador
⚡ Sem necessidade de GAQL — faça perguntas em linguagem natural e receba respostas em markdown

Categorias suportadas

Serviços locais e domésticos (27): encanador · HVAC · eletricista · telhadista · diarista · paisagista · controle de pragas · pintor · faz-tudo · chaveiro · porta de garagem · conserto de eletrodomésticos · serviço de árvores · cercas · janelas e portas · carpete e piso · impermeabilização · lavagem de alta pressão · limpeza de dutos de ar e secadoras · limpeza comercial e zeladoria · serviços de piscina · remoção de entulho · mudanças · reparo automotivo · iluminação de Natal · dentista · advogado

Profissionais e geração de leads (8): imobiliária · seguros · serviços financeiros · educação · saúde · consultoria · SaaS · serviços B2B

Consultoria, SaaS e serviços B2B usam padrões genéricos, assim como qualquer outra categoria que você informar, em vez de uma base de conhecimento ajustada.

Instalação

Usando ChatGPT, Claude ou Meta AI? Você não precisa deste pacote nem de uma chave: adicione o servidor hospedado, https://getvibeads.com/api/mcp, no assistente e faça login na VibeAds quando solicitado. Passos para cada assistente: Conectar ChatGPT, Claude ou Meta AI. Este pacote é para clientes que executam ferramentas no seu computador, como Claude Code, Cursor e Cline.

Etapa 1 — Obtenha sua chave de API

Entre na sua conta VibeAds e gere uma chave de API:

→ Gerar chave de API

As chaves começam com vba_mcp_ e são vinculadas apenas à sua conta.

Etapa 2 — Configure seu cliente MCP

Claude Desktop

Abra seu arquivo de configuração:

SO	Caminho
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

Adicione isto ao bloco mcpServers:

{
  "mcpServers": {
    "vibeads": {
      "command": "npx",
      "args": ["-y", "@vibeads/mcp"],
      "env": {
        "VIBEADS_API_KEY": "vba_mcp_YOUR_KEY_HERE"
      }
    }
  }
}

Reinicie o Claude Desktop. Você deve ver as ferramentas da VibeAds aparecerem no menu de ferramentas 🔨.

Cursor

Abra Configurações → MCP
Clique em Adicionar servidor
Configure:
- Nome: vibeads
- Comando: npx -y @vibeads/mcp
- Variáveis de ambiente: VIBEADS_API_KEY=vba_mcp_YOUR_KEY_HERE

Cline / Claude Code / outros clientes MCP

Use a mesma configuração do Claude Desktop acima. A maioria dos clientes MCP segue o mesmo esquema.

Variáveis de ambiente

A configuração é uma única variável de ambiente — todas as ferramentas (leitura e escrita) passam pelo gateway seguro da VibeAds no lado do servidor com sua chave de API.

Variável	Obrigatória?	Finalidade
`VIBEADS_API_KEY`	✅ Obrigatória	Sua chave `vba_mcp_...`. Esta é a única credencial que qualquer ferramenta precisa.
`VIBEADS_SUPABASE_URL`	Opcional	Substitui a URL do backend da VibeAds. O padrão é o endpoint de produção.

Uso

Depois de configurado, você pode fazer perguntas ao Claude como:

📋 Descoberta de campanhas

"Mostre todas as minhas campanhas VibeAds"

"Quais campanhas estão pausadas?"

"Me dê as 5 campanhas criadas mais recentemente"

🔬 Análises detalhadas

"Me conte tudo sobre minha campanha de encanador em Austin"

"Como minha campanha de HVAC foi na semana passada?"

"Qual é o CPA da campanha abc12345?"

📈 Relatórios para qualquer período

"Compare setembro com agosto na minha campanha de encanamento em Austin"

"Gastos por dispositivo em toda a minha conta no mês passado"

"Quais palavras-chave gastaram mais nos últimos 90 dias?"

🔎 Pesquisa de palavras-chave

"Quantas pessoas pesquisam por limpeza de ralos em Austin, TX?"

"Encontre ideias de palavras-chave a partir da minha página de serviços para Round Rock e Pflugerville"

🧾 Auditoria de uma conta inteira do Google Ads

Funciona logo após conectar o Google Ads, antes de qualquer importação:

"Onde meu orçamento do Google Ads está sendo desperdiçado?"

"Audite minha conta do Google Ads"

📊 Saúde da conta

"Qual é a minha pontuação de saúde da conta VibeAds?"

"Qual dimensão está puxando minha pontuação para baixo?"

"Me dê a pontuação de saúde apenas para a campanha xyz"

💸 Análise de termos de pesquisa

"Quais termos de pesquisa estão desperdiçando meu orçamento?"

"Mostre as 10 principais palavras-chave vencedoras dos últimos 30 dias"

"Quanto estou gastando em termos com zero conversões?"

🩺 Diagnósticos + recomendações

"O que devo corrigir primeiro?"

"Mostre todos os diagnósticos críticos"

"O que há de errado com minha campanha de telhados?"

Ferramentas disponíveis

Ferramentas de leitura

Ferramenta	Finalidade
`list_campaigns`	Suas campanhas na VibeAds (publicadas, importadas e rascunhos) com status, orçamento e categoria. Campanhas que estão apenas na sua conta do Google Ads são listadas por `find_campaigns_to_import`
`get_campaign_details`	Análise detalhada de uma campanha: métricas, grupos de anúncios, segmentação, páginas de destino, diagnósticos
`get_account_health_score`	Pontuação de 0 a 100 + nota por letra em 6 dimensões, opcionalmente por campanha
`get_search_term_analysis`	Gastos desperdiçados + vencedores dos termos de pesquisa sincronizados mais recentes de cada campanha, que cobrem os 7 dias anteriores a essa sincronização (limiar de custo configurável)
`get_diagnostics`	Diagnósticos mais recentes de otimização do agente com gravidade + correção recomendada (até 50)
`find_campaigns_to_import`	Antes de importar: as campanhas da sua conta do Google Ads, lidas diretamente do Google Ads, cada uma marcada se está na VibeAds (a VibeAds gerencia apenas as campanhas que estão nela). Chamada de `list_google_ads_campaigns` na versão 0.2.15
`get_performance_report`	Números de uma campanha ou de toda a conta para um período que você escolher (um predefinido ou duas datas, até 90 dias), lidos ao vivo do Google Ads, opcionalmente por dia, dispositivo, hora, grupo de anúncios, palavra-chave ou localização. Valores na moeda da conta. A VibeAds constrói todas as consultas; o assistente apenas escolhe o período e o detalhamento
`audit_google_ads_account`	Uma auditoria de uma conta conectada do Google Ads, lida ao vivo do Google Ads: até 25 campanhas de Pesquisa nos últimos 30 dias, estejam ou não na VibeAds, com pontuação de saúde de 0 a 100 e nota para a conta e cada campanha, problemas agrupados por verificação com as correções de cada um no Google Ads, e os termos de pesquisa mais caros de cada campanha com cliques e sem conversões. Uma auditoria por conta é mantida por 24 horas
`list_keywords`	Grupos de anúncios, palavras-chave e palavras-chave negativas de uma campanha publicada, lidos ao vivo do Google Ads: tipo de correspondência, status, CPC máximo e 30 dias de cliques, custo e conversões
`research_keywords`	Ideias de palavras-chave do Planejador de Palavras-chave do Google para palavras-chave semente, uma página da web ou ambos, nos locais que você indicar: pesquisas médias mensais, concorrência e faixa de lance de topo de página. Pro/Max, 2 créditos (repetição em até 90 dias é gratuita)
`list_google_ads_accounts`	Todas as contas conectadas do Google Ads, ativadas ou não, com a conta de gerente (MCC) sob a qual cada conta de cliente está
`list_google_recommendations`	As próprias recomendações do Google para uma conta (a página de Recomendações), com a estimativa do Google e se cada uma pode ser aplicada pelo chat

As ferramentas de leitura são somente leitura: não podem criar, modificar, pausar ou excluir nada na sua conta do Google Ads. Elas são executadas no lado do servidor pelo gateway da VibeAds e precisam apenas de VIBEADS_API_KEY. As ferramentas de leitura funcionam em qualquer plano, incluindo o gratuito, exceto research_keywords, que exige Pro ou Max.

Ferramentas de escrita (Pro/Max)

As ferramentas de escrita falam com o gateway seguro da VibeAds no lado do servidor e precisam apenas de VIBEADS_API_KEY — sem chaves do Supabase. Cada chamada é limitada por taxa por chave, otimizações aprovadas são medidas posteriormente (alterações menores são revertidas automaticamente se as métricas piorarem), e a publicação sempre exige aprovação humana no navegador. A chave de API sozinha nunca pode gastar dinheiro.

Ferramenta	Finalidade
`generate_strategy`	Elaborar uma estratégia completa de campanha (palavras-chave, textos de anúncio, 3+ grupos de anúncios) no lado do servidor, com um grupo de anúncios de Marca para pesquisas pelo nome do seu negócio e, no Max, um grupo de anúncios para cada concorrente que você indicar. Custa 13 créditos. Apenas rascunho: nada é publicado, nenhum dinheiro é gasto
`get_strategy_status`	Consultar um job de estratégia: status, fase e grupos de anúncios elaborados quando concluído
`apply_strategy`	Transformar uma prévia concluída em uma campanha de rascunho real (grupos de anúncios, palavras-chave, segmentação, textos de anúncio, extensões). Custa 6 créditos + 3 por grupo de anúncios para geração de imagens. Apenas rascunho — não fica no ar, nenhum dinheiro de anúncios é gasto
`list_recommendations`	Recomendações de otimização pendentes, cada uma com a ferramenta e os argumentos exatos que a executam (com IDs de sessão e recomendação), ou um link para aprová-la na VibeAds quando nenhuma ferramenta faz essa alteração
`preview_ad_group`	Mostrar um novo grupo de anúncios (palavras-chave, três anúncios, plano de página de destino) antes de ser adicionado. Cria apenas uma prévia
`add_ad_group`	Adicionar um grupo de anúncios pré-visualizado. Em uma campanha publicada, ele começa a veicular imediatamente, dentro do orçamento da campanha
`request_publish`	Iniciar o fluxo de publicação de uma campanha que tem grupos de anúncios — retorna uma URL de aprovação humana porque publicar gasta dinheiro real. Com mais de uma conta do Google Ads, pergunta qual usar e publica apenas nela
`import_campaigns`	Trazer até 3 campanhas da sua conta do Google Ads para a VibeAds, para que o otimizador e os relatórios as cubram. Nada muda no Google Ads. 1 crédito cada
`pause_campaign`	Pausar uma campanha ativa no Google Ads
`resume_campaign`	Reativar uma campanha pausada. Reativar gasta dinheiro, então com uma chave de API retorna uma URL de aprovação humana, como na publicação
`add_negative_keywords`	Adicionar até 20 palavras-chave negativas a uma campanha ou a um grupo de anúncios, de uma vez. Uma que bloquearia as próprias palavras-chave da campanha é deixada de fora
`add_keywords`	Adicionar até 20 palavras-chave a um grupo de anúncios, de uma vez, no CPC máximo padrão do grupo
`set_keyword_status`	Pausar palavras-chave ou reativar as pausadas
`set_max_cpc`	Definir o CPC máximo de um grupo de anúncios, de uma palavra-chave ou de uma lista de palavras-chave em uma campanha de CPC manual. Até o dobro e US$ 50 por clique de uma vez; valores maiores retornam uma URL de aprovação
`set_daily_budget`	Definir o orçamento diário de uma campanha. Uma redução é executada imediatamente; com uma chave de API, qualquer aumento retorna uma URL de aprovação
`dismiss_google_recommendation`	Remover uma das recomendações do Google da lista. Nenhuma alteração na campanha
`check_approval`	Consultar uma publicação ou aprovação de alteração: pendente → aprovada → executando → executada (ou rejeitada / expirada / falhou)

Cada alteração de palavra-chave, lance, orçamento e reativação é listada na aba Otimizar da campanha na VibeAds, onde pode ser desfeita. A VibeAds nunca reverte essas alterações por conta própria. Um assistente pode fazer 20 alterações em uma campanha por dia.

Da ideia à campanha no ar:

generate_strategy elabora a estratégia no servidor e retorna um jobId. Nada existe ainda no Google Ads.
get_strategy_status consulta esse job até que ele reporte completed.
apply_strategy transforma a prévia finalizada em uma campanha rascunho real e retorna um campaignId. Ainda não está no ar, ainda não gasta nada.
request_publish pega esse campaignId e retorna um link de aprovação.
Você abre o link no navegador, revisa a campanha + orçamento e clica em Aprovar (ou Rejeitar).
check_approval reporta a aprovação e depois o job de publicação; a campanha fica no ar assim que esse job for concluído.

As etapas 1–3 criam linhas apenas no VibeAds e gastam créditos do VibeAds (13 para a etapa 1; 6 + 3 por grupo de anúncios para a etapa 3). A etapa 5 é o único ponto em que o dinheiro de anúncios é comprometido, e isso só pode acontecer no navegador — a chave de API sozinha nunca pode publicar.

Assistentes que você conecta fazendo login no VibeAds em vez de usar uma chave (como ChatGPT ou claude.ai, por meio do servidor hospedado em https://getvibeads.com/api/mcp) podem publicar uma campanha de Pesquisa sem o link quando você permitir até um orçamento diário, nas Configurações do VibeAds, em Aplicativos conectados. Eles confirmam o orçamento diário de cada campanha com você antes. Chaves de API nunca podem fazer isso, então uma chave vazada ainda não consegue gastar.

Segurança

As ferramentas de leitura são somente leitura. Elas não podem alterar suas campanhas, sua conta do Google Ads ou suas configurações do VibeAds.
As ferramentas de escrita são protegidas. Cada ação de escrita é executada no servidor por meio do gateway do VibeAds, com limite de taxa por chave. Otimizações aprovadas são medidas depois; alterações menores são revertidas automaticamente se as métricas piorarem; e a publicação sempre exige aprovação humana no navegador. A chave de API nunca pode aprovar gastos com anúncios sozinha.
As chaves são criptografadas com SHA-256 antes do armazenamento. A chave completa é mostrada apenas uma vez, na criação.
Revogável a qualquer momento em https://getvibeads.com/app/settings/mcp.
O uso é registrado por chave: timestamp do último uso e contagem de solicitações.
Isolamento em nível de linha — cada chave é limitada a um único usuário do VibeAds. As chaves não podem ver dados de outros usuários.
Expiração opcional — defina datas de expiração para chaves de contas de serviço / acesso temporário.

Para máxima segurança, rotacione sua chave de API sempre que um dispositivo mudar de mãos ou um contrato terminar.

Requisitos

Node.js ≥ 20 (para o runtime npx)
Conta VibeAds ativa: o plano gratuito é suficiente para gerar uma chave
Plano Pro ou Max: necessário para as ferramentas de escrita (as ferramentas de leitura funcionam em qualquer plano)
Pelo menos uma campanha publicada: os diagnósticos precisam de dados sincronizados do Google Ads

Comparação

	VibeAds MCP	GoMarble MCP	Google Ads MCP (oficial)
Tempo de configuração	2 min	15 min	30 min
OAuth necessário	❌ (somente chave de API)	✅	✅
Conhecimento de GAQL necessário	❌	✅	✅
Ajuste de serviço local	✅	❌	❌
Pontuação de saúde da conta	✅ 6 dimensões	❌	❌
Diagnósticos prontos	✅ 35+ regras	❌	❌
Multi-contas	✅	✅	✅
Ações de escrita protegidas	✅ publicação aprovada por humano	❌	❌

Quando usar o VibeAds MCP: Você administra um negócio de serviços local (ou gerencia anúncios para um) e quer insights pré-ajustados sem aprender GAQL.

Quando usar o GoMarble / Google Ads MCP: Você precisa executar consultas GAQL personalizadas ou trabalhar com campanhas que não são de serviços (e-commerce, SaaS B2B, etc.).

Os três podem coexistir — instale os que se encaixarem no seu fluxo de trabalho.

Solução de problemas

"Falha na autenticação"

Verifique se sua chave começa com vba_mcp_
Gere uma nova chave em https://getvibeads.com/app/settings/mcp
Verifique se a chave não foi revogada ou expirada

"Nenhum diagnóstico de otimizador ainda"

Os diagnósticos são gerados a cada 12 horas pelo agente do VibeAds, assim que o desempenho do Google Ads for sincronizado. Se você acabou de publicar uma campanha, aguarde até um dia para a primeira execução.

"Nenhum dado de termo de pesquisa encontrado"

A sincronização de termos de pesquisa é executada a cada 6 horas. Para campanhas novas, aguarde 24–48 horas para que dados significativos se acumulem.

O cliente MCP não encontra o servidor

Verifique se você tem o Node.js 20+ instalado: node --version. O Claude Desktop e o Cursor ambos usam npx, então o Node deve estar no seu PATH.

Contribuição

Este é um pacote MIT de código aberto. Issues e PRs são bem-vindos em: https://github.com/vibeads/mcp/issues