Flyweel Ad-MCP (Google+Meta)

Conecte suas contas do Google Ads e Meta ao Claude, Cursor ou qualquer ferramenta de IA que suporte MCP.

Ver em flyweel.coExperimente este MCPPatrocinado

Documentação

Conecte sua IA aos seus anúncios. Faça perguntas. Obtenha respostas.

O que o MCP da Flyweel expõe

RecursoDetalhe
PlataformasGoogle Ads, Meta Ads, TikTok Ads (lançamento público no final de abril de 2026)
Ferramentas8 (get_setup_status, list_ad_accounts, connect_ad_platform, get_connection_status, select_ad_accounts, trigger_sync, get_sync_status, query_metrics)
Métricas222 métricas estendidas (132 Google, 67 Meta, 23 TikTok) mais o registro base
CRMPipedrive (negócios, funil, velocidade, taxa de conversão)
AutenticaçãoOAuth (sem necessidade de chave) para Claude, ChatGPT, Cursor, VS Code; chave de API Authorization: Bearer fwl_… para clientes headless/CLI, revogação por chave
Atualização de dadosSincronização automática quando os dados estão com mais de 15 minutos de atraso
Limites de consulta30 métricas, 5 dimensões, 500 linhas por consulta, 1 a 5 consultas por chamada

O que é o Flyweel MCP?

O Flyweel MCP permite que você converse com seus dados de anúncios.

Em vez de navegar pelos painéis do Google Ads ou Meta Ads, você simplesmente pergunta à sua IA. Ela analisa seus números reais e informa o que está acontecendo.

Pense assim: Seus anúncios moram em uma casa (Google/Meta). Sua IA mora em outra casa (Claude/Cursor). O Flyweel MCP é a linha telefônica entre elas. Agora elas podem conversar.

O que preciso para começar?

  1. Uma conta Flyweel com suas contas de anúncios conectadas
  2. Uma ferramenta de IA compatível com MCP. Suportadas hoje:
    • Claude (web e desktop), Claude Code CLI
      • ChatGPT (requer Modo Desenvolvedor), Cursor, VS Code, Windsurf, Zed
      • Cline, Continue.dev, JetBrains AI Assistant
      • Codex CLI, Gemini CLI, Warp, Raycast
      • Qualquer outro cliente compatível com MCP

Só isso.

Como configuro o Flyweel MCP?

Dois passos. Menos de 5 minutos.

O caminho mais rápido é OAuth — sem chave de API para copiar, colar ou vazar. Você conecta com uma URL, faz login e aprova o acesso. Apenas clientes headless e somente CLI precisam de chave de API (veja Avançado: Conecte com uma chave de API).

Passo 1: Conecte sua ferramenta de IA via OAuth

A única coisa que você cola é a URL do servidor da Flyweel:

https://api.flyweel.co/functions/v1/mcp-server/mcp

Você será redirecionado para fazer login e aprovar o acesso. Nenhuma chave é armazenada no seu cliente de IA.

Funciona para Claude na web e no aplicativo desktop.

  1. Abra Configurações → Conectores → Adicionar conector personalizado
  2. Cole a URL do servidor acima e clique em Adicionar
  3. Clique em Conectar e aprove o acesso

As ferramentas da Flyweel agora aparecem em qualquer chat.

Os conectores do ChatGPT exigem Modo Desenvolvedor (Plus/Pro e superior).

  1. Configurações → Apps e Conectores → Configurações avançadas → ative o Modo desenvolvedor
  2. De volta em Apps e Conectores, clique em Criar
  3. Insira um nome, cole a URL do servidor acima, defina Autenticação como OAuth
  4. Clique em Criar, depois faça login e aprove o acesso

Acesse sua página de configurações de API e MCP e clique no botão de um clique Adicionar ao Cursor. O Cursor adiciona o servidor para você — aprove o acesso quando solicitado e pronto.

Opcional — adicione manualmente: abra Configurações → MCP → Adicionar Servidor, dê um nome, cole a URL do servidor acima e aprove o acesso. (OAuth, sem necessidade de cabeçalho.)

Acesse sua página de configurações de API e MCP e clique no botão de um clique Instalar no VS Code. O VS Code adiciona o servidor para você — aprove o acesso quando solicitado e pronto.

