Synter Ads MCP Server

Servidor MCP Synter

A extensão MCP que o Claude não quer que você use.

Porque, uma vez instalada, seu agente de IA pode gastar dinheiro de verdade.

Crie campanhas. Ajuste orçamentos. Pause campanhas com baixo desempenho. Gere criativos. Extraia dados de performance. Tudo através de conversa natural — no Google, Meta, LinkedIn, Microsoft, Reddit, TikTok e mais.

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

---

Por que Synter?

A maioria dos servidores MCP de publicidade é somente leitura e de plataforma única. O Synter é o único servidor MCP de gerenciamento de anúncios multiplataforma com capacidades completas de leitura + escrita:

Funcionalidade	Synter	Google Ads MCP	Amazon Ads MCP	Outros
Plataformas	9+ (Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X, StackAdapt, TTD)	Apenas Google	Apenas Amazon	1-2
Criar campanhas	✅	❌ Somente leitura	✅ Apenas Amazon	❌
Ajustar orçamentos	✅	❌	✅	❌
Pausar campanhas	✅	❌	✅	❌
Geração de criativos por IA	✅ (Imagen 4, Veo, Flux)	❌	❌	❌
Otimização de lances	✅	❌	❌	❌
Estrategista de IA	✅	❌	❌	❌
Código aberto	✅	✅	❌	Varia

Um servidor MCP. Todas as plataformas de anúncios. Leitura e escrita.

---

⚠️ Aviso Justo

Seu agente de IA será capaz de:

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

Nós incorporamos 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 (HTTP Transmissível) — 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 HTTP Transmissível.

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 um orçamento de R$50/dia"

"Pause a campanha que está gastando demais"

---

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 habilidades prontas (/synter:launch, /synter:audience, /synter:optimize, …), agentes especializados e um gancho de segurança de aprovação antes de gastar:

/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 Plugin 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 no Facebook/Instagram
create_linkedin_campaign	Criar uma campanha no LinkedIn para B2B
create_reddit_campaign	Criar uma campanha no Reddit
pause_campaign	Pausar qualquer campanha
update_campaign_budget	Alterar orçamento diário

📈 Performance e Analytics

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

🔄 Acompanhamento 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 acompanhamento está instalado corretamente

🎨 Geração de Criativos

Ferramenta	Descrição
generate_image	Gerar imagens de anúncio por IA (Imagen 4, Flux, SDXL)
generate_video	Gerar anúncios em vídeo por IA (Veo, Runway, Luma)
upload_image	Enviar imagens como recursos de anúncio

🔧 Utilitário

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

---

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

Se você nunca publicou 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	Ideal Para	Orçamento Mín.
Google Ads	Pessoas buscando ativamente pelo seu produto	R$10/dia
Meta (Facebook/Instagram)	Produtos visuais, públicos amplos	R$5/dia
LinkedIn	B2B, empresas, candidatos a emprego	R$25/dia
Reddit	Comunidades de nicho, usuários experientes em tecnologia	R$5/dia
Microsoft (Bing)	Dados demográficos mais velhos, B2B	R$10/dia
TikTok	Geração Z, entretenimento, e-commerce	R$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 exibe 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 do 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 (cadastros, compras, etc.)
ROAS	Retorno sobre o investimento em anúncios (receita ÷ gasto)

Checklist da Primeira Campanha

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

1. ✅ Uma URL de página de destino para onde as pessoas irão quando clicarem
2. ✅ Uma ideia de quem você quer alcançar (localização, interesses)
3. ✅ Um orçamento diário com o qual você se sinta confortável (R$10-50 para começar)
4. ✅ 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 exibe 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 que buscam por "software de colaboração em equipe" e "ferramentas de gerenciamento de projetos". O orçamento é de R$25/dia. A 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"

Verificar 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	R$142	89	12	4.2x
Palavras-chave de Concorrentes	R$98	45	3	1.5x
Retargeting de Display	R$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?

Adicionar Palavras-chave Negativas

Você: Estou recebendo cliques para "gerenciamento de projetos grátis", mas não temos um plano gratuito. Bloqueie esses.

Agente: Adicionei "grátis" como palavra-chave negativa à sua campanha. Isso impedirá que seus anúncios sejam exibidos para qualquer pesquisa que contenha "grátis".

Gerar Criativo 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 com Imagen 4...

Criado: "Painel de automação de marketing com visualização de dados em fundo escuro" Recurso salvo e pronto para uso em 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:

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

Plataformas Suportadas:

• Google Ads ✅
• Meta (Facebook/Instagram) ✅
• LinkedIn Ads ✅
• Microsoft Ads (Bing) ✅
• Reddit Ads ✅
• TikTok Ads ✅
• X (Twitter) Ads ✅
• StackAdapt ✅
• The Trade Desk ✅

---

Avançado: Acesso Direto a Ferramentas

Para usuários avançados, você pode chamar qualquer uma das mais de 140 ferramentas 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?

---

Variáveis de Ambiente

Variável	Obrigatória	Descrição
SYNTER_API_KEY	Sim	Sua chave de API 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 está na seção env da sua configuração MCP. A chave deve começar com syn_.

"Chave de API inválida ou expirada"

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

"Nenhuma conta de anúncio conectada"

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

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

As ferramentas não estão aparecendo no Claude/Cursor

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

---

Recursos

• Manual do Synter: syntermedia.ai/manual
• Documentação da API: docs.syntermedia.ai
• Plugin Claude: github.com/Synter-Media-AI/plugin — habilidades, 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
• Habilidades de Agente Gratuitas (47 de código aberto): github.com/Synter-Media-AI/free-skills — também em skills.sh
• Suporte: [email protected]

---

Licença

Licença MIT - veja 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.