Synter Ads

oficial

Gerenciamento de campanhas publicitárias multiplataforma para agentes de IA no Google, Meta, LinkedIn, Reddit, TikTok e mais. Mais de 140 ferramentas com acesso de leitura/escrita.

GitHub

O que você pode fazer com Synter Ads MCP?

Listar campanhas entre plataformas — Peça ao seu assistente para mostrar todas as campanhas das contas de anúncios conectadas usando list_campaigns.
Criar campanhas de pesquisa — Peça ao seu assistente para criar uma campanha do Google Search com palavras-chave, orçamento e página de destino via create_search_campaign.
Pausar anúncios com baixo desempenho — Instrua seu assistente a interromper qualquer campanha que esteja gastando demais ou com baixo desempenho usando pause_campaign.
Ajustar orçamentos diários — Solicite mudanças de orçamento em tempo real usando update_campaign_budget para aumentar ou diminuir os gastos.
Extrair métricas de desempenho — Obtenha impressões, cliques, gastos, conversões e ROAS entre plataformas com get_performance.
Gerar criativos de anúncios — Peça imagens ou vídeos gerados por IA para suas campanhas usando generate_image e generate_video.

Documentação

Synter MCP Server

O servidor MCP mais completo para publicidade.

Relatórios em 19 plataformas de anúncios e criação completa de campanhas em 14 delas (ações de escrita em 16), abrangendo todos os principais canais de compra, com confirmações integradas para ações destrutivas.

Crie campanhas. Ajuste orçamentos. Pause campanhas com baixo desempenho. Gere criativos. Extraia dados de performance. Tudo por conversa natural, em Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X e mais.

Este é o primeiro servidor Model Context Protocol (MCP) que dá um cartão de crédito a agentes de IA.

Como o Synter se Compara

O servidor MCP oficial do Google Ads é somente leitura por design: segundo a documentação do Google, ele é "estritamente somente leitura" e "não pode modificar lances, pausar campanhas ou criar novos ativos." A maioria dos servidores MCP de anúncios de terceiros cobre uma única plataforma. Construímos o Synter para fazer as duas metades do trabalho, em todos os principais canais de compra, a partir de um único servidor.

	Synter MCP	MCP oficial do Google Ads	MCPs de anúncios de terceiros típicos
Acesso	Leitura em todas as 19 plataformas, criação de campanhas em 14, ações de escrita em 16	Somente leitura (versão atual)	Frequentemente somente leitura ou escrita parcial
Plataformas	19 para relatórios, 14 com criação completa de campanhas (listas abaixo)	Apenas Google Ads	Geralmente uma única plataforma
Criar campanhas	✅ Google Search, Display, PMax, Meta, LinkedIn, Reddit, mais via `run_tool`	❌	Raramente
Orçamentos e pausa	✅	❌	Varia
Geração de criativos com IA	✅ Imagens, vídeo, textos	❌	❌
Sincronização de audiências	✅ Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X	❌	❌
Segurança	Confirmações para ações destrutivas	n/d (somente leitura)	Varia
Código aberto	✅ MIT	✅	Varia

Cobertura de relatórios (19 plataformas): Google Ads, Microsoft Ads (Bing), Meta (Facebook e Instagram), LinkedIn Ads, X (Twitter) Ads, Reddit Ads, TikTok Ads, Snapchat Ads, Pinterest Ads, Spotify Ads, Amazon Ads, Amazon DSP, Walmart Connect, Instacart Ads, Target Roundel, Criteo, The Trade Desk, Display & Video 360 e OpenAI Ads (ChatGPT).

Criação completa de campanhas (14 plataformas): Google Ads, Microsoft Ads, Meta, LinkedIn, X, Reddit, TikTok, Snapchat, Pinterest, Spotify, Amazon Ads (Sponsored Products, Brands e Display), Amazon DSP, The Trade Desk e OpenAI Ads. Display & Video 360 e StackAdapt também suportam ações de escrita (pausa, atualizações de orçamento e line items, upload de audiências) sem criação de campanhas. As 4 restantes (Walmart Connect, Instacart, Target Roundel e Criteo) são somente relatórios hoje.

