Conecte Claude Code, Codex, Cursor ou Gemini CLI às suas contas de anúncios. Analise campanhas e peça ações com aprovação humana. Veja também os requisitos para ChatGPT e outros aplicativos de IA.
Novas conexões com Meta Ads estão indisponíveis no momento e aparecem como Em breve no FideFlow. Comece pelo Google Ads; não há data de liberação informada nesta página.
MCP no plano de R$ 99,90/mês · Diagnóstico inicial gratuito
Você mantém a decisão.
Escritas passam pela sua aprovação.
Uma conexão por canal
Chaves com permissão de leitura
Alterações com aprovação humana
O FideFlow Ads é um servidor MCP para conectar IA ao Google Ads. Novas conexões Meta Ads estão indisponíveis no momento. Ele entrega ferramentas ao aplicativo que você usa: o cliente precisa aceitar Streamable HTTP e OAuth compatível ou chave de API via Bearer. O modelo interpreta a pergunta; o cliente faz a conexão.
| IA ou aplicativo | Caminho de conexão | O que conferir |
|---|---|---|
| Claude Code | HTTP + Bearer documentados | Configuração por comando ou JSON; guia abaixo. |
| Claude Desktop, web e Cowork | Verificar autenticação no cliente | OAuth disponível no FideFlow; confira o fluxo aceito pela sua interface. O comando do Claude Code não configura essas interfaces. |
| ChatGPT | Conexão direta não validada | Depende do plano, workspace e autenticação oferecida pela interface. |
| Codex | HTTP + Bearer documentados | Endpoint e variável de ambiente na configuração MCP. |
| Gemini CLI | HTTP + headers documentados | Configuração com httpUrl; diferente do aplicativo Gemini web. |
| Antigravity IDE | MCP remoto documentado | Guia com serverUrl e chave Bearer; conexão FideFlow ainda não testada. |
| Cursor | HTTP + headers documentados | Servidor remoto em mcp.json; o modelo é escolhido no editor. |
| VS Code com Copilot | HTTP + headers documentados | Configuração própria em mcp.json com entrada segura para a chave. |
| n8n | Cliente e agente têm nós próprios | Guia diferencia MCP Client, MCP Client Tool e Server Trigger; teste autenticado pendente. |
| Cline | HTTP + Bearer documentados | Guia com type streamableHttp; teste autenticado pendente. |
| Roo Code | HTTP + Bearer documentados | Guia com type streamable-http; teste autenticado pendente. |
| Windsurf/Cascade | HTTP + headers documentados | Configuração do Cascade legado; limite de ferramentas e controles do administrador. |
| Devin Local/CLI | HTTP + headers documentados | Configuração depende da versão; guia separado do Cascade. |
| Perplexity | Conector remoto documentado | Confira acesso ao recurso, autenticação e primeira leitura; integração FideFlow não testada. |
| Grok | Conector documentado | Conector personalizado e API têm fluxos distintos; sessão FideFlow ainda não demonstrada. |
| Qwen Code | Cliente MCP documentado | HTTP e OAuth dependem da configuração e da versão; não equivale ao chat web Qwen. |
| Mistral Studio | Conector documentado | Connectors em prévia pública; confirme autenticação e condições da interface. |
| DeepSeek, Llama, Ollama e OpenRouter | Exigem aplicativo compatível | Modelo ou provedor não substitui o cliente que conecta e executa as ferramentas MCP. |
Leve o contexto das campanhas para a conversa em que você já trabalha. Explore algumas possibilidades do MCP.
“Compare o investimento e as conversões das minhas campanhas de Pesquisa nesta semana e na anterior.”
search_google_gaqlSomente leituraUse consultas GAQL de leitura para investigar os dados da conta Google Ads. Compare períodos equivalentes e peça uma explicação baseada nos indicadores retornados.
Consulta de dados da conta Google AdsExemplo ilustrativo. Nenhuma conta é consultada nesta página.Novas conexões Meta estão indisponíveis no momento. As ferramentas existentes para Facebook e Instagram dependem de uma conexão operacional e das permissões da conta; não contrate esperando conectar uma nova conta Meta agora.
Conecte IA ao Google Ads para investigar campanhas, palavras-chave e termos de pesquisa. Consulte dados com GAQL e trabalhe com campanhas de Pesquisa na conversa.
As ferramentas e os dados acessíveis dependem das permissões e da configuração de cada conta. Anúncios no YouTube dependem dos recursos da conta Google Ads; isso não representa uma integração com a gestão de canais do YouTube.
O FideFlow também tem ferramentas para o Perfil da Empresa no Google (antigo Google Meu Negócio), páginas do Facebook e Instagram, conforme a conexão e os escopos autorizados. Avaliações, publicações e dados orgânicos são operações diferentes das campanhas pagas. Conectar Meta Ads não libera automaticamente todos os ativos de um Business Manager.
Conectar uma IA às suas contas não precisa significar abrir mão do controle sobre a verba.
Autorize somente leitura ou permita solicitações de escrita, no consentimento OAuth ou na chave de API.
Uma alteração pedida via MCP fica pendente na área Aprovações do FideFlow.
A execução depende da sua confirmação. Campanhas novas começam pausadas.
Você configura o acesso uma vez e usa as ferramentas no seu cliente MCP compatível.
Crie sua conta no FideFlow e autorize Google Ads pelo login oficial. Novas conexões Meta Ads estão em breve.
Escolha o plano com MCP. Use OAuth no cliente compatível ou gere uma chave de API em MCP → Chaves de acesso. A criação exige perfil de proprietário ou administrador da organização.
Adicione o endpoint abaixo e conclua o login OAuth ou configure a chave, conforme o cliente. Comece com uma consulta de leitura.
Use sua chave de API no cliente. Nunca compartilhe a chave em uma conversa pública.
Requisito do cliente: MCP remoto via Streamable HTTP e OAuth compatível ou chave de API via Authorization: Bearer. A configuração varia entre assistentes.
Primeiro conecte suas contas no FideFlow e ative o plano com MCP. Os exemplos de código abaixo usam chave de API; clientes com OAuth seguem o login e o consentimento do FideFlow. Esses passos configuram o cliente; não executam campanhas. Abra o guia do seu aplicativo.
No Claude Code, registre o servidor remoto com o comando abaixo. Defina FIDEFLOW_MCP_API_KEY no ambiente do terminal com sua chave de leitura. Este exemplo usa a sintaxe de Bash/Zsh: o shell expande a variável antes de executar o comando. Não cole sua chave literalmente no histórico.
Novas conexões com Meta Ads estão indisponíveis no momento e aparecem como Em breve no FideFlow. Comece pelo Google Ads; não há data de liberação informada nesta página.
Terminal Bash ou Zsh com Claude Code instalado
claude mcp add --transport http fideflow-ads https://ads.fideflow.com.br/api/mcp --header "Authorization: Bearer $FIDEFLOW_MCP_API_KEY"No PowerShell, a referência à variável usa $env:FIDEFLOW_MCP_API_KEY. Com Claude Code instalado e sua chave de leitura disponível no ambiente dessa sessão, use o comando abaixo. O exemplo foi conferido com a documentação; a conexão autenticada no Windows ainda precisa ser validada.
if (-not $env:FIDEFLOW_MCP_API_KEY) { throw "Defina a chave MCP no ambiente desta sessão." }
claude mcp add --transport http fideflow-ads https://ads.fideflow.com.br/api/mcp --header "Authorization: Bearer $env:FIDEFLOW_MCP_API_KEY"O teste inicial verifica apenas se a variável está preenchida, sem mostrar seu valor. Não cole a chave literalmente no comando. Uma variável definida em outro terminal pode não chegar a esta sessão.
Use a sintaxe do shell em que você executa o cliente. No WSL, instale e execute Claude Code dentro do ambiente Linux; confira a variável nesse mesmo ambiente. Em Bash/Zsh, use o primeiro exemplo deste guia. No Windows com PowerShell, use a variante acima.
Se claude --version não encontrar o comando, confira a instalação e o PATH antes de investigar a conexão Google Ads. Esses comandos configuram Claude Code; o Claude Desktop tem seu próprio fluxo de conectores.
Instalação do Claude Code por ambienteVariáveis de ambiente no PowerShell
Confira a conexão com claude mcp list e, na conversa, peça para listar as contas disponíveis. Para Google Ads, selecione a conta e o período; novas conexões Meta Ads estão indisponíveis no momento. No Desktop, web ou Cowork, confira o fluxo de OAuth do conector remoto. O FideFlow oferece login e consentimento; o comando acima é específico do Claude Code com chave de API.
Documentação MCP do Claude CodeNo Codex, adicione este bloco à configuração MCP. A variável FIDEFLOW_MCP_API_KEY precisa estar disponível no processo que inicia o cliente. Comece solicitando apenas leitura de campanhas.
Novas conexões com Meta Ads estão indisponíveis no momento e aparecem como Em breve no FideFlow. Comece pelo Google Ads; não há data de liberação informada nesta página.
~/.codex/config.toml
[mcp_servers.fideflow_ads]
url = "https://ads.fideflow.com.br/api/mcp"
bearer_token_env_var = "FIDEFLOW_MCP_API_KEY"As ferramentas vêm do FideFlow; selecionar outro modelo no cliente não concede acesso a novas contas. Confira a distinção entre configuração local e ChatGPT web na seção abaixo; uma configuração do Codex não ativa ferramentas no navegador.
Documentação MCP do CodexNo Gemini CLI, acrescente o servidor ao objeto mcpServers da sua configuração, preservando servidores existentes. Use httpUrl para Streamable HTTP e deixe a chave na variável de ambiente.
Novas conexões com Meta Ads estão indisponíveis no momento e aparecem como Em breve no FideFlow. Comece pelo Google Ads; não há data de liberação informada nesta página.
~/.gemini/settings.json
{
"mcpServers": {
"fideflow-ads": {
"httpUrl": "https://ads.fideflow.com.br/api/mcp",
"headers": { "Authorization": "Bearer ${FIDEFLOW_MCP_API_KEY}" }
}
}
}Use /mcp para conferir o servidor e peça uma análise da conta escolhida. Esta configuração é do Gemini CLI; não habilita por si só um conector no aplicativo Gemini web.
Documentação MCP do Gemini CLINo Antigravity IDE, abra MCP Servers, Manage MCP Servers e View raw config. Acrescente o servidor ao objeto mcpServers, preservando os demais. O exemplo segue a documentação do cliente, mas a conexão autenticada com FideFlow ainda não foi testada. Substitua o marcador pela sua chave MCP de leitura apenas na configuração local; não envie a chave na conversa nem versione esse arquivo com credenciais.
Novas conexões com Meta Ads estão indisponíveis no momento e aparecem como Em breve no FideFlow. Comece pelo Google Ads; não há data de liberação informada nesta página.
Antigravity IDE — configuração MCP local
{
"mcpServers": {
"fideflow-ads": {
"serverUrl": "https://ads.fideflow.com.br/api/mcp",
"headers": { "Authorization": "Bearer SUBSTITUA_LOCALMENTE" }
}
}
}Este cliente usa serverUrl; não copie o campo httpUrl do Gemini CLI. Recarregue os servidores MCP e confira a descoberta de ferramentas antes de solicitar uma leitura da conta Google Ads escolhida. Novas conexões Meta Ads estão indisponíveis. A configuração do IDE não comprova funcionamento no CLI ou SDK. O caminho OAuth tem requisitos próprios de registro e callback; credenciais Google ADC não substituem a autenticação MCP do FideFlow. Revisão documental: 6 de setembro de 2026.
Documentação MCP do AntigravityAbra a configuração MCP do Cline e acrescente o servidor, preservando os existentes. Substitua o marcador pela chave MCP de leitura somente no arquivo local; não envie a chave na conversa nem versione credenciais. A conexão autenticada com FideFlow ainda não foi testada.
Novas conexões com Meta Ads estão indisponíveis no momento e aparecem como Em breve no FideFlow. Comece pelo Google Ads; não há data de liberação informada nesta página.
Cline — configuração MCP local
{
"mcpServers": {
"fideflow-ads": {
"type": "streamableHttp",
"url": "https://ads.fideflow.com.br/api/mcp",
"headers": {
"Authorization": "Bearer SUBSTITUA_LOCALMENTE"
},
"autoApprove": []
}
}
}Use type streamableHttp explicitamente; Cline e Roo Code usam grafias diferentes. Mantenha autoApprove vazio para revisar chamadas. Confira a descoberta das ferramentas e solicite a listagem de contas Google Ads antes de analisar campanhas. Se houver erro de autenticação, confira a chave e o cabeçalho Authorization; não troque para SSE para contornar a falha. Revisão documental: 6 de setembro de 2026.
Documentação MCP do ClineAbra a configuração MCP do Roo Code e acrescente o servidor, preservando os existentes. Substitua o marcador pela chave MCP de leitura somente no arquivo local; não envie a chave na conversa nem versione credenciais. A conexão autenticada com FideFlow ainda não foi testada.
Novas conexões com Meta Ads estão indisponíveis no momento e aparecem como Em breve no FideFlow. Comece pelo Google Ads; não há data de liberação informada nesta página.
Roo Code — configuração MCP local
{
"mcpServers": {
"fideflow-ads": {
"type": "streamable-http",
"url": "https://ads.fideflow.com.br/api/mcp",
"headers": {
"Authorization": "Bearer SUBSTITUA_LOCALMENTE"
},
"alwaysAllow": []
}
}
}Use type streamable-http explicitamente; Cline e Roo Code usam grafias diferentes. Mantenha alwaysAllow vazio para revisar chamadas. Confira a descoberta das ferramentas e solicite a listagem de contas Google Ads antes de analisar campanhas. Se houver erro de autenticação, confira a chave e o cabeçalho Authorization; não troque para SSE para contornar a falha. Revisão documental: 6 de setembro de 2026.
Documentação MCP do Roo CodeNo Devin Desktop, confira se o agente selecionado é Cascade. A documentação anterior do Windsurf redireciona para Devin Desktop, mas esta configuração pertence ao Cascade legado. Abra Devin Settings, Cascade e MCP Servers; preserve os servidores existentes. A variável FIDEFLOW_MCP_API_KEY deve conter sua chave de leitura no ambiente do editor. A conexão autenticada com FideFlow ainda não foi testada.
Novas conexões com Meta Ads estão indisponíveis no momento e aparecem como Em breve no FideFlow. Comece pelo Google Ads; não há data de liberação informada nesta página.
Cascade — ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"fideflow-ads": {
"serverUrl": "https://ads.fideflow.com.br/api/mcp",
"headers": {
"Authorization": "Bearer ${env:FIDEFLOW_MCP_API_KEY}"
}
}
}
}Cascade documenta limite agregado de 100 ferramentas ativas. Selecione as necessárias antes de listar contas e consultar Google Ads; não suponha que todo o catálogo fique habilitado simultaneamente. O acesso MCP pode depender de controles do administrador. Para Devin Local, use o guia específico abaixo; o arquivo do Cascade não configura esse agente. Revisão documental: 6 de setembro de 2026.
Documentação oficial de configuração MCPDevin Local usa a configuração MCP do Devin CLI. Confirme a versão: a partir da v3000.3 (Local 3.6), a documentação indica arquivos mcp_config.json dedicados; versões anteriores usavam mcpServers no config.json. Acrescente o servidor ao arquivo local, preservando os existentes. Substitua o marcador pela chave de leitura apenas no dispositivo; não publique credenciais. A conexão autenticada com FideFlow ainda não foi testada.
Novas conexões com Meta Ads estão indisponíveis no momento e aparecem como Em breve no FideFlow. Comece pelo Google Ads; não há data de liberação informada nesta página.
Devin v3000.3 ou posterior — .devin/mcp_config.local.json
{
"mcpServers": {
"fideflow-ads": {
"url": "https://ads.fideflow.com.br/api/mcp",
"transport": "http",
"headers": {
"Authorization": "Bearer SUBSTITUA_LOCALMENTE"
}
}
}
}Confira a descoberta de ferramentas e solicite uma leitura da conta Google Ads selecionada. Preserve os pedidos de aprovação do cliente; eles não eliminam a revisão de escrita no FideFlow. Chave Bearer não é oauthClientSecret. Cada cliente mantém sua autenticação. Estas instruções não configuram automaticamente o Devin hospedado em nuvem. Revisão documental: 6 de setembro de 2026.
Documentação oficial de configuração MCPAdicione este servidor remoto à configuração do Cursor. A variável FIDEFLOW_MCP_API_KEY deve estar no ambiente do editor. O mesmo conector atende aos canais autorizados na sua organização.
Novas conexões com Meta Ads estão indisponíveis no momento e aparecem como Em breve no FideFlow. Comece pelo Google Ads; não há data de liberação informada nesta página.
~/.cursor/mcp.json
{
"mcpServers": {
"fideflow-ads": {
"url": "https://ads.fideflow.com.br/api/mcp",
"headers": { "Authorization": "Bearer ${env:FIDEFLOW_MCP_API_KEY}" }
}
}
}Habilite o servidor nas configurações MCP do editor e peça a listagem de contas. O acesso às ferramentas depende do modo de agente e das permissões que você conceder.
Documentação MCP do CursorNo VS Code com suporte a MCP, use uma entrada protegida para solicitar a chave. O objeto de configuração se chama servers; ele é diferente do mcpServers usado por outros clientes.
Novas conexões com Meta Ads estão indisponíveis no momento e aparecem como Em breve no FideFlow. Comece pelo Google Ads; não há data de liberação informada nesta página.
.vscode/mcp.json
{
"inputs": [{
"type": "promptString", "id": "fideflow-key",
"description": "Chave MCP do FideFlow", "password": true
}],
"servers": {
"fideflow-ads": {
"type": "http",
"url": "https://ads.fideflow.com.br/api/mcp",
"headers": { "Authorization": "Bearer ${input:fideflow-key}" }
}
}
}No chat do VS Code, inicie o servidor e confira as ferramentas. Sessões do Agent Host não encaminham configurações com entrada interativa; nesse ambiente, use o método de credenciais documentado para ele.
Documentação MCP do VS CodeO caminho depende da interface. O FideFlow oferece OAuth e chave Bearer para o endpoint https://ads.fideflow.com.br/api/mcp, mas a conexão autenticada com o ChatGPT não foi validada nesta página. Novas conexões Meta Ads continuam indisponíveis no FideFlow.
Configuração local. A documentação da OpenAI descreve o compartilhamento de config.toml entre Codex CLI, extensão de IDE e a interface desktop indicada no guia. Confira se esse fluxo está disponível na sua instalação e se a variável da chave chega ao processo do cliente.
ChatGPT web. O navegador não lê seu ~/.codex/config.toml. Para conversas hospedadas no ChatGPT Work, a documentação descreve ferramentas MCP fornecidas por plugins, sujeitas aos controles do workspace. Isso não confirma que o FideFlow esteja disponível no catálogo: verifique o método de conexão oferecido pela sua interface antes de contratar.
Aplicação própria. A Responses API documenta servidores MCP remotos e o campo authorization. Esse caminho exige implementar uma aplicação; não configura automaticamente o ChatGPT web. Em qualquer fluxo, confira a organização, as permissões e o resultado de uma primeira consulta de leitura.
São controles diferentes. O papel do usuário no Google Ads define o acesso à conta. O servidor MCP define quais ferramentas oferece. No FideFlow, um acesso MCP somente de leitura recusa solicitações de escrita; quando a escrita é autorizada, a solicitação gera uma pendência para revisão em Aprovações.
Os escopos mcp:read e mcp:write pertencem à autorização MCP do FideFlow. Eles não alteram o papel do usuário no Google Ads. A API do Google Ads usa o mesmo escopo OAuth para leitura e escrita e respeita as permissões da conta. Já o servidor MCP oficial do Google é uma implementação distinta, documentada como somente leitura.
Antes de conectar sua IA, confira a conta selecionada, as ferramentas do servidor e as permissões concedidas. Concluir o OAuth não comprova acesso a todas as contas nem autorização para qualquer alteração.
Instalação. O guia oficial do Google descreve execução local e implantação em nuvem. Você configura e mantém essa instalação. No FideFlow, o endereço remoto do serviço é fornecido na plataforma; o aplicativo de IA precisa aceitar o transporte e a autenticação indicados neste guia.
Credenciais. A instalação oficial pede credenciais próprias do Google Cloud e um developer token do Google Ads. No FideFlow, você conecta a conta Google ao produto e configura separadamente o acesso MCP do assistente. A autorização do Google não substitui a autorização MCP.
Leitura e alterações. A versão descrita na documentação oficial é somente leitura. No FideFlow, as ferramentas de escrita autorizadas geram uma solicitação pendente em Aprovações. Confira a operação e a conta antes de aprovar; nenhuma dessas opções concede acesso a contas sem permissão.
Custos e manutenção. Para uma instalação própria, avalie hospedagem, configuração, atualizações e custos do assistente escolhido. No FideFlow, consulte o plano com MCP; a verba de anúncios e o assistente externo não estão incluídos. A escolha depende de quais operações você precisa e de quem manterá a conexão.
Permissões da API do Google AdsServidor MCP oficial do Google AdsUma conta de administrador, também chamada MCC, reúne o acesso a contas de anúncios. Para analisar campanhas com IA, identifique a conta de anúncios do cliente e o acesso disponível pela conexão Google autorizada. O identificador da gerenciadora não substitui o da conta que contém as campanhas.
Conexão Google, conta de anúncios e organização FideFlow são coisas diferentes. O plano vendido é individual, com uma conexão por canal; isso não significa uma única conta de anúncios, nem inclui equipe ou acesso ilimitado a clientes. As contas disponíveis dependem das permissões concedidas à conexão. Confira o plano e seus limites antes de contratar para uma agência.
O FideFlow procura contas acessíveis diretamente e contas de anúncios habilitadas sob as gerenciadoras encontradas. O caminho de acesso é registrado por conta. A lista inicial da API do Google contém acessos diretos e pode não representar toda a hierarquia de um MCC; concluir o OAuth não prova que todas as contas foram descobertas ou sincronizadas.
Exemplo de pedido: “Liste as contas Google Ads disponíveis nesta organização e conexão. Antes de analisar campanhas, confirme comigo a conta do cliente, o período e a conversão. Faça somente leituras.”
Este roteiro descreve o produto e os cuidados de seleção; a sessão autenticada em um assistente externo com MCC ainda não foi demonstrada neste guia. Consulte também as permissões de leitura e escrita e o guia de problemas de conexão.
Google: contas acessíveis e hierarquiaGoogle: modelo de acesso às contas
Use o n8n como cliente do servidor MCP do FideFlow. A configuração abaixo segue a documentação dos nós; a conexão autenticada com FideFlow ainda não foi testada. Novas conexões com Meta Ads estão indisponíveis no momento e aparecem como Em breve no FideFlow. Comece pelo Google Ads; não há data de liberação informada nesta página.
MCP Client executa uma ferramenta como etapa de um workflow. MCP Client Tool disponibiliza ferramentas ao AI Agent. MCP Server Trigger faz o caminho inverso: expõe ferramentas e workflows do n8n a clientes externos; ele não configura o acesso ao FideFlow.
https://ads.fideflow.com.br/api/mcp em MCP Endpoint URL.A credencial Bearer monta o cabeçalho Authorization. Se usar Header Auth, informe o nome Authorization e o valor Bearer seguido da chave; não confunda esse formato com o campo Bearer Token.
No MCP Client Tool, limite Tools to Include às ferramentas necessárias. A documentação consultada ainda descreve SSE Endpoint; confira o transporte oferecido pela sua versão antes de apontar ao endpoint Streamable HTTP do FideFlow. Não presuma que os campos de um nó sejam idênticos aos do outro.
Se uma ferramenta de escrita estiver autorizada no FideFlow, a solicitação continua sujeita à revisão em Aprovações. Agendar um workflow ou permitir a chamada no agente não elimina essa etapa. Não configure repetição automática de escrita como tentativa de resolver uma aprovação pendente.
MCP ClientMCP Client ToolMCP Server TriggerCredencial Bearer
O Perplexity documenta conectores remotos personalizados. Confira se o recurso está disponível na sua conta e autorizado pelo administrador. A conexão autenticada com FideFlow ainda não foi testada. Novas conexões com Meta Ads estão indisponíveis no momento e aparecem como Em breve no FideFlow. Comece pelo Google Ads; não há data de liberação informada nesta página.
https://ads.fideflow.com.br/api/mcp como URL HTTPS do servidor.A documentação menciona chave de API, mas não detalha seu cabeçalho. Não presuma compatibilidade apenas porque o conector foi salvo. OAuth pode exigir registro de cliente e callback; sua configuração e primeira leitura precisam ser verificadas antes da contratação.
O servidor MCP da API Perplexity fornece busca e raciocínio a outros aplicativos. Instalá-lo no Cursor ou Claude não conecta o aplicativo Perplexity às contas Google Ads. Aqui, o Perplexity é o cliente e o FideFlow fornece as ferramentas de anúncios.
Conectores remotos personalizados no PerplexityServidor MCP da API Perplexity
O caminho depende do aplicativo e da forma de integração. As opções abaixo foram conferidas na documentação dos provedores; nenhuma representa uma sessão autenticada com FideFlow demonstrada neste guia. Novas conexões com Meta Ads estão indisponíveis no momento e aparecem como Em breve no FideFlow. Comece pelo Google Ads; não há data de liberação informada nesta página.
A documentação do Grok descreve conectores MCP personalizados: na página Connectors, escolha New Connector e Custom, informe o endereço do servidor e conclua a autenticação disponível. O endereço do FideFlow é https://ads.fideflow.com.br/api/mcp. Confira se a opção aparece na sua conta e valide uma primeira leitura antes de contratar para esse fluxo.
Para uma aplicação própria, a API da xAI também documenta MCP remoto com Streamable HTTP ou SSE, autenticação e filtro de ferramentas. Esse é outro caminho de configuração. A documentação informa que o parâmetro require_approval da interface compatível com Responses não é suportado; não o use como prova de confirmação humana. As aprovações de escrita do FideFlow continuam sendo uma etapa própria.
Grok: conectores personalizadosxAI: ferramentas MCP remotas na API
Qwen Code é um cliente que documenta servidores MCP em settings.json e pelo comando qwen mcp add. Para Streamable HTTP, o campo é httpUrl; url corresponde ao transporte SSE. A documentação também descreve headers e OAuth. Configurar esse cliente não configura automaticamente o chat web Qwen nem qualquer aplicativo que use seus modelos.
Confira o escopo de configuração, o servidor listado no comando /mcp e a autenticação oferecida pela versão instalada. Preserve as confirmações de ferramentas; não ative confiança irrestrita apenas para concluir a conexão. Documentação MCP do Qwen Code.
O Mistral Studio documenta Connectors como servidores MCP registrados para uso em conversas e agentes. O fluxo inclui cadastrar o endereço, definir a visibilidade, autenticar quando necessário e listar ferramentas. O recurso está documentado como prévia pública; confirme as condições da interface antes de usar.
Os conectores do Vibe Work e as integrações de uma aplicação via Studio têm seus próprios fluxos. Usar um modelo Mistral em outro aplicativo não transfere essas configurações. O FideFlow não está sendo apresentado aqui como conector de catálogo aprovado. Mistral Studio: ConnectorsCadastro e autenticaçãoConectores no Vibe Work.
É preciso que a aplicação obtenha os dados autorizados e os entregue ao modelo. Na API do DeepSeek, Tool Calls retorna uma solicitação de função; o código da aplicação executa a função e devolve o resultado. Para acessar o FideFlow por MCP, esse código ou cliente precisa implementar a conexão, a autenticação e a execução das ferramentas. A documentação de chamadas de função não comprova um conector no chat web DeepSeek.
Ao escolher um modelo Llama, confirme também o suporte a ferramentas da versão e do aplicativo. Selecionar o modelo, sozinho, não conecta uma conta Google Ads. DeepSeek: fluxo de Tool Calls.
A documentação do Ollama mostra a aplicação executando as ferramentas solicitadas pelo modelo e retornando seus resultados. Para usar MCP, escolha um cliente que também implemente esse protocolo. Rodar o modelo localmente não torna local a consulta ao FideFlow e ao Google Ads, nem elimina suas autorizações. Ollama: chamadas de ferramentas.
O OpenRouter publica um exemplo com cliente MCP que descobre ferramentas e converte suas definições para chamadas compatíveis com o modelo. O exemplo usa um servidor local via stdio; não é uma configuração pronta do endpoint remoto FideFlow. Para este serviço, valide Streamable HTTP, autenticação, permissões e um modelo com suporte às ferramentas necessárias. OpenRouter: uso de servidores MCPModelos e chamadas de ferramentas.
Em qualquer opção, confirme a conta Google Ads, o período e uma primeira consulta de leitura. A conexão do assistente não substitui a conexão Google no produto. Para fluxos prontos de outros clientes, consulte os guias de n8n, Perplexity e as permissões MCP.
Exemplos para contas com dados disponíveis. Novas conexões Meta Ads estão em breve. Escolha a conta, o período e a conversão relevante antes de comparar resultados.
Uma auditoria precisa declarar o que foi examinado, a evidência de cada achado e o que ficou pendente. Este roteiro orienta o trabalho com um assistente conectado por MCP; não representa uma auditoria executada nem garante que todas as verificações estejam disponíveis por uma única ferramenta.
Prompt sugerido: “Prepare uma auditoria somente leitura da conta Google Ads que eu confirmar. Antes de consultar, registre objetivo, campanhas, período, moeda e conversão principal. Organize as etapas abaixo com fonte, atualização, cobertura e estado: verificado, pendente ou não aplicável com justificativa. Separe observações de hipóteses. Não altere orçamento, campanhas ou mensuração.”
Quando uma etapa está verificada? Quando a evidência responde à pergunta daquela etapa para o escopo declarado. “Verificado” não significa que a campanha está saudável. Se faltarem dados, marque pendente e explique o impacto; use não aplicável apenas com motivo explícito. Uma resposta bem escrita ou um resumo de métricas não substitui essas evidências.
A documentação de conversões do Google Ads distingue campos como Conversões e Todas as conversões e informa que os dados não aparecem instantaneamente. O tempo até a conversão também afeta a interpretação de períodos recentes. Não troque a métrica ou a janela sem registrar a diferença.
A pontuação de otimização e as recomendações da plataforma podem ajudar a organizar a revisão, mas não comprovam, sozinhas, lucro ou auditoria concluída. O resultado deste roteiro é uma avaliação do escopo acordado, com pendências visíveis; não é uma certificação automática da conta. Novas conexões Meta Ads continuam indisponíveis no FideFlow.
Exemplo sintético: todos os dados abaixo são fictícios. Não é uma consulta executada pelo MCP nem uma demonstração de resultado de cliente. O formato ilustra as informações que você deve pedir ao seu assistente.
Pergunta sugerida: “Na conta selecionada, mostre custo, cadastros e CPA por campanha nos últimos 7 dias completos. Identifique fonte, período, moeda, conversão e cobertura. Aponte dados ausentes e não altere campanhas.”
| Campanha | Custo | Cadastros | CPA |
|---|---|---|---|
| Marca | R$ 600,00 | 30 | R$ 20,00 |
| Pesquisa genérica | R$ 900,00 | 15 | R$ 60,00 |
| Total do exemplo | R$ 1.500,00 | 45 | R$ 33,33 |
Leitura possível: Marca tem CPA menor nesta amostra. Sem meta de CPA, qualidade dos cadastros e período anterior comparável, isso não basta para recomendar redistribuição de orçamento.
Dados ausentes: não há receita ou valor de conversão, portanto ROAS não foi calculado. Meta Ads não faz parte deste exemplo; novas conexões Meta continuam indisponíveis. Nenhuma alteração de campanha é representada.
Em uma resposta real, confira a conta, os dados retornados e a atualização da fonte. Períodos incompletos, contas diferentes ou conversões com definições distintas precisam ser identificados antes de comparar resultados.
GAQL é a linguagem de consulta do Google Ads. Peça à IA que prepare a consulta para revisão antes de executá-la. A leitura exige conexão autorizada e acesso à conta escolhida.
Prompt sugerido: “Prepare uma consulta GAQL com ID, nome, impressões e cliques por campanha nos últimos sete dias, sem incluir hoje. Explique os filtros. Não execute nem altere campanhas antes de eu conferir a conta e a consulta.”
Consulta ilustrativa, não executada:
SELECT
campaign.id,
campaign.name,
metrics.impressions,
metrics.clicks
FROM campaign
WHERE segments.date DURING LAST_7_DAYSO guia oficial de consultas Google Ads apresenta esses campos de desempenho. LAST_7_DAYS exclui hoje. Este exemplo agrega o período por campanha, sem filtrar status. Peça que a resposta identifique conta, datas efetivas, fuso e cobertura.
No MCP do FideFlow, search_google_gaql aceita consultas SELECT. Prefira uma ferramenta pronta quando ela já atender ao relatório. Confirme a conta: sem customerId explícito, a ferramenta usa a conta padrão da conexão.
Confira se o resultado é parcial: o retorno informa rowCount e truncated. São devolvidas até 500 linhas por padrão; maxRows permite até 1.000. Se truncated for verdadeiro, não apresente a soma das linhas recebidas como o total da conta. Mesmo sem corte, os filtros e o período limitam a cobertura.
CTR com dados fictícios: uma campanha com 300 cliques e 6.000 impressões tem CTR de 5%; outra, com 100 cliques e 4.000 impressões, tem 2,5%. O total é 400 ÷ 10.000 = 4%, calculado pelas somas. A definição oficial de CTR usa cliques divididos por impressões; multiplique por 100 para exibir o percentual. Com zero impressões, a divisão não está definida.
Nenhuma conta real foi consultada neste exemplo. Sem custo, conversões e receita, ele não permite calcular CPA ou ROAS nem concluir rentabilidade. Veja também o exemplo de relatório com CPA e dados ausentes.
Um termo de pesquisa é a consulta feita pela pessoa; ele não é necessariamente a palavra-chave cadastrada na campanha. Peça à IA que organize os termos disponíveis por conta, campanha e período e explique quais merecem investigação.
Prompt sugerido: “Analise os termos disponíveis nos últimos 30 dias completos da conta que eu confirmar. Identifique campanha, cliques, custo, conversões, moeda e cobertura. Considere a oferta e a conversão principal que eu informar. Separe observações de hipóteses e proponha perguntas de investigação antes de sugerir negativas. Não aplique alterações.”
Exemplo sintético: todos os dados são fictícios. Considere uma campanha de venda de software cuja conversão principal seja um pedido de demonstração. Estas três linhas ilustram a revisão; nenhuma conta real foi consultada.
| Termo fictício | Cliques | Custo | Pedidos atribuídos | O que investigar |
|---|---|---|---|---|
| contratar software de gestão | 30 | R$ 120 | 3 | CPA de R$ 40 nesta amostra. Confira qualidade dos pedidos e meta antes de avaliar o resultado. |
| curso de software de gestão | 20 | R$ 80 | 0 | Se cursos não fazem parte da oferta, investigue a intenção e a abrangência de uma eventual negativa. |
| software de gestão para comércio | 2 | R$ 8 | 0 | Poucos dados nesta amostra. Zero pedidos não demonstra desperdício. |
A soma é R$ 208, 52 cliques e três pedidos atribuídos apenas nestas linhas. Não é uma prova de economia. Conversões ausentes exigem conferir definição, acompanhamento e período antes de interpretar o gasto.
O relatório de termos de pesquisa do Google pode omitir consultas por critérios de privacidade. Uma resposta GAQL também pode ser limitada pelo número de linhas: confira truncated, filtros e período, como no exemplo de consulta GAQL. São limites diferentes; ausência de um termo não comprova que ele nunca acionou um anúncio.
A sugestão deve explicar o motivo, as evidências e o que falta confirmar. Nenhuma negativa foi aplicada neste exemplo. Uma ferramenta de cadastro de palavras-chave positivas não comprova suporte a negativas; confira a operação disponível antes de solicitar uma alteração.
ROAS compara o valor de conversão atribuído com o custo dos anúncios. Peça à IA que identifique a origem desse valor: receita de compras, valor estimado de leads e lucro são medidas diferentes.
Prompt sugerido: “Na conta Google Ads que eu confirmar, compare custo e valor de conversão por campanha em um período completo. Informe moeda, ação de conversão, atribuição, atualização e cobertura. Calcule o ROAS pelas somas e mostre dados ausentes. Não altere campanhas.”
Exemplo sintético: números fictícios, sem consulta ao MCP. Conta Loja Exemplo, BRL, de 1 a 31 de julho de 2026, no fuso America/Sao_Paulo. Ação simulada: Compra; valor da venda atribuído por último clique, com janela de 30 dias. Extração fictícia em 1 de setembro de 2026. As duas campanhas e todos os dias desse recorte estão representados.
| Campanha fictícia | Custo | Valor atribuído | ROAS |
|---|---|---|---|
| Marca | R$ 1.000 | R$ 5.000 | 5 vezes (500%) |
| Categoria | R$ 3.000 | R$ 9.000 | 3 vezes (300%) |
| Total do exemplo | R$ 4.000 | R$ 14.000 | 3,5 vezes (350%) |
O total é 14.000 ÷ 4.000 = 3,5; a média simples de 5 e 3 daria 4 e estaria errada. Com custo zero, a divisão não está definida. Valor ausente também não deve virar zero: informe que o ROAS não pode ser calculado.
Um ROAS maior não comprova lucro ou vendas incrementais. Confira margens, devoluções, qualidade da mensuração e atraso das conversões. Para comparar Google e Meta, apresente os relatórios separadamente: a mesma venda pode receber crédito nas duas plataformas. Novas conexões Meta Ads continuam indisponíveis no FideFlow.
O ROAS observado deste exemplo não é uma recomendação de meta. ROAS desejado é uma configuração de lances do Google; calcular a métrica não altera essa configuração. Veja também como revisar uma proposta de orçamento.
Prompt sugerido: “Confirme comigo conta, campanhas, conversão principal, CPA-alvo e verba disponível. Compare períodos completos e qualidade das conversões. Se houver fundamento, apresente orçamento atual, proposta, diferença, motivo e critério de revisão. Aguarde minha aprovação; não aplique a proposta automaticamente.”
Cenário inteiramente fictício. Em uma conta Google Ads de geração de leads, o responsável confirmou CPA-alvo de R$ 50 por lead qualificado e autorizou apenas preparar um teste de redistribuição de R$ 10 por dia, mantendo a soma dos orçamentos em R$ 150. Isso ainda não autoriza executar o teste.
No recorte simulado de 28 dias completos, a campanha A gastou R$ 1.400 e recebeu 40 leads qualificados: CPA de R$ 35. A campanha B gastou R$ 2.800 para 40 leads: CPA de R$ 70. Definição de lead, moeda e atribuição são iguais; o cenário supõe que qualidade e atraso das conversões já foram conferidos.
| Campanha | Atual | Proposta | Diferença |
|---|---|---|---|
| A | R$ 50 | R$ 60 | + R$ 10 (+20%) |
| B | R$ 100 | R$ 90 | − R$ 10 (−10%) |
| Soma | R$ 150 | R$ 150 | R$ 0 |
A hipótese é testar mais verba em A, cujo CPA observado ficou abaixo da meta confirmada. Antes de aprovar, confira demanda adicional, limitação por orçamento, estratégia de lances e eventuais orçamentos compartilhados. CPA menor, sozinho, não demonstra que a campanha conseguirá crescer com o mesmo custo por lead.
Defina a data de revisão considerando o atraso das conversões, o limite de gasto aceito e quais resultados levam a manter, reverter ou investigar o teste. Se faltarem dados para esses critérios, mantenha a proposta pendente. Os percentuais acima não são uma regra universal de otimização.
O orçamento diário médio do Google Ads não é um teto rígido de gasto por dia. A soma de R$ 150 não garante desembolso diário de R$ 150. A proposta não foi executada e não demonstra redução de CPA; uma solicitação real de escrita precisa passar pela aprovação correspondente no FideFlow.
Confira o endereço e as credenciais antes de repetir a configuração. Se a conexão funciona, mas os números divergem, confira atualização e cobertura dos dados.
/mcp. No cliente, use https://ads.fideflow.com.br/api/mcp, com transporte MCP HTTP.O horário da resposta da IA não comprova o horário de atualização dos dados. Confira se a ferramenta consultou a API ou leu dados sincronizados, qual período retornou e qual atualização foi informada. Se essa informação não estiver disponível, registre “atualização não informada”; não use o horário da conversa como substituto.
Prompt sugerido: “Na conta Google Ads que eu confirmar, identifique fonte, período solicitado e retornado, fuso, moeda, conversão e cobertura. Informe a atualização apenas quando houver evidência no retorno. Se houver divergência ou dado ausente, explique o limite antes de calcular ou recomendar. Não altere campanhas.”
Exemplo inteiramente sintético, sem consulta ao MCP. Conta Loja Exemplo, BRL, período de 1 a 7 de agosto de 2026, fuso America/Sao_Paulo, conversão “Cadastro”, mesma definição e atribuição nas duas leituras fictícias:
| Extração | Custo | Cadastros | CPA |
|---|---|---|---|
| 08h00 | R$ 700,00 | 10 | R$ 70,00 |
| 10h00 | R$ 700,00 | 14 | R$ 50,00 |
O CPA é custo dividido por cadastros: 700 ÷ 10 = 70 e 700 ÷ 14 = 50. O segundo retrato tem mais conversões registradas; isso não demonstra que a IA melhorou a campanha nem identifica, sozinho, a causa da diferença. Verifique o processamento e os ajustes da fonte antes de atribuir o resultado a uma mudança de gestão.
Use o modelo de relatório para separar resultado, cobertura e dados ausentes. Se a conta estiver incorreta, volte à conferência de contas e MCC. Este exemplo não comprova uma sessão autenticada nem define prazo de atualização garantido pelo FideFlow.
Confirme a organização e o método usado pelo assistente antes de escolher o acesso que deseja encerrar.
O proprietário ou administrador deve abrir MCP → Chaves de acesso, selecionar a chave e confirmar a revogação. Outros clientes que compartilham essa chave também perderão o acesso por ela. Ocultar a chave na tela não a revoga.
Abra MCP → Assistentes conectados. Em Seus acessos nesta organização, confira o assistente e confirme a desconexão. Esse fluxo remove a autorização daquele usuário, cliente e organização; não revoga todas as chaves nem os acessos dos demais usuários da empresa.
Remover o servidor apenas da configuração do aplicativo não comprova revogação no FideFlow. Confira o estado no painel e verifique se uma nova consulta com a credencial antiga é recusada. Não compartilhe a credencial para essa conferência. A revogação não desfaz alterações de campanhas já executadas nem apaga informações que o assistente tenha copiado.
Para encerrar também o acesso do FideFlow na conta Google, confira a gestão de conexões com terceiros do Google. Esse acesso é distinto da autenticação MCP e sua remoção pode interromper outras rotinas conectadas. Excluir uma conexão no painel FideFlow não equivale a revogar automaticamente o acesso no Google.
Os caminhos acima foram conferidos no código e nas telas da versão implantada. A revogação em uma sessão externa autenticada ainda não foi demonstrada neste guia.
Comece pelo diagnóstico gratuito das suas contas. Para levar as ferramentas ao seu assistente, ative o plano com MCP.
Começar com minhas contasCadastro e diagnóstico inicial sem cartão.R$ 99,90/mês
Novas conexões com Meta Ads estão indisponíveis no momento e aparecem como Em breve no FideFlow. Comece pelo Google Ads; não há data de liberação informada nesta página.
MCP (Model Context Protocol) é um protocolo de conexão entre aplicativos de IA e ferramentas externas. O servidor MCP do FideFlow disponibiliza dados e operações das contas conectadas por você. Google Ads é o caminho de conexão disponível; novas conexões Meta Ads estão em breve. O aplicativo da IA precisa aceitar o transporte e a autenticação do servidor.
Conecte o Google Ads no FideFlow pelo OAuth oficial, ative o plano com MCP e peça ao proprietário ou administrador da organização que crie uma chave de leitura em MCP → Chaves de acesso. No Claude Code, adicione o endpoint https://ads.fideflow.com.br/api/mcp por HTTP com Authorization Bearer. Depois, peça uma consulta de campanhas. Para clientes com OAuth, o FideFlow também oferece login e consentimento por organização. Claude no navegador, Desktop e Cowork têm configurações próprias; confira o método aceito na sua interface.
Novas conexões Meta Ads estão indisponíveis no momento. Para uma conexão já existente, o acesso pelo MCP depende da disponibilidade dos dados e das permissões; a existência de ferramentas não garante que a conta esteja operacional. Facebook Ads e anúncios do Instagram fazem parte da operação Meta Ads; os dados disponíveis dependem das permissões da conta.
O suporte a MCP no ChatGPT depende da interface, do plano e das políticas do workspace. O FideFlow oferece OAuth para clientes MCP e também aceita chave de API via Bearer. No OAuth, o acesso depende do login, da organização e das permissões autorizadas. A disponibilidade desses recursos no servidor não comprova uma conexão autenticada em todas as interfaces do ChatGPT. Codex e uma aplicação própria com a Responses API são caminhos com configuração documentada de credenciais, mas não equivalem a uma conexão nativa no ChatGPT.
O Gemini CLI documenta servidores MCP remotos com httpUrl e headers. Configure nele o endpoint do FideFlow e o Authorization Bearer. Isso permite usar as ferramentas das conexões disponíveis. Novas conexões Meta Ads estão em breve. A compatibilidade do Gemini CLI não deve ser interpretada como suporte automático do aplicativo Gemini no navegador.
A compatibilidade depende do aplicativo que executa o modelo. Modelos como Grok, DeepSeek, Qwen, Mistral e Llama precisam de um agente ou cliente que aceite MCP Streamable HTTP, autenticação compatível e uso de ferramentas. Esta página não certifica conexão direta com todos os aplicativos dessas marcas.
Clientes com MCP HTTP e headers configuráveis podem consumir o endpoint do FideFlow. Cursor e VS Code têm exemplos de configuração neste guia. Em fluxos n8n ou outros agentes, verifique o transporte e as credenciais aceitos pelo cliente MCP. O servidor continua exigindo aprovação no FideFlow para executar escritas.
O chat fica dentro do FideFlow Ads. O MCP disponibiliza ferramentas para um aplicativo externo de IA conectado à sua organização. Configurar um provedor de modelo no chat interno não configura automaticamente esse aplicativo externo.
Não. O diagnóstico inicial é gratuito e sem cartão. O acesso ao MCP e às chaves de API está no plano de R$ 99,90/mês. Você pode conhecer a análise das suas contas antes de escolher o plano.
As ferramentas de escrita do MCP geram solicitações pendentes. Você precisa aprová-las na área Aprovações do FideFlow antes da execução. Uma chave somente de leitura não permite solicitar escrita. Campanhas novas são criadas pausadas; a plataforma de anúncios também aplica suas próprias regras e permissões.
Não. Você conecta suas contas pelo login oficial de cada plataforma. O cliente MCP se autentica no FideFlow por OAuth ou por uma chave da organização, conforme o aplicativo. No OAuth, revise a organização e as permissões na tela de consentimento. No acesso por chave, guarde-a nas credenciais do cliente, nunca no texto da conversa nem em repositórios públicos. Os tokens Meta e Google não substituem essa autenticação.
Depende da ferramenta. Algumas consultam as APIs da plataforma, como a consulta GAQL ao Google Ads; outras usam dados sincronizados pelo FideFlow. Informe conta, período e fuso, e confira a última sincronização antes de concluir uma análise. Dados ausentes ou atrasados não significam resultado zero.
Quando houver dados acessíveis de cada canal, você pode pedir um relatório por plataforma e conta. Novas conexões Meta Ads estão indisponíveis no momento. CPA depende da definição de conversão; ROAS exige valor de conversão ou receita disponível. Janelas de atribuição diferentes e conversões duplicadas impedem somar os resultados dos dois canais como se fossem vendas únicas.
O produto tem ferramentas de Perfil da Empresa no Google, páginas do Facebook e Instagram, condicionadas às conexões, permissões e APIs disponíveis. Anúncios do Instagram pertencem à Meta Ads; dados orgânicos são outra operação. TikTok Ads, LinkedIn Ads, Microsoft Ads e GA4 não são apresentados aqui como integrações prontas deste MCP.
O plano de R$ 99,90/mês é individual e inclui uma conexão por canal. As contas disponíveis dependem do acesso dessa conexão. Não é uma oferta de equipes, conexões ilimitadas ou acesso automático a todas as contas de um MCC ou Business Manager.
Não. A verba de mídia é paga às plataformas. Assinaturas e consumo de Claude, ChatGPT, Gemini ou outro assistente externo seguem as condições do provedor escolhido.
Não. O FideFlow é independente. A Meta apresenta os Meta Ads AI Connectors para uso com ferramentas externas de IA; essa iniciativa é distinta do FideFlow. O Google documenta um servidor MCP próprio para Google Ads; no FideFlow, você utiliza um endpoint hospedado, com acesso por organização e aprovação de escritas. Compare canais disponíveis, instalação, permissões e custos. OAuth e nomes das plataformas não indicam parceria, certificação ou endosso. Novas conexões Meta Ads estão em breve.
Para comparar com o servidor do Google, consulte o guia oficial do Google Ads MCP server. A Meta Blueprint apresenta os Meta Ads AI Connectors. Essas referências não comprovam acesso para toda conta nem alteram a disponibilidade de novas conexões Meta no FideFlow. Confira os recursos e requisitos atuais antes de escolher.
Conteúdo revisado pela equipe FideFlow Ads em . Produto independente; marcas citadas pertencem aos respectivos titulares.