Synter Ads
oficialGerenciamento 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.
O que você pode fazer com Synter Ads MCP?
- Listar campanhas em todas as plataformas — Peça ao seu assistente para puxar todas as campanhas das contas de anúncios conectadas com
list_campaigns. - Criar campanhas de pesquisa — Use
create_search_campaignpara lançar uma campanha do Google Search com palavras-chave, anúncios e orçamento. - Pausar campanhas de baixo desempenho — Interrompa qualquer campanha instantaneamente via
pause_campaignquando o gasto ou o ROAS parecer inadequado. - Puxar métricas de desempenho — Obtenha impressões, cliques, gastos, conversões e ROAS com
get_performance. - Gerar criativos de anúncio — Use
generate_imageougenerate_videopara produzir ativos de anúncio prontos para upload. - Executar qualquer uma das 140+ ferramentas — Acesse todo o catálogo da Synter diretamente com
run_toolpara ações avançadas.
Documentação
Servidor MCP Synter
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 desempenhos ruins. Gere criativos. Obtenha dados de desempenho. Tudo por meio de conversa natural, em Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X e muito mais.
Este é o primeiro servidor Model Context Protocol (MCP) que dá aos agentes de IA um cartão de crédito.
Nota:
Synter-Media-AI/pluginé o repositório canônico de plugin instalável para Claude. A cópia.claude-plugin/neste repositório não é a fonte de instalação.
Como o Synter se Compara
O servidor MCP oficial do Google Ads é somente leitura por design: de acordo com 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 | Google Ads MCP oficial | 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 por IA | ✅ Imagens, vídeo, texto | ❌ | ❌ |
| Sincronização de público | ✅ Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X | ❌ | ❌ |
| Segurança | Confirmações para ações destrutivas | n/a (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-item, upload de público) 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ções de desempenho para todas as plataformas acima.
Para descoberta MCP no estilo registro, 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 imediatamente a gastar seu orçamento
- 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
Construímos confirmações para ações destrutivas. Mas ainda 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 do 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
Nenhuma instalação local necessária. 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á gastando demais"
Prefere um plugin completo? (Claude Code / Claude Desktop)
Este pacote é o servidor MCP bruto. Se você usa Claude Code ou Claude Desktop, o plugin Synter envolve este mesmo servidor com habilidades 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 headless do Claude Agent SDK para automação. Veja o repositório do plugin ou o guia do Claude Plugin. 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 | Liste campanhas em todas as plataformas conectadas |
create_search_campaign | Crie uma campanha de pesquisa do Google com palavras-chave e anúncios |
create_display_campaign | Crie uma campanha de Display do Google com imagens |
create_pmax_campaign | Crie uma campanha Performance Max |
create_meta_campaign | Crie uma campanha do Facebook/Instagram |
create_linkedin_campaign | Crie uma campanha do LinkedIn para B2B |
create_reddit_campaign | Crie uma campanha do Reddit |
pause_campaign | Pause qualquer campanha |
update_campaign_budget | Altere o orçamento diário |
📈 Desempenho e Análises
| Ferramenta | Descrição |
|---|---|
get_performance | Obtenha 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 | Adicione palavras-chave a uma campanha ou grupo de anúncios |
add_negative_keywords | Bloqueie termos de pesquisa indesejados |
🔄 Rastreamento de Conversões
| Ferramenta | Descrição |
|---|---|
create_conversion | Configure uma ação de conversão |
list_conversions | Liste ações de conversão existentes |
diagnose_tracking | Verifique se o rastreamento está instalado corretamente |
🎨 Geração de Criativos
| Ferramenta | Descrição |
|---|---|
generate_image | Gere imagens de anúncios com IA |
generate_video | Gere anúncios em vídeo com IA |
upload_image | Envie imagens como ativos de anúncio |
🔧 Utilitário
| Ferramenta | Descrição |
|---|---|
list_ad_accounts | Liste todas as contas de anúncios conectadas |
run_tool | Execute 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, públicos amplos | $5/dia |
| B2B, empresas, candidatos a emprego | $25/dia | |
| Comunidades de nicho, usuários com conhecimento técnico | $5/dia | |
| Microsoft (Bing) | Dados demográficos mais velhos, 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 em 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 em 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 da 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 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 no Google para meu produto SaaS. Segmente pessoas pesquisando por "software de colaboração em equipe" e "ferramentas de gerenciamento de projetos". Orçamento é $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 o Desempenho
Você: Como estão minhas campanhas esta semana?
Agente: Aqui está seu desempenho 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 desempenho ruim. Quer que eu a pause ou ajuste a segmentação?
Adicione Palavras-chave Negativas
Você: Estou recebendo cliques para "gerenciamento de projetos gratuito", mas não temos um plano gratuito. Bloqueie esses.
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: "Painel 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:
- Vá para 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 a 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 Instruído de Outra Forma
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 envolva gasto de dinheiro, faça isso apenas com a aprovação do proprietário da conta.
Variáveis de Ambiente
| Variável | Obrigatória | Descrição |
|---|---|---|
SYNTER_API_KEY | Sim | Sua chave de API da Synter |
SYNTER_API_URL | Não | Substituição da 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 do 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!)
- Confirme 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
- Confirme o caminho do arquivo de configuração e a sintaxe JSON
Perguntas Frequentes
Existe um servidor MCP para Google Ads?
Sim, de dois tipos. O Google disponibiliza 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, de acordo com 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 Search, Display e Performance Max, adicionar palavras-chave e palavras-chave negativas, ajustar orçamentos, pausar campanhas, gerenciar públicos do Customer Match, configurar acompanhamento 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 da Synter conectado, o Claude (Claude Desktop, Claude Code), ChatGPT, Cursor e qualquer outro cliente compatível com MCP podem criar campanhas, ajustar orçamentos, pausar campanhas de 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 boa escolha. Se você quer um agente que possa agir com base no que encontra, no Google e em todos os outros lugares onde você anuncia, foi para isso que criamos o Synter.
Recursos
- Manual da Synter: syntermedia.ai/manual
- Documentação da API: docs.syntermedia.ai
- Plugin para 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.