Ads Lighthouse MCP Server

Servidor MCP hospedado para monitoramento de anúncios pagos em buscas de marca, revisão de anunciantes e descobertas de afiliados, e acesso a relatórios salvos via OAuth 2.1.

Ver em adslighthouse.comExperimente este MCPPatrocinado

Servidor MCP hospedado

npx add-mcp 'https://adslighthouse.com/api/v1/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Servidor MCP do Ads Lighthouse

URL do servidor

https://adslighthouse.com/api/v1/mcp

HTTP Streamable. Entre com sua conta do Ads Lighthouse (OAuth 2.1 com PKCE). Nos planos Scale ou superiores, você também pode enviar uma chave de API como bearer token.

O servidor MCP está incluído em todos os planos, inclusive nos testes gratuitos.

O que é

O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA chamem ferramentas. Nosso servidor hospedado dá a um assistente os mesmos dados da API: projetos, palavras-chave, verificações salvas com seus anúncios, anunciantes, descobertas de afiliados, alertas e uso.

Experimente perguntas como: Quem anunciou em nossos termos de marca nos EUA na semana passada? Quais anunciantes usam nossos IDs de afiliado? Algo mudou no mobile desde segunda-feira?

Conecte seu assistente

Claude

No Claude, abra Configurações > Conectores e escolha Adicionar conector personalizado.
Cole a URL do servidor e adicione-a.
Escolha Conectar, entre no Ads Lighthouse e aprove o acesso para sua conta.

ChatGPT

No ChatGPT, ative o modo de desenvolvedor em Configurações > Apps e Conectores > Configurações avançadas.
Crie um conector com a URL do servidor e escolha OAuth como autenticação.
Entre no Ads Lighthouse e aprove o acesso. Os nomes dos menus podem mudar; siga a ajuda do ChatGPT se eles forem diferentes.

Claude Code

Adicione o servidor pelo seu terminal e execute /mcp no Claude Code e escolha Autenticar.

Claude Code

claude mcp add --transport http ads-lighthouse https://adslighthouse.com/api/v1/mcp

VS Code e GitHub Copilot

Adicione o servidor ao .vscode/mcp.json no seu workspace ou à sua configuração de usuário.
Inicie-o pelo arquivo e faça login quando o VS Code solicitar.

VS Code e GitHub Copilot

{
  "servers": {
    "ads-lighthouse": {
      "type": "http",
      "url": "https://adslighthouse.com/api/v1/mcp"
    }
  }
}

Gemini CLI

Adicione o servidor ao ~/.gemini/settings.json e execute /mcp auth ads-lighthouse para entrar.

Gemini CLI

{
  "mcpServers": {
    "ads-lighthouse": {
      "httpUrl": "https://adslighthouse.com/api/v1/mcp"
    }
  }
}

Cursor

Adicione o servidor ao ~/.cursor/mcp.json ou ao .cursor/mcp.json em um projeto.
Nas configurações de MCP do Cursor, escolha Conectar ao lado de ads-lighthouse, entre no Ads Lighthouse e aprove o acesso para sua conta. Isso funciona em todos os planos.

Cursor

{
  "mcpServers": {
    "ads-lighthouse": {
      "url": "https://adslighthouse.com/api/v1/mcp"
    }
  }
}

Use uma chave de API em vez de fazer login

Nos planos Scale ou superiores, qualquer cliente que possa enviar cabeçalhos pode usar uma chave de API: envie Authorization: Bearer als_your_key com cada solicitação. Uma chave atua para toda a conta; crie uma chave somente leitura, a menos que o assistente precise fazer alterações. Em outros planos, conecte-se fazendo login.

API do Ads Lighthouse

Ferramentas

Toda ferramenta que aceita project_id aceita o ID do projeto, o domínio da marca ou o nome exato do projeto ou da marca. Ferramentas que alteram dados precisam de acesso de escrita, e o assistente deve pedir sua permissão antes de usá-las.