O pacote npx inclui ferramentas tipadas para as operações mais comuns, além de acesso run_tool ao catálogo completo de mais de 140 ferramentas do Synter. O servidor remoto em https://mcp.syntermedia.ai/mcp/ expõe o conjunto completo de ferramentas hospedadas, incluindo extração de performance para todas as plataformas acima.

Para descoberta de MCP no estilo registry, server.json é a fonte de verdade legível por máquina. Mantenha-o alinhado com package.json, manifest.json e os exemplos de configuração neste README.

⚠️ Aviso Justo

Seu agente de IA será capaz de:

Criar campanhas que começam a gastar seu orçamento imediatamente
Ajustar lances que afetam quanto você paga por clique
Pausar campanhas (às vezes isso é uma coisa boa)
Adicionar palavras-chave que mudam quem vê seus anúncios
Gerar criativos e enviá-los para suas contas

Incluímos confirmações para ações destrutivas. Mas mesmo assim, talvez não dê isso a um agente que você acabou de conhecer.

Início Rápido

1. Obtenha Sua Chave de API

Cadastre-se em syntermedia.ai e crie uma chave de API nas Configurações de Desenvolvedor.

2. Configure Seu Cliente de IA

Para Claude Desktop: Adicione ao ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["@synterai/mcp-server"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

Para Cursor: Adicione ao .cursor/mcp.json no seu projeto:

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["@synterai/mcp-server"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

Para Amp: Adicione ao .amp/settings.json:

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["@synterai/mcp-server"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

Remoto (Streamable HTTP): Para ChatGPT, n8n, Zapier ou qualquer cliente MCP que suporte transporte HTTP:

URL: https://mcp.syntermedia.ai/mcp/
Header: X-Synter-Key: syn_your_api_key_here

Não é necessária instalação local. Funciona com qualquer cliente MCP que suporte transporte Streamable HTTP.

3. Comece a Usar

Reinicie seu cliente de IA e comece a conversar:

"Mostre-me todas as minhas campanhas do Google Ads"

"Crie uma campanha de pesquisa para 'software de gerenciamento de projetos' com orçamento de $50/dia"

"Pause a campanha que está estourando o orçamento"

Prefere um plugin completo? (Claude Code / Claude Desktop)

Este pacote é o servidor MCP puro. Se você usa Claude Code ou Claude Desktop, o plugin Synter envolve este mesmo servidor com skills prontas (/synter:launch, /synter:audience, /synter:optimize, …), agentes especializados e um gancho de segurança de aprovação antes do gasto:

/plugin marketplace add Synter-Media-AI/plugin
/plugin install synter@synter

Ele também inclui um executor Claude Agent SDK headless para automação. Consulte o repositório do plugin ou o guia de plugins do Claude. Use este pacote MCP diretamente quando quiser apenas as ferramentas, ou estiver conectando outro cliente.

O Que Seu Agente Pode Fazer?

📊 Gerenciamento de Campanhas

Ferramenta	Descrição
`list_campaigns`	Listar campanhas em todas as plataformas conectadas
`create_search_campaign`	Criar uma campanha de pesquisa do Google com palavras-chave e anúncios
`create_display_campaign`	Criar uma campanha de Display do Google com imagens
`create_pmax_campaign`	Criar uma campanha Performance Max
`create_meta_campaign`	Criar uma campanha do Facebook/Instagram
`create_linkedin_campaign`	Criar uma campanha do LinkedIn para B2B
`create_reddit_campaign`	Criar uma campanha do Reddit
`pause_campaign`	Pausar qualquer campanha
`update_campaign_budget`	Alterar o orçamento diário

📈 Performance e Análises

Ferramenta	Descrição
`get_performance`	Obter impressões, cliques, gastos, conversões, ROAS
`get_daily_spend`	Detalhamento de gastos diários por plataforma

🎯 Palavras-Chave e Segmentação

Ferramenta	Descrição
`add_keywords`	Adicionar palavras-chave a uma campanha ou grupo de anúncios
`add_negative_keywords`	Bloquear termos de pesquisa indesejados

🔄 Rastreamento de Conversões

Ferramenta	Descrição
`create_conversion`	Configurar uma ação de conversão
`list_conversions`	Listar ações de conversão existentes
`diagnose_tracking`	Verificar se o rastreamento está instalado corretamente

🎨 Geração de Criativos

Ferramenta	Descrição
`generate_image`	Gerar imagens de anúncios com IA
`generate_video`	Gerar anúncios em vídeo com IA
`upload_image`	Enviar imagens como ativos de anúncio

🔧 Utilitários

Ferramenta	Descrição
`list_ad_accounts`	Listar todas as contas de anúncios conectadas
`run_tool`	Executar qualquer uma das mais de 140 ferramentas do Synter diretamente

Sem Experiência com Anúncios? Sem Problema.

Se você nunca veiculou anúncios antes, aqui está o que você precisa saber:

O Que é uma Campanha?

Uma campanha é como uma pasta de projeto. Ela contém seus anúncios, quem os vê e quanto você gasta.

Campaign: "Q1 Lead Generation"
├── Budget: $50/day
├── Targeting: USA, people searching "project management"
└── Ads: Headlines, descriptions, images

Quais Plataformas Posso Usar?

Plataforma	Melhor Para	Orçamento Mínimo
Google Ads	Pessoas pesquisando ativamente pelo seu produto	$10/dia
Meta (Facebook/Instagram)	Produtos visuais, audiências amplas	$5/dia
LinkedIn	B2B, empresas, candidatos a emprego	$25/dia
Reddit	Comunidades de nicho, usuários com afinidade tecnológica	$5/dia
Microsoft (Bing)	Demografias mais velhas, B2B	$10/dia
TikTok	Geração Z, entretenimento, e-commerce	$20/dia

Tipos de Campanha Explicados

Campanhas de Pesquisa: Seu anúncio aparece quando alguém pesquisa palavras-chave específicas no Google.

Exemplo: Alguém pesquisa "melhor software de CRM" → Seu anúncio aparece

Campanhas de Display: Anúncios de imagem exibidos em sites e aplicativos.

Exemplo: Banner em um site de notícias

Performance Max (PMax): A IA do Google mostra seus anúncios em todos os lugares (Pesquisa, YouTube, Display, Gmail, Maps).

Exemplo: O Google descobre os melhores posicionamentos para você

Campanhas de Vídeo: Anúncios em vídeo no YouTube e sites parceiros.

Exemplo: Anúncio de 15 segundos antes de um vídeo no YouTube

Termos Comuns

Termo	O Que Significa
Impressões	Quantas vezes seu anúncio foi exibido
Cliques	Quantas pessoas clicaram no seu anúncio
CTR	Taxa de cliques (cliques ÷ impressões × 100)
CPC	Custo por clique
Conversões	Ações desejadas (inscrições, compras, etc.)
ROAS	Retorno sobre gasto com anúncios (receita ÷ gasto)

Checklist para a Primeira Campanha

Antes de criar sua primeira campanha, você precisará de:

✅ Uma URL de página de destino para onde as pessoas irão ao clicar
✅ Uma ideia de quem você quer alcançar (localização, interesses)
✅ Um orçamento diário com o qual você se sinta confortável ($10-50 para começar)
✅ Alguns títulos e descrições para o seu anúncio

Dica profissional: Comece com uma campanha de Pesquisa no Google. É a mais fácil de entender e mostra anúncios para pessoas que já estão procurando o que você oferece.

Exemplos de Conversas

Crie Sua Primeira Campanha

Você: Crie uma campanha de pesquisa do Google para meu produto SaaS. Segmente pessoas pesquisando por "software de colaboração em equipe" e "ferramentas de gerenciamento de projetos". Orçamento de $25/dia. Página de destino é https://myapp.com/signup

Agente: Vou criar uma campanha de Pesquisa com essas palavras-chave. Quais títulos devo usar? Aqui estão algumas sugestões:

"Colaboração em Equipe Simplificada"

"Gerenciamento de Projetos para Equipes Modernas"

"Comece Grátis - Sem Cartão de Crédito"

Verifique a Performance

Você: Como estão minhas campanhas esta semana?

Agente: Aqui está sua performance nos últimos 7 dias:

Campanha Gasto Cliques Conversões ROAS
Pesquisa de Marca $142 89 12 4,2x
Palavras-Chave de Concorrentes $98 45 3 1,5x
Retargeting de Display $67 234 8 2,8x

A campanha "Palavras-Chave de Concorrentes" está com baixo desempenho. Quer que eu a pause ou ajuste a segmentação?

Campanha	Gasto	Cliques	Conversões	ROAS
Pesquisa de Marca	$142	89	12	4,2x
Palavras-Chave de Concorrentes	$98	45	3	1,5x
Retargeting de Display	$67	234	8	2,8x

Adicione Palavras-Chave Negativas

Você: Estou recebendo cliques por "gerenciamento de projetos gratuito", mas não temos um plano gratuito. Bloqueie esses termos.

Agente: Adicionei "gratuito" como palavra-chave negativa à sua campanha. Isso impedirá que seus anúncios apareçam para qualquer pesquisa contendo "gratuito".

Gere Criativos de Anúncio

Você: Preciso de uma imagem de anúncio de display para um produto de automação de marketing. Tema escuro, profissional, 1200x628.

Agente: Gerando sua imagem...

Criado: "Dashboard de automação de marketing com visualização de dados em fundo escuro" Ativo salvo e pronto para uso na sua próxima campanha de Display.

Conecte Suas Contas de Anúncios

Para gerenciar anúncios em cada plataforma, você precisará conectar suas contas no Synter:

Acesse syntermedia.ai/settings/credentials
Clique em "Conectar" ao lado de cada plataforma
Complete o fluxo OAuth
Seu agente agora pode gerenciar essa plataforma

Plataformas suportadas (19; ✅ = relatórios + execução completa de campanhas, 📊 = relatórios):

Google Ads ✅
Meta (Facebook/Instagram) ✅
LinkedIn Ads ✅
Microsoft Ads (Bing) ✅
Reddit Ads ✅
TikTok Ads ✅
X (Twitter) Ads ✅
Snapchat Ads ✅
Pinterest Ads ✅
Spotify Ads ✅
Amazon DSP ✅
The Trade Desk ✅
Amazon Ads 📊
Walmart Connect 📊
Instacart Ads 📊
Target Roundel 📊
Criteo 📊
Display & Video 360 📊
OpenAI Ads (ChatGPT) 📊

Avançado: Acesso Direto às Ferramentas

Para usuários avançados, você pode chamar qualquer uma das mais de 140 ferramentas do Synter diretamente:

> Use run_tool to call google_ads_list_audiences

Veja a lista completa de ferramentas em docs.syntermedia.ai/tools ou pergunte ao seu agente:

> What tools are available for LinkedIn Ads?

Seguro por Padrão: `execute` Dry-Runs a Menos que Você Opte

A ferramenta universal execute nunca executa uma ação na primeira chamada, a menos que você opte por isso. Por padrão (dry_run: true), ela valida a solicitação e para por aí — nada é executado, nada é gasto. Passe dry_run: false para realmente executar a ação; para qualquer coisa que gaste dinheiro, faça isso apenas com a aprovação do proprietário da conta.

Variáveis de Ambiente

Variável	Obrigatório	Descrição
`SYNTER_API_KEY`	Sim	Sua chave de API do Synter
`SYNTER_API_URL`	Não	Substituição de URL da API (padrão: https://syntermedia.ai)

Desenvolvimento Local

# Clone and install
git clone https://github.com/Synter-Media-AI/mcp-server.git
cd mcp-server
npm install

# Build
npm run build

# Run locally
SYNTER_API_KEY=syn_your_key_here node dist/index.js

Solução de Problemas

"SYNTER_API_KEY não definida"

Certifique-se de que sua chave de API esteja na seção env da sua configuração MCP. A chave deve começar com syn_.

"Chave de API inválida ou expirada"

Verifique se você copiou a chave completa (elas são longas!)
Verifique se a chave está ativa em syntermedia.ai/developer
Certifique-se de que a chave tenha o escopo tools:write

"Nenhuma conta de anúncios conectada"

Você precisa conectar pelo menos uma plataforma de anúncios:

Acesse syntermedia.ai/settings/credentials
Clique em "Conectar" ao lado do Google Ads (ou outra plataforma)
Conclua a autorização OAuth

As ferramentas não aparecem no Claude/Cursor

Reinicie completamente seu cliente de IA (não apenas atualize)
Verifique os logs do servidor MCP para erros
Verifique o caminho do arquivo de configuração e a sintaxe JSON

FAQ

Existe um servidor MCP para o Google Ads?

Sim, dois tipos. O Google oferece um servidor MCP oficial do Google Ads, que é somente leitura em sua versão atual: ele pode consultar relatórios, métricas e metadados, mas, segundo a documentação do Google, "não pode modificar lances, pausar campanhas ou criar novos ativos". Nosso servidor MCP cobre o Google Ads com leitura e escrita: criar campanhas de Pesquisa, Display e Performance Max, adicionar palavras-chave e palavras-chave negativas, ajustar orçamentos, pausar campanhas, gerenciar públicos do Customer Match, configurar rastreamento de conversões e extrair dados de desempenho. O mesmo servidor gera relatórios em outras 18 plataformas de anúncios e oferece execução completa de campanhas em 11 delas.

O Claude ou o ChatGPT podem gerenciar minhas campanhas de anúncios?

Sim. Com o servidor MCP do Synter conectado, o Claude (Claude Desktop, Claude Code), o ChatGPT, o Cursor e qualquer outro cliente compatível com MCP podem criar campanhas, ajustar orçamentos, pausar campanhas com baixo desempenho, gerar criativos e sincronizar públicos em 14 plataformas de anúncios (ações de escrita em 16) e extrair dados de desempenho em todas as 19. O Claude e outros clientes stdio se conectam via npx @synterai/mcp-server com um SYNTER_API_KEY; o ChatGPT e outros clientes HTTP se conectam ao servidor remoto em https://mcp.syntermedia.ai/mcp/ com um cabeçalho X-Synter-Key. Ações destrutivas têm confirmações integradas.

Qual é a diferença entre o MCP oficial do Google Ads e o Synter?

Duas coisas: acesso de escrita e cobertura de plataformas. O MCP oficial do Google Ads é somente leitura em sua versão atual e cobre apenas o Google Ads. O Synter gera relatórios em 19 plataformas e oferece criação completa de campanhas em 14 delas, incluindo Google Ads, Meta, LinkedIn, Microsoft, TikTok, Amazon Ads, Amazon DSP, OpenAI Ads e The Trade Desk. Se você só precisa de relatórios do Google Ads, o servidor oficial é uma escolha sólida. Se você quer um agente que possa agir sobre o que encontra, no Google e em todos os outros lugares onde você anuncia, foi para isso que criamos o Synter.

Recursos

Manual do Synter: syntermedia.ai/manual
Documentação da API: docs.syntermedia.ai
Plugin do Claude: github.com/Synter-Media-AI/plugin (skills, agentes e este MCP para Claude Code / Desktop)
Referência de Ferramentas: docs.syntermedia.ai/tools
Comparação de Servidores MCP: syntermedia.ai/blog/best-ad-platform-mcp-servers
Skills de Agente Gratuitas (47 open-source): github.com/Synter-Media-AI/free-skills (também em skills.sh)
Suporte: hello@syntermedia.ai

Licença

Licença MIT - consulte LICENSE para detalhes.

A extensão MCP que eles não querem que você use.
Porque agentes de IA com orçamentos de anúncios mudam tudo.