Opcional — adicione manualmente: abra a Paleta de Comandos, execute MCP: Adicionar Servidor, escolha um servidor HTTP, cole a URL do servidor acima e aprove o acesso.

Execute isto no seu terminal:

claude mcp add --transport http flyweel-mcp-server https://api.flyweel.co/functions/v1/mcp-server/mcp

O Claude Code abre um navegador para você fazer login e aprovar o acesso — sem necessidade de chave de API.

Passo 2: Teste sua conexão

Pergunte à sua IA:

"Quais contas do Google Ads eu tenho conectadas à Flyweel?"

Se você vir suas contas listadas, está funcionando.

Avançado: Conecte com uma chave de API

A maioria dos usuários deve conectar via OAuth acima. Use uma chave de API apenas para uso headless / CI, ou clientes que não suportam OAuth (muitas ferramentas CLI).

Mostrar configuração de chave de API

Obtenha uma chave de API

  1. Acesse app.flyweel.co → Configurações → API e MCP
  2. Em Avançado: use uma chave de API em vez disso, clique em Gerar chave de API (ou Criar Token para nomear a sua)
  3. Copie agora. Você não a verá novamente.

Sua chave começa com fwl_ seguida de 64 caracteres. Mantenha-a segura. Não a compartilhe. Gerencie ou revogue chaves a qualquer momento na mesma página — desative uma chave para desativá-la ou exclua-a para revogar o acesso imediatamente.

Adicione a chave ao seu cliente

Cole isto no arquivo de configuração MCP do seu cliente (ex.: ~/.claude.json, ~/.cursor/mcp.json, ou um .mcp.json local do projeto):

"mcpServers": {
  "flyweel-mcp-server": {
    "type": "http",
    "url": "https://api.flyweel.co/functions/v1/mcp-server/mcp",
    "headers": {
      "Authorization": "Bearer fwl_YOUR_TOKEN_HERE"
    }
  }
}

Substitua fwl_YOUR_TOKEN_HERE pela sua chave.

  • O cliente só aceita cabeçalho personalizado? Substitua Authorization: Bearer por X-API-Key e remova o prefixo Bearer (o valor é apenas o token fwl_…).
  • VS Code: salve em .vscode/mcp.json e renomeie a chave mcpServers para servers.

Ou adicione pela linha de comando com o Claude Code:

claude mcp add --transport http flyweel-mcp-server https://api.flyweel.co/functions/v1/mcp-server/mcp --header "Authorization: Bearer fwl_YOUR_TOKEN_HERE"

Ferramentas disponíveis

Basta conversar com sua IA como se estivesse falando com uma pessoa. Aqui está o que funciona.

Como verifico minhas contas de anúncios?

Comece aqui quando conectar pela primeira vez:

Tente IstoO Que Você Obtém
"Quais contas de anúncios eu tenho?"Todas as suas contas Google e Meta conectadas
"Mostre minhas contas do Google Ads"Apenas suas contas Google
"Mostre minhas contas Meta"Apenas suas contas Facebook/Instagram
"Quais campanhas estão em execução?"Todas as campanhas ativas em suas contas

Como verifico o desempenho dos anúncios?

Pergunte sobre como seus anúncios estão indo:

Tente IstoO Que Você Obtém
"Como estão meus anúncios?"Um resumo do desempenho das suas campanhas
"Qual é minha taxa de cliques?"Seu CTR em todas as campanhas
"Qual campanha recebe mais cliques?"Seu melhor desempenho por cliques
"Mostre minhas conversões"Quantos leads ou vendas seus anúncios geraram
"Qual é meu custo por conversão?"Quanto você paga por cada lead/venda

Como verifico os gastos com anúncios?

Pergunte sobre para onde vai seu dinheiro:

Tente IstoO Que Você Obtém
"Quanto gastei este mês?"Seu gasto total com anúncios
"Qual campanha custa mais?"Para onde vai a maior parte do seu orçamento
"Qual é meu custo por clique?"CPC médio em todas as campanhas
"Mostre gastos por campanha"Detalhamento de gastos por campanha
"Estou acima do orçamento?"Orçamento vs. gasto real

Como comparo campanhas?

Peça à sua IA para comparar:

Tente IstoO Que Você Obtém
"Compare meu desempenho Google e Meta"Comparação lado a lado
"Qual campanha tem o melhor CTR?"Classificação por taxa de cliques
"Qual campanha tem o menor custo por conversão?"Sua campanha mais eficiente
"Como este mês se compara ao mês passado?"Mudanças mês a mês

Como verifico períodos específicos?

Você pode perguntar sobre qualquer intervalo de datas:

Tente IstoO Que Você Obtém
"Mostre o desempenho da semana passada"Dados dos últimos 7 dias
"Como foi janeiro?"Dados de um mês específico
"Mostre os últimos 30 dias"Visão padrão do desempenho recente
"O que aconteceu ontem?"Instantâneo de um único dia

Como encontro problemas?

Peça à sua IA para identificar problemas:

Tente IstoO Que Você Obtém
"Quais campanhas estão pausadas?"Campanhas que não estão em execução
"Alguma campanha com zero conversões?"Desempenhos ruins para verificar
"Qual campanha tem o CPC mais alto?"Onde você pode estar pagando demais
"O que não está funcionando?"Análise da IA sobre pontos fracos

Como gerencio meus dados?

Você pode controlar a sincronização e quais contas está analisando:

Tente IstoO Que Você Obtém
"Sincronize meus dados do Google Ads"Aciona uma nova coleta de dados do Google
"Sincronize meus dados Meta"Aciona uma nova coleta de dados da Meta
"Meus dados estão sincronizando?"Status atual da sincronização e progresso
"Quais contas estou analisando?"Lista das contas selecionadas
"Pare de analisar [nome da conta]"Remove uma conta das suas consultas
"Adicione [nome da conta] à minha análise"Inclui uma conta nas suas consultas

Como obtenho respostas melhores?

Seja específico

Em vez de: "Como estão meus anúncios?"

Tente: "Qual é meu CTR e custo por conversão nas minhas campanhas de Pesquisa do Google este mês?"

Nomeie sua conta

Se você tiver várias contas, diga qual:

Em vez de: "Mostre minhas campanhas"

Tente: "Mostre campanhas na minha conta principal do Google Ads"

Faça perguntas de acompanhamento

Comece amplo e depois aprofunde:

  1. "Qual campanha tem mais conversões?"
  2. "Qual é o custo por conversão dessa?"
  3. "Como isso se compara ao mês passado?"

Peça comparações

Sua IA é boa em comparar coisas:

  • "Qual é melhor: minha campanha de Pesquisa ou minha campanha PMAX?"
  • "Compare minhas 3 principais campanhas por conversões"
  • "Minha conta Meta ou Google é mais eficiente?"

Peça recomendações

Sua IA pode ajudar você a pensar:

  • "Com base nesses dados, qual campanha devo escalar?"
  • "Qual campanha devo pausar?"
  • "Onde estou desperdiçando dinheiro?"

Quais dados posso ver?

MétricaO Que Significa
CliquesQuantas vezes as pessoas clicaram no seu anúncio
ImpressõesQuantas vezes seu anúncio foi exibido
CTRTaxa de cliques. Cliques ÷ impressões.
ConversõesCadastros, leads ou vendas dos seus anúncios
CustoQuanto você gastou
CPCCusto por clique. Gasto ÷ cliques.
CPMCusto por 1.000 impressões
CPA/CACCusto por conversão. Gasto ÷ conversões.
AlcancePessoas únicas que viram seu anúncio (somente Meta)
OrçamentoQuanto você definiu para gastar
StatusSe uma campanha está ativa, pausada ou removida

Quão atualizados estão meus dados?

Seus dados são sincronizados automaticamente do Google e da Meta:

PlataformaAtraso Típico
Google Ads4-6 horas atrás do tempo real
Meta Ads1-3 horas atrás do tempo real
TikTok Ads2-4 horas atrás do tempo real

Precisa de dados mais recentes? Peça à sua IA: "Sincronize meus dados do Google Ads" ou acesse seu painel Flyweel e clique em Sincronizar Agora.

Você também pode perguntar "Meus dados estão sincronizando?" para verificar o progresso.