Ferramenta	O que faz	Acesso
`get_account`	Plano, cotas mensais, uso e limite de taxa	Leitura
`list_projects`	Projetos na conta	Leitura
`get_project_details`	Configuração e cobertura de dados de um projeto	Leitura
`create_project`	Criar um projeto e iniciar suas primeiras verificações	Escrita, usa verificações
`list_keywords`	Palavras-chave monitoradas com verificações salvas e anúncios em um período	Leitura
`add_keywords`	Adicionar palavras-chave a um projeto	Escrita
`remove_keyword`	Parar de monitorar uma palavra-chave	Escrita
`list_observations`	Verificações salvas com os anúncios pagos encontrados	Leitura
`list_advertisers`	Domínios de anunciantes com visibilidade e sinais	Leitura
`list_affiliate_findings`	Seus IDs de afiliado vistos em anúncios que usam sua marca	Leitura
`list_alert_events`	Alertas disparados para a conta	Leitura
`run_realtime_check`	Iniciar uma verificação sob demanda das palavras-chave de um projeto	Escrita, usa verificações
`get_check_status`	Progresso de uma verificação sob demanda	Leitura
`get_summary`	Números principais de um projeto e período	Leitura
`get_timeseries`	Verificações, anúncios e anunciantes por dia, semana ou mês local	Leitura
`get_advertiser`	Métricas, categoria e anúncios salvos de um anunciante	Leitura
`list_competitors`	Outros anunciantes classificados por ocorrências de anúncios, com suas categorias	Leitura
`set_advertiser_classification`	Salvar a categoria da sua equipe para um domínio de anunciante	Escrita
`get_keyword_report`	Verificações salvas, anúncios e anunciantes de uma palavra-chave em um período	Leitura
`list_keyword_ads`	Anunciantes ou anúncios distintos vistos para uma palavra-chave	Leitura
`list_affiliate_ids`	Seus IDs de afiliado vistos em URLs de anúncios salvos	Leitura
`set_affiliate_case_status`	Definir o status de revisão de um ID de afiliado não conforme	Escrita
`list_shopping_products`	Listagens de produtos patrocinados vistas em capturas do Google Shopping	Leitura
`export_paid_results`	As linhas da exportação CSV de resultados pagos, como JSON	Leitura
`export_paid_results_by_keyword`	As linhas da visualização Resultados pagos por palavra-chave, como JSON	Leitura
`export_affiliate_cases`	As linhas da exportação CSV de afiliados não conformes, como JSON	Leitura
`get_advertiser_history`	Quando e onde um anunciante apareceu, com o cronograma de observação	Leitura
`get_advertiser_heatmap`	Presença por hora local e dia da semana	Leitura
`list_ad_copy_versions`	Textos de anúncios distintos de um anunciante, do mais recente ao mais antigo	Leitura
`list_ad_copy_changes`	Alterações recentes em textos de anúncios entre anunciantes	Leitura
`update_project`	Alterar o plano de monitoramento, a marca ou as configurações de afiliados de um projeto	Escrita
`delete_project`	Excluir permanentemente um projeto e seus dados salvos	Escrita
`remove_keywords`	Parar de monitorar várias palavras-chave	Escrita
`preview_check_demand`	Prever as verificações mensais e a cota para uma alteração proposta	Leitura
`get_monitoring_options`	Mercados, mecanismos de busca, dispositivos e cronogramas que você pode configurar	Leitura
`search_locations`	Encontrar cidades e regiões disponíveis para monitoramento em um mercado	Leitura
`list_check_activity`	Atividade recente em segundo plano e pesquisas na fila de um projeto	Leitura
`get_time_zone`	Sua preferência pessoal de fuso horário	Leitura
`update_time_zone`	Alterar sua preferência pessoal de fuso horário	Escrita
`get_theme`	Sua preferência pessoal de aparência	Leitura
`update_theme`	Alterar sua preferência pessoal de aparência	Escrita
`list_alert_rules`	Regras de alerta configuradas na conta	Leitura
`get_alert_rule`	Uma regra de alerta	Leitura
`create_alert_rule`	Criar uma regra de alerta (email, Slack ou webhook)	Escrita
`update_alert_rule`	Ativar, desativar ou alterar uma regra de alerta	Escrita
`delete_alert_rule`	Excluir uma regra de alerta e seu histórico de alertas	Escrita
`send_test_alert`	Enfileirar um alerta sintético pelo canal de uma regra	Escrita
`rotate_webhook_secret`	Substituir o segredo de assinatura de uma regra de webhook	Escrita
`get_alert_event`	Um alerta com seu registro de entrega	Leitura
`list_team`	Membros, funções e convites abertos	Leitura
`invite_team_member`	Enviar por email um convite para entrar na conta	Escrita, usa verificações
`resend_invitation`	Reenviar um convite aberto com um novo link	Escrita, usa verificações
`cancel_invitation`	Revogar um convite aberto	Escrita
`change_member_role`	Tornar um membro administrador ou um administrador membro	Escrita
`remove_team_member`	Remover uma pessoa da conta	Escrita
`list_accounts`	A conta que esta credencial pode usar	Leitura
`get_account_overview`	Limites do plano, datas de assinatura, medidores e previsão	Leitura
`get_email_preferences`	Suas preferências de email de produto e newsletter	Leitura
`update_email_preferences`	Ativar ou desativar emails de produto ou a newsletter	Escrita
`list_google_connections`	Suas conexões do Google Ads e Search Console em um projeto	Leitura
`list_google_accounts`	Clientes do Google Ads ou sites do Search Console que uma conexão pode ler	Leitura
`run_google_ads_report`	Desempenho de palavras-chave ou termos de pesquisa do Google Ads	Leitura
`run_search_console_report`	Cliques, impressões, CTR e posição do Search Console	Leitura
`trace_redirects`	Enfileirar um rastreamento no servidor de um destino de anúncio salvo	Escrita, usa verificações
`get_redirect_chain`	Uma cadeia de redirecionamento rastreada	Leitura
`list_redirect_chains`	Cadeias de redirecionamento rastreadas de um projeto	Leitura
`list_policy_rules`	Regras de política de um projeto	Leitura
`get_policy_rule`	Uma regra de política	Leitura
`create_policy_rule`	Declarar uma regra de política para um projeto	Escrita
`update_policy_rule`	Renomear, pausar, reconfigurar ou redefinir o escopo de uma regra de política	Escrita
`delete_policy_rule`	Excluir uma regra de política e manter seus casos	Escrita
`preview_policy_rule`	O que uma regra de rascunho corresponderia, sem salvá-la	Leitura
`evaluate_policy_rules`	Verificar anúncios salvos em relação às regras ativadas e registrar casos	Escrita
`list_policy_cases`	Casos abertos por regras de política	Leitura
`get_policy_case`	Um caso com sua linha do tempo	Leitura
`list_policy_case_evidence`	Os anúncios salvos que corresponderam à regra de um caso	Leitura
`update_policy_case`	Alterar o status ou o responsável de um caso	Escrita
`add_policy_case_note`	Adicionar uma nota à linha do tempo de um caso	Escrita
`create_report`	Solicitar um relatório PDF de projeto para um período e filtros	Escrita
`list_reports`	Relatórios PDF de um projeto, do mais recente ao mais antigo	Leitura
`get_report_status`	Status de um relatório PDF	Leitura
`get_report_download_link`	Um link de curta duração para baixar um relatório pronto	Leitura

Segurança

Você escolhe a conta e se o assistente pode fazer alterações ao aprovar a conexão. Desconecte qualquer aplicativo em Configurações > API e MCP.
Os tokens de acesso expiram após uma hora e os tokens de atualização são rotacionados a cada uso. Um token de atualização reutilizado encerra a conexão.
O assistente age como você: se você sair da conta, ou se a conta não tiver mais um plano ativo ou teste gratuito, o acesso dele também termina.
Criar um projeto e iniciar uma verificação sob demanda usam a cota do seu plano e precisam de uma chave de idempotência, para que uma chamada repetida nunca execute as verificações duas vezes.
Assistentes podem interpretar dados incorretamente. Verifique descobertas importantes no aplicativo, onde cada observação mostra seu contexto completo.