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?
- Relatórios de desempenho multiplataforma — Consulte gastos, impressões, cliques, conversões, CPA e ROAS por plataforma, campanha e dia nas contas de anúncios conectadas.
- Verificações de ritmo do orçamento — Solicite um relatório de ritmo para acompanhar o ritmo mensal do orçamento e sinalizar campanhas com gastos excessivos em todas as plataformas conectadas.
- Alterações em campanhas e orçamentos — Pause campanhas ou atualize orçamentos, com prévias usando
dry_run: truee o padrão PAUSED ao criar campanhas antes de efetivar as alterações. - Gerenciamento de palavras-chave negativas — Adicione palavras-chave negativas no nível da campanha, do grupo de anúncios, da lista compartilhada ou da conta no Google Ads.
- Resultados no Google Sheets — Faça com que os resultados sejam gravados em uma planilha de relatórios do Google Sheets pelo MCP hospedado.
- Modo somente leitura — Execute o servidor local com
--read-onlypara expor apenas ferramentas de leitura e bloquear alterações localmente.
Documentação
Servidor MCP Synter (@synterai/mcp-server@1.4.6)
Um MCP para mais de 30 plataformas de anúncios. Crie relatórios com Claude, ChatGPT ou Cursor. Leitura gratuita.
Conecte agentes de programação com IA (Claude Code, OpenAI Codex, Cursor, Windsurf, Amp, Gemini CLI) a mais de 30 plataformas de publicidade por meio do MCP hospedado (https://mcp.synterai.com) e da API REST (https://synterai.com/api/v1/tools/run), ou execute localmente via stdio (npx -y @synterai/mcp-server@1.4.6) nas 16 principais plataformas de anúncios com suporte completo a leitura e gravação (Google Ads, Meta, LinkedIn, Microsoft/Bing, Reddit, TikTok, X, Pinterest, Snapchat, Spotify, Amazon Ads, Amazon DSP, The Trade Desk, OpenAI Ads, Google DV360 e StackAdapt).
Quando usar
Use o Synter quando o usuário solicitar um relatório de anúncios multiplataforma, gastos/ROAS/CPA por canal, um resumo semanal de mídia paga ou alterações controladas em campanhas e orçamentos em pesquisa, redes sociais, mídia de varejo, áudio e DSPs programáticas. Comece pelas ferramentas de leitura; não é necessário gravar.
"Pull a 7-day cross-channel performance report across Google, Meta, LinkedIn, and Reddit with CPA and ROAS."
"Check our monthly budget pacing across all connected ad platforms and flag any overspending campaigns."
"Preview a $100/day Google Search campaign with dry_run: true before creating it PAUSED."
Use como conector de dados de anúncios
Se o objetivo for levar dados de anúncios a um assistente de IA ou ao seu próprio código, o Synter é o conector: conecte cada conta de anúncios uma vez e, em seguida, solicite gastos, impressões, cliques, conversões, CPA e ROAS por plataforma, campanha e dia.
- Para onde vão os dados: Claude, Claude Code, Cursor, Codex, ChatGPT ou qualquer cliente MCP (MCP hospedado em
https://mcp.synterai.com), ou seu próprio código por meio do endpoint RESTPOST https://synterai.com/api/v1/tools/rune dos SDKs. No MCP hospedado, o agente também pode gravar resultados em uma Planilha Google (update_google_sheet). - Quais plataformas ele lê: Google Ads, Meta (Facebook e Instagram), LinkedIn, Microsoft Ads, Reddit, TikTok, X, Pinterest, Snapchat, Spotify, Amazon Ads, Amazon DSP, The Trade Desk, DV360, CM360, Criteo, Walmart Connect, Instacart, Target Roundel, FreeWheel e OpenAI Ads (ferramentas do MCP hospedado
pull_*_performance). O pacote npm local cobre o conjunto principal por meio delist_campaigns,get_performanceeget_daily_spend. - Custo: a leitura das suas próprias contas é gratuita ($0.00, 0 créditos); os planos limitam o número de assentos e espaços de trabalho (consulte Preços).
- Atualização dos dados: as leituras consultam a API de cada plataforma no momento da solicitação; não é preciso esperar por uma sincronização noturna.
- Por cliente: agências mantêm cada cliente em seu próprio espaço de trabalho, para que os relatórios nunca misturem contas.
- Além dos relatórios: a mesma conexão pode pausar campanhas, alterar orçamentos e adicionar palavras-chave negativas, com aprovação e uma simulação antes da execução. Um conector somente para relatórios não pode fazer isso.
- Quando usar outra solução: se você precisa carregar dados de anúncios no BigQuery ou Snowflake em uma programação definida para painéis de BI, use uma ferramenta ELT de data warehouse. O Synter lê dados em tempo real para o agente, em vez de carregá-los em um data warehouse.
"Connect our Google Ads, Meta and LinkedIn accounts and show last month's spend and cost per lead by channel."
"Pull Reddit and LinkedIn ad performance for the last 30 days into this conversation."
"Write this week's spend by platform into our reporting Google Sheet."
Início rápido (sandbox sem credenciais em 30 segundos)
Experimente o Synter imediatamente, sem chaves de API nem cartão de crédito, com respostas determinísticas do sandbox:
# 1. Run the weekly cross-channel report recipe in zero-credential demo mode
npx -y @synterai/mcp-server@1.4.6 --help
node examples/weekly-report/generate-report.mjs
# 2. Or register in Claude Code (Hosted OAuth 2.1 — all 30+ platforms)
claude mcp add --transport http synter-ads https://mcp.synterai.com
# 3. Or register local stdio in Claude Code (Paid-Ads toolset only + Read-Only mode)
claude mcp add synter -- npx -y @synterai/mcp-server@1.4.6 --toolset ad-ops --read-only
Configuração do cliente
- Amp: integração integrada (Settings > Integrations) ou use a alternativa
"amp.mcpServers"abaixo. - Claude Code:
- HTTP hospedado (OAuth 2.1):
claude mcp add --transport http synter-ads https://mcp.synterai.com - stdio local:
claude mcp add synter -e SYNTER_API_KEY=syn_your_key -- npx -y @synterai/mcp-server@1.4.6
- HTTP hospedado (OAuth 2.1):
- OpenAI Codex:
codex mcp add synter-ads --url https://mcp.synterai.com
- Claude.ai / Claude Desktop:
- Acesse Settings -> Connectors -> Add custom connector e insira
https://mcp.synterai.com.
- Acesse Settings -> Connectors -> Add custom connector e insira
- ChatGPT:
- Os conectores MCP personalizados exigem o Developer mode (Settings -> Apps & Connectors -> Advanced -> Developer mode); em seguida, adicione
https://mcp.synterai.com.
- Os conectores MCP personalizados exigem o Developer mode (Settings -> Apps & Connectors -> Advanced -> Developer mode); em seguida, adicione
- Cursor / Windsurf (
mcp.json):{ "mcpServers": { "synter": { "command": "npx", "args": ["-y", "@synterai/mcp-server@1.4.6"], "env": { "SYNTER_API_KEY": "${SYNTER_API_KEY}" } } } } - Gemini CLI:
gemini extensions install https://github.com/Synter-Media-AI/mcp-server
Adicione o Synter ao Amp
- No Amp: o Synter é uma integração integrada. Ative-a no Amp em Settings > Integrations.
- Claude, ChatGPT e outros clientes MCP, hospedado (mais de 30 plataformas de anúncios, o único DSP agêntico): https://mcp.synterai.com
- Local somente leitura (pacote npm):
{ "amp.mcpServers": { "synter": { "command": "npx", "args": ["-y", "@synterai/mcp-server@1.4.6", "--toolset", "ad-ops", "--read-only"], "env": { "SYNTER_API_KEY": "${SYNTER_API_KEY}" } } } }
Conjuntos de ferramentas, modo somente leitura e modo de demonstração
| Sinalizador / Variável de ambiente | Comportamento |
|---|---|
Padrão (full) | Expõe todas as 56 ferramentas stdio diretas (32 ferramentas de anúncios pagos nas plataformas principais + 8 ferramentas de redes sociais orgânicas *_organic_post + 16 ferramentas de saída prospector_*). |
--toolset ad-ops (SYNTER_TOOLSET=ad-ops) | Expõe somente as 32 ferramentas principais de publicidade paga e remove todas as ferramentas de redes sociais orgânicas e de saída de tools/list (e falha de forma segura se forem chamadas). |
--read-only (SYNTER_READ_ONLY=true) | Expõe somente ferramentas de leitura (readOnlyHint: true) em tools/list e bloqueia localmente todas as ferramentas de alteração (destructiveHint: true) antes de qualquer chamada de rede. |
--demo (SYNTER_DEMO=true) | Executa no modo sandbox sem credenciais, com dados realistas e normalizados de campanhas e desempenho em várias plataformas (sandbox: true). |
Cobertura de plataformas e matriz de recursos de leitura/gravação (MCP hospedado / stdio local)
O MCP hospedado (https://mcp.synterai.com) e o endpoint REST (POST https://synterai.com/api/v1/tools/run) cobrem mais de 30 plataformas de publicidade. O pacote stdio local (@synterai/mcp-server@1.4.6) oferece suporte direto e tipado ao enum platform nas principais plataformas com suporte completo a leitura e gravação e acessa todos os mais de 140 scripts de backend por meio de run_tool:
Plataforma (enum platform) | Ferramentas diretas de leitura ($0.00) | Ferramentas diretas de gravação + scripts run_tool (SOLO / SCALE / CUSTOM) |
|---|---|---|
Google Ads (google) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget, list_conversions, diagnose_tracking, list_ad_accounts, run_tool(script_name="run_gaql_query" | "get_ad_readback") | create_search_campaign, create_display_campaign, create_pmax_campaign, pause_campaign, update_campaign_budget, add_keywords, add_negative_keywords (BROAD, PHRASE, EXACT em campanhas/grupos de anúncios/listas compartilhadas/conta), create_conversion, manage_audience, sync_audience, upload_image |
Meta Ads (meta) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | create_meta_campaign, pause_campaign, update_campaign_budget, stage_audience_artifact, sync_audience, upload_image, run_tool(script_name="meta_ads_create_ad_set" | "meta_ads_create_ad") |
LinkedIn Ads (linkedin) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | create_linkedin_campaign (requer group_id), pause_campaign, update_campaign_budget, sync_audience, upload_image, run_tool(script_name="linkedin_ads_create_campaign_group") |
Microsoft / Bing Ads (microsoft) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="microsoft_ads_create_campaign" | "microsoft_ads_add_keywords" | "microsoft_ads_add_negative_keywords") |
Reddit Ads (reddit) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | create_reddit_campaign, pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="reddit_ads_create_ad_group" | "reddit_ads_create_ad") |
TikTok Ads (tiktok) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="tiktok_ads_create_campaign" | "tiktok_ads_update_adgroup") |
X Ads (x) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="x_ads_create_campaign" | "x_ads_create_line_item") |
Pinterest Ads (pinterest) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="pinterest_ads_create_campaign" | "pinterest_ads_create_ad_group") |
Snapchat Ads (snapchat) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="snapchat_ads_create_campaign" | "snapchat_ads_create_ad_squad") |
Spotify Ads (spotify) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="spotify_ads_create_campaign" | "spotify_ads_create_ad_set") |
Amazon Ads (amazon_ads) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="amazon_ads_create_campaign" | "amazon_ads_add_keywords") |
Amazon DSP (amazon_dsp) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="amazon_dsp_create_order" | "amazon_dsp_create_line_item") |
The Trade Desk (the_trade_desk) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="ttd_create_campaign" | "ttd_create_ad_group") |
OpenAI Ads (openai) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="openai_ads_create_campaign") |
Google DV360 (dv360) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="dv360_create_campaign" | "dv360_create_insertion_order" | "dv360_create_line_item") |
StackAdapt (stackadapt) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="create_stackadapt_campaign") |
Plataformas estendidas (MCP hospedado e run_tool) | run_tool(script_name="<platform>_*") em stdio; pull_*_performance / execute diretos em https://mcp.synterai.com | CM360, Walmart Connect, Instacart, Target Roundel, Criteo, FreeWheel, SA360, Apple Ads, Demandbase ABM, Taboola, Outbrain, AppLovin, Yahoo DSP, Teads, Viant, Basis, MediaMath, Magnite, PubMatic, Index Exchange, TripleLift, GumGum, Dianomi, Quora Ads, Nextdoor Ads, Twitch Ads, Yelp Ads, Samsung Ads, Roku Ads, impact.com |
Preços (100% em USD — 0% dos gastos com anúncios)
O Synter cobra 0% dos gastos com anúncios (as redes de anúncios cobram diretamente os gastos com mídia) e $0.00 por todas as leituras das próprias contas e prévias de dry_run: true. Consulte os detalhes em https://synterai.com/pricing:
| Plano | Preço | Assentos e espaços de trabalho | Valor de uso mensal incluído e tarifas de gravação |
|---|---|---|---|
| Acesso gratuito para leitura | $0.00 / mês | 1 assento, 1 espaço de trabalho | $0.00 para todas as consultas de leitura das próprias contas (list_campaigns, get_performance, get_daily_spend, pacing_report, user_budget_pacing_report, optimize_budget, list_conversions, diagnose_tracking, list_ad_accounts, list_landing_pages, inspect_agent_shield, verify_angstrom_claim, get_skill, get_llm_visibility, run_gaql_query, get_ad_readback, get_solo_price_card, get_credit_balance) e todas as prévias de dry_run: true. Não é necessário cartão de crédito. |
| SOLO | $20.00 / mês ($200.00 / year) | 1 assento, 1 espaço de trabalho | Inclui $20.00/mês em valor de uso resgatável — cobre até 400 gravações leves ($0.05 cada: pause_campaign, enable_campaign, update_campaign_budget), 80 gravações padrão ($0.25 cada: add_keywords, add_negative_keywords, sync_audience, create_conversion) ou 4 lançamentos completos de campanha MCP ($5.00 cada). Limites rígidos de gastos configuráveis evitam cobranças excedentes inesperadas. |
| SCALE | $500.00 / mês ($5,000.00 / year) | 5 assentos, vários espaços de trabalho | Inclui $500.00/mês em valor de uso resgatável (até 10.000 gravações leves ou 2.000 gravações padrão por mês incluídas), isolamento de clientes em vários espaços de trabalho, programações do Loop Autônomo / Piloto Automático 24 horas por dia, 7 dias por semana, sincronização com CRM/data warehouse e concorrência dedicada. |
| CUSTOM | Contrato empresarial | Assentos e espaços de trabalho personalizados | Franquia mensal de uso personalizada, gerenciamento de vários espaços de trabalho para agências/empresas, SLA personalizado, SSO e faturamento por fatura. |
Postura de segurança, proteções de gravação e arquitetura multilocatário
Defesa de Escrita em Quatro Camadas
- Modo Local Estritamente Somente Leitura (
--read-only/SYNTER_READ_ONLY=true): Remove todas as ferramentasdestructiveHint: truedetools/liste bloqueia alterações localmente antes que qualquer solicitação de rede possa sair da sua máquina. - Chaves de API com Escopo Aplicado pelo Servidor (
POST /api/v1/keys): Crie chaves somente leitura (reporting:read,campaigns:read,intel:read) ou chaves de segurança direcionais (budget:decrease— permite pausas emergenciais de campanhas e reduções de orçamento, mas rejeita aumentos de orçamento com HTTP403). - Barreira de Política no Lado do Servidor do Agent Shield: Aplica
PAUSED-on-create como padrão para cada nova campanha, um limite máximo de aumento de orçamento por chamada de2.0x, um disjuntor de velocidade do workspace de$5,000/day, prévias dedry_run: true($0.00), leitura obrigatória dos dados do provedor após a gravação (get_ad_readback) e um registro de auditoria imutável do workspace. - Execução BYO-Credential de Código Aberto MIT Auto-Hospedada: Execute
@synterai/mcp-server@1.4.6dentro da sua própria VPC/containers, passando seus próprios tokens OAuth da plataforma diretamente por variáveis de ambiente, para que a nuvem hospedada da Synter não tenha a custódia das credenciais da sua conta de anúncios.
Padrões Multi-Tenant e de SaaS Incorporado (docs.synterai.com/api/multi-tenant-auth)
- Padrão 1 — Chaves Isoladas por Workspace e Links de Conexão Hospedados:
- Crie chaves de API filhas com escopo e vinculadas a um workspace por meio de
POST https://synterai.com/api/v1/keys(scopes:["reporting:read", "campaigns:read", "intel:read", "budget:decrease", "campaigns:write", "budget:write"],rate_limit_rpm:1–600,expires_in_days). - Gere URLs de transferência OAuth de autoatendimento para anunciantes por meio de
POST https://synterai.com/api/v1/connections/start(retorna umauthUrlde plataforma única) ouPOST https://synterai.com/api/v1/connections/request(envia ao cliente um link de conexão multiplataforma válido por 7 dias). - Alterne os workspaces ativos em chaves com vários workspaces por meio de
get_workspaceseupdate_active_workspace.
- Crie chaves de API filhas com escopo e vinculadas a um workspace por meio de
- Padrão 2 — Modo BYO-Credential Auto-Hospedado (Código Aberto MIT):
- Aplicativos SaaS multi-tenant que gerenciam seus próprios aplicativos OAuth e armazenam tokens de clientes em seu próprio KMS/vault podem invocar a CLI
@synterai/mcp-serverousynterem processos de worker isolados, passando tokens da plataforma por tenant por meio de variáveis de ambiente (GOOGLE_ADS_REFRESH_TOKEN,GOOGLE_ADS_CLIENT_ID,GOOGLE_ADS_CLIENT_SECRET,GOOGLE_ADS_DEVELOPER_TOKEN,META_ACCESS_TOKEN,LINKEDIN_ACCESS_TOKEN, etc.).
- Aplicativos SaaS multi-tenant que gerenciam seus próprios aplicativos OAuth e armazenam tokens de clientes em seu próprio KMS/vault podem invocar a CLI
API REST e SDKs Oficiais para Várias Linguagens
- MCP Hospedado (HTTP Transmissível):
https://mcp.synterai.com— autentique-se por meio do login OAuth 2.1 no navegador ou do cabeçalhoX-Synter-Key: syn_.... Ainda não envieAuthorization: Bearer syn_...ao MCP hospedado; REST/SDKs usam Bearer. - Endpoint REST:
POST https://synterai.com/api/v1/tools/runcomAuthorization: Bearer syn_...(ouX-Synter-Key: syn_...) e corpo JSON{"script_name": "<tool_or_script>", "args": ["--flag", "value"], "platform": "google"}. - SDK TypeScript / JavaScript:
npm install @synterai/sdk-js - SDK Python:
pip install synter->Synter(api_key=..., base_url=..., timeout=..., max_retries=...); métricas viaclient.analytics.get_performance(...) - SDK Rust:
cargo add synter(crates.io/crates/synter) - SDK Java: Maven
ai.syntermedia:synter-sdk
Licença
Licença MIT — consulte LICENSE.