O que o Flyweel MCP não pode fazer?

É somente leitura. Sua IA pode ver seus anúncios. Não pode alterá-los.

Não pode:

  • Pausar ou iniciar campanhas
  • Alterar orçamentos
  • Editar seus anúncios
  • Excluir nada

Suas campanhas estão seguras.

Outros limites:

  • Uma conta por pergunta (pergunte sobre cada conta separadamente)
  • Apenas números diários (sem detalhamento por hora)
  • Google Ads, Meta Ads e TikTok Ads (lançamento público no final de abril de 2026). LinkedIn e X ainda não são suportados.
  • Apenas dados de campanha (sem imagens criativas ou detalhes de público)
  • Atualização de dados depende da plataforma (Google: 4-6 horas, Meta: 1-3 horas de atraso)
  • 20 solicitações por segundo por token (mais que suficiente para uso normal)

Como mantenho minha conexão segura?

Acesso com reconhecimento de organização

As ferramentas MCP da Flyweel têm reconhecimento de organização. list_organizations lista todas as organizações às quais você pertence. Cada chamada atua na sua organização principal, a menos que você passe um id de org. O id é verificado por associação: nomear uma organização à qual você não pertence retorna Not a member of that organization. query_metrics aplica visualização de campanha para dados de anúncios e visualização de CRM para dados de CRM. select_ad_accounts exige permissão de gerenciamento de campanha na organização em que está sendo gravado. trigger_sync exige visualização de campanha na organização de destino (todos os quatro papéis a possuem) e tem limite de taxa. Conectar uma plataforma aplica gerenciamento de conexão no próprio fluxo OAuth. Seu token age como você, com seu papel, nada além disso.

OAuth não armazena chave — nada para vazar

Quando você conecta via OAuth (Claude, ChatGPT, Cursor, VS Code), não há chave para copiar, colar ou perder. Você faz login, aprova acesso somente leitura, e a Flyweel — não sua ferramenta de IA — mantém a credencial. Para cortar o acesso de um cliente, desconecte o conector Flyweel na ferramenta ou revogue-o em Configurações → API e MCP. É por isso que o OAuth é o caminho recomendado.

Chaves de API são segredos — trate-as como senhas

Se você usar uma chave de API para um cliente headless ou CLI, as regras usuais se aplicam:

  • Não compartilhe sua chave
  • Não a coloque em e-mails ou Slack
  • Não a envie para o Git nem a cole em logs

Crie uma chave separada por cliente e dê a ela um nome claro ("Work Laptop - Claude Code", "CI - nightly report"). Se uma vazar ou um dispositivo for perdido, desative ou exclua apenas essa chave — as outras continuam funcionando.

Desative ou Exclua Chaves que Você Não Usa

Vá em Settings → API & MCP. Use o botão para desativar uma chave ou clique no ícone de lixeira para excluí-la. Excluir revoga o acesso imediatamente.

Perguntas Frequentes

O que é MCP?

MCP significa Model Context Protocol. É um padrão para ferramentas de IA como o Claude se conectarem a aplicativos e dados externos. Pense nele como um plugue universal que permite que sua IA converse com outros softwares.

Para que serve o Flyweel MCP?

O Flyweel MCP permite que você faça perguntas à sua IA sobre suas campanhas do Google Ads e Meta Ads. Em vez de entrar nos painéis e navegar pelos menus, você pergunta em linguagem simples e recebe respostas com dados reais.

Quais ferramentas de IA funcionam com o Flyweel MCP?

O Flyweel MCP funciona com Claude (web e desktop), ChatGPT, Cursor, VS Code, Windsurf, Zed e outros. Qualquer ferramenta de IA que suporte MCP funcionará. Claude, ChatGPT, Cursor e VS Code se conectam via OAuth (sem necessidade de chave de API).

Quais plataformas de anúncios o Flyweel MCP suporta?

O Flyweel MCP suporta Google Ads, Meta Ads (Facebook e Instagram) e TikTok Ads (lançamento público no final de abril de 2026). Isso inclui Search, Display, Shopping, PMAX e YouTube no Google; Feed, Reels e Stories no Meta; e In-Feed e Spark Ads no TikTok. O Pipedrive CRM também está disponível para perguntas sobre negócios, funil, velocidade e taxa de vitórias.

O Flyweel MCP pode alterar minhas campanhas?

Não. O Flyweel MCP é somente leitura. Sua IA pode visualizar seus dados de anúncios, mas não pode pausar campanhas, alterar orçamentos ou editar nada. Suas campanhas estão completamente seguras.

Preciso de uma chave de API?

Não — a maioria das pessoas não precisa. Claude, ChatGPT, Cursor e VS Code se conectam via OAuth: você cola a URL do servidor do Flyweel, faz login e aprova o acesso. Uma chave de API é necessária apenas para uso headless / CI ou clientes CLI que não suportam OAuth.

Como o OAuth mantém meus dados seguros?

Você faz login no Flyweel e aprova o acesso somente leitura — nenhum segredo é armazenado na sua ferramenta de IA. A conexão é limitada à leitura dos seus dados de anúncios (não pode alterar campanhas), e você pode revogá-la a qualquer momento em Settings → API & MCP ou desconectando o conector na sua ferramenta de IA. Como não há chave para copiar ou colar, não há nada para vazar.

Qual transporte o Flyweel MCP usa?

Streamable HTTP — o padrão remoto-MCP atual. Há uma única URL de servidor (https://api.flyweel.co/functions/v1/mcp-server/mcp); seu cliente cuida do resto.

Como obtenho meu token de API do Flyweel?

A maioria dos clientes não precisa de um — conecte-se via OAuth. Se você precisar de uma chave para um cliente headless ou CLI, faça login em app.flyweel.co, vá em Settings → API & MCP e, em Advanced: use an API key instead, clique em Generate API key (ou Create Token para nomear a sua). Copie o token imediatamente; você não o verá novamente.

Como é uma chave de API do Flyweel?

Se você estiver usando o fallback de chave de API, sua chave começa com fwl_ seguida de 64 caracteres — uma longa sequência de letras e números. Mantenha-a privada como uma senha. (Conexões OAuth não usam uma chave visível.)

Quanto tempo leva a configuração?

A maioria das pessoas conclui a configuração em menos de 5 minutos. Para clientes OAuth, basta colar a URL do servidor do Flyweel e aprovar o acesso — sem arquivo de configuração ou token para gerenciar.

Meus dados são armazenados nos servidores do Flyweel?

Sim. O Flyweel sincroniza seus dados de anúncios para fornecer respostas rápidas. Seus dados são criptografados e armazenados com segurança. Você controla quando sincronizar e pode desconectar a qualquer momento.

Posso usar várias contas de anúncios?

Sim. Você pode conectar várias contas do Google Ads e Meta Ads ao Flyweel. Ao fazer perguntas, especifique sobre qual conta você quer saber.

Posso escolher quais contas minha IA analisa?

Sim. Se você tiver várias contas, pode dizer à sua IA quais incluir ou excluir das suas consultas. Peça "Stop analyzing [account name]" para remover uma, ou "Add [account name] to my analysis" para incluí-la novamente.

E se eu tiver vários dispositivos?

Basta conectar cada um via OAuth — cada conexão é independente, então não há nada para copiar entre dispositivos. Se você estiver usando chaves de API, crie uma chave separada por dispositivo e dê a ela um nome claro ("Work Laptop", "Home Mac"); se perder um dispositivo, exclua apenas essa chave e as outras continuam funcionando.

Como revogo o acesso?

Para uma conexão OAuth, desconecte o conector do Flyweel na sua ferramenta de IA ou revogue-o em Settings → API & MCP. Para uma chave de API, vá em Settings → API & MCP e desative-a com o botão, ou clique no ícone de lixeira para excluí-la. O acesso é cortado imediatamente.

Por que minha IA não está vendo o Flyweel?

Em clientes OAuth, reabra o conector do Flyweel e conclua a etapa de login e aprovação. Em clientes com chave de API, verifique três coisas:

  1. O arquivo de configuração está na pasta correta (ex.: ~/.claude.json, ~/.cursor/mcp.json)
  2. O arquivo é JSON válido com a entrada flyweel-mcp-server
  3. Seu JSON não tem erros de digitação. Valide-o em jsonlint.com.

Em seguida, reinicie completamente sua ferramenta de IA.

Por que vejo "Authentication Error"?

Se você estiver usando uma chave de API, ela está errada ou foi excluída. Vá em Flyweel → Settings → API & MCP e verifique se a chave existe e está ativa. Se não estiver, gere uma nova e atualize seu arquivo de configuração. Se você se conectou via OAuth, desconecte e reconecte o conector do Flyweel na sua ferramenta de IA.

Por que vejo "No accounts found"?

Você ainda não conectou suas contas de anúncios ao Flyweel. Vá em Settings → Connections e vincule suas contas do Google Ads ou Meta Ads. Aguarde um minuto para a primeira sincronização.

Como obtenho ajuda?

Envie um e-mail para team@flyweel.co para qualquer coisa. Respondemos em até 24 horas.

Solução de Problemas

"Authentication Error" ou "Invalid Token"

Sua chave de API está errada, inativa ou foi excluída.

Correção: Vá em app.flyweel.co → Settings → API & MCP. Verifique se a chave está lá e ativa. Se não estiver, gere uma nova e atualize seu arquivo de configuração. Em clientes OAuth, reconecte o conector do Flyweel.

"No accounts found"

Você ainda não conectou suas contas de anúncios ao Flyweel.

Correção: Vá em Settings → Connections no Flyweel. Conecte seu Google Ads ou Meta Ads. Aguarde um minuto para sincronizar.

A IA não vê o Flyweel

Em clientes OAuth, o conector não terminou de conectar. Em clientes com chave de API, o arquivo de configuração está no lugar errado ou tem um erro de digitação.

Correção (OAuth): Reabra o conector do Flyweel na sua ferramenta de IA e conclua a etapa de login e aprovação, depois reinicie a ferramenta.

Correção (chave de API):

  1. Verifique se o arquivo está nomeado exatamente como deveria
  2. Verifique se está na pasta correta:
    • Claude Code: ~/.claude.json
    • Cursor: ~/.cursor/mcp.json
    • VS Code: .vscode/mcp.json (renomeie a chave mcpServers para servers)
    • Projeto local: .mcp.json
  3. Verifique erros de digitação em jsonlint.com
  4. Reinicie completamente sua ferramenta de IA (saia e reabra)

Os dados parecem antigos

Correção: Vá ao seu painel do Flyweel. Clique em Sync Now na conta.

Referência Rápida

Detalhes da Conexão

ItemValor
URL do servidorhttps://api.flyweel.co/functions/v1/mcp-server/mcp
Nome do servidorflyweel-mcp-server
Autenticação (recomendada)OAuth — cole a URL do servidor, faça login, aprove
Autenticação (chave de API)Authorization: Bearer fwl_… (ou fallback X-API-Key: fwl_…)
Formato do tokenfwl_ + 64 caracteres

Plataformas Suportadas

PlataformaO que está incluído
Google AdsSearch, Display, Shopping, PMAX, YouTube
Meta AdsFacebook, Instagram (Feed, Reels, Stories)
TikTok AdsIn-Feed, Spark Ads (lançamento público no final de abril de 2026)
PipedriveNegócios, funil, velocidade, taxa de vitórias

Locais do Arquivo de Configuração (somente clientes com chave de API)

Clientes OAuth (Claude, ChatGPT, Cursor, VS Code) não precisam de arquivo de configuração.

FerramentaLocal
Claude Code~/.claude.json
Cursor~/.cursor/mcp.json
VS Code.vscode/mcp.json (renomeie mcpServers → servers)
Projeto local.mcp.json

Glossário

PalavraO que significa
MCPModel Context Protocol. Como as ferramentas de IA conversam com outros aplicativos.
TokenSua senha para o Flyweel. Começa com fwl_.
CTRTaxa de cliques. Cliques ÷ impressões.
CPCCusto por clique.
CPMCusto por 1.000 impressões.
CPA/CACCusto por aquisição/conversão.

Solicitar um Recurso

Tem uma ideia para uma ferramenta ou recurso? Conte para a gente.

Obter Ajuda

Envie um e-mail para team@flyweel.co para qualquer coisa.

Respondemos em até 24 horas.

Última atualização: julho de 2026