Como conectar sua IA ao Agencify

Use o Agencify pela conversa

Depois de conectar sua IA ao Agencify, você pode pedir que ela consulte clientes, mostre campanhas ou compare resultados. Por exemplo: “Quanto o cliente Loja Exemplo gastou em anúncios na última semana?”. MCP é o nome dessa conexão.

Este guia mostra como conectar e fazer seu primeiro pedido.

O que você precisa

• Uma conta Agencify com acesso ao Espaço de Trabalho que deseja usar.
• Um assistente de IA que permita adicionar conexões externas. Essa opção depende do aplicativo e do plano que você utiliza.
• Para consultar anúncios, as contas de Meta ou Google precisam estar conectadas ao Agencify e vinculadas ao cliente.

Como conectar

Escolha abaixo o assistente que você usa. O endereço do Agencify é o mesmo em todos:

https://www.agencifyapp.com/api/mcp

Você autoriza a conexão entrando na sua conta Agencify. Não precisa criar um token nem acrescentar uma senha ao endereço.

ChatGPT

1. No ChatGPT pelo navegador, abra Plugins. Clique no botão de adicionar e escolha Add custom MCP server.
2. Use Agencify como nome e cole o endereço acima em Server URL. Em autenticação, escolha OAuth, a opção que abre o login do Agencify.
3. Leia o aviso apresentado e crie o plugin em Create as a plugin. Instale o plugin criado e conclua a conexão com sua conta Agencify quando solicitado.
4. Em uma conversa, digite @ e selecione Agencify antes de fazer seu pedido.

Claude Desktop ou Claude pelo navegador

1. Abra Customize, depois Connectors. Clique em + Add e escolha Add custom connector.
2. Dê o nome Agencify e cole o endereço acima. Continue com a autenticação detectada e escolha Sign in now para entrar na sua conta Agencify.
3. Conclua a conexão. Na conversa, abra o botão + e habilite Agencify em Connectors.

Em contas de equipe, o administrador pode precisar adicionar o conector antes. Cada pessoa conecta a própria conta.

Claude Code

Com o Claude Code instalado, execute este comando no terminal:

claude mcp add --transport http agencify https://www.agencifyapp.com/api/mcp

Depois, abra o Claude Code e digite:

/mcp

Selecione Agencify e siga a opção de autenticação para entrar pelo navegador. Ao concluir, volte ao Claude Code e faça seu pedido.

Cursor

No projeto em que deseja usar o Agencify, abra o arquivo .cursor/mcp.json. Se ele ainda não existir, crie-o com este conteúdo:

{
  "mcpServers": {
    "agencify": {
      "url": "https://www.agencifyapp.com/api/mcp"
    }
  }
}

Se o arquivo já tiver outras conexões, acrescente apenas a entrada agencify dentro de mcpServers. Salve e abra a conexão Agencify nas configurações de MCP do Cursor para concluir o login pelo navegador.

Outros assistentes e conclusão do login

Use o mesmo endereço se o assistente aceitar uma conexão MCP com login pelo navegador. Se ele exigir uma chave fixa e não oferecer esse login, esse método de conexão ainda não é compatível com o Agencify.

Na página de autorização do Agencify, confira o Espaço de Trabalho e escolha o acesso. Para começar consultando dados, use leitura. Conclua e volte ao assistente. Se a opção de conexão não aparecer, confira o plano e as permissões da sua equipe no aplicativo utilizado.

Faça seu primeiro pedido

Envie esta mensagem:

“Mostre o nome do Espaço de Trabalho do Agencify conectado e quais clientes eu posso acessar.”

Confira se a resposta mostra o Espaço de Trabalho esperado. Depois, use o nome de um dos clientes nos próximos pedidos. Se houver nomes parecidos, peça à IA que mostre as opções antes de continuar.

Exemplos para usar no dia a dia

Troque Loja Exemplo pelo nome do seu cliente:

• “Mostre as campanhas ativas da Loja Exemplo.”
• “Compare os gastos e os resultados da Loja Exemplo nos últimos sete dias com o período anterior.”
• “Resuma o último Raio-X da Loja Exemplo e explique as sugestões. Não aplique nenhuma mudança.”

Inclua o cliente e o período quando pedir uma análise. Se precisar de dados mais recentes, peça para atualizar os dados desse cliente antes de responder. A atualização depende da conexão com Meta ou Google.

O que dá para fazer

Peça as tarefas abaixo pelo nome do cliente. As opções dependem do acesso autorizado, do seu plano e das contas de anúncios conectadas. Meta e Google podem oferecer ações diferentes.

Clientes e metas

• Buscar clientes e consultar detalhes, contas vinculadas e pessoas com acesso.
• Criar, editar ou excluir clientes. Vincular ou desvincular contas de anúncios e gerenciar colaboradores.
• Definir ou remover metas de custo por aquisição, custo por lead ou retorno sobre anúncios.
• Escolher se a IA apenas recomenda ou pode ajustar orçamentos, conforme o modo disponível para o cliente.

Equipe e Espaço de Trabalho

• Conferir o Espaço de Trabalho conectado, sua função e permissões.
• Consultar membros e convites pendentes. Convidar pessoas ou reenviar um convite.
• Alterar funções ou remover membros, com acesso administrativo.

Contas e integrações

• Listar contas Meta e Google e verificar problemas na conexão.
• Pedir o link para conectar Meta ou Google e terminar a autorização no navegador. Renovar a conexão Google ou sincronizar a lista de contas.
• Importar recursos de um cliente quando você pedir e retomar uma importação parcial.
• Desconectar uma integração com confirmação e acesso administrativo. Isso interrompe a sincronização das contas vinculadas para todos os clientes.

Campanhas e anúncios em veiculação

• Listar e filtrar campanhas. Consultar conjuntos e anúncios com métricas por período, incluindo prévias de textos Google ou imagens e vídeos Meta.
• Consultar as opções permitidas e criar campanhas Meta ou Google com recursos salvos. Preparar uma duplicação a partir de uma campanha existente.
• Editar a segmentação e a estrutura dos conjuntos, incluindo os nomes. Alterar anúncios, parâmetros de rastreamento dos links e orçamento diário.
• Ativar ou pausar campanhas, conjuntos e anúncios. Pausar ou ativar várias campanhas de uma vez e excluir campanhas.
• Atualizar os dados salvos de campanhas e anúncios, incluindo métricas e prévias Google.

Experimentos

• Consultar grupos, combinações testadas e resultados por período.
• Conferir combinações e orçamento antes de publicar. Criar grupos de experimentos com os recursos salvos.
• Renomear grupos e ajustar o orçamento por plataforma. Ativar ou pausar grupos e experimentos, ou excluir um grupo.

Públicos e recursos salvos

• Consultar públicos, anúncios salvos, listas de palavras-chave e zonas de conversão, com detalhes e resultados. Ver onde cada recurso é usado.
• Criar ou editar esses recursos, visualizar as mídias e criar públicos na Meta. O envio de contatos para públicos de lista continua no aplicativo.
• Ativar, pausar ou excluir recursos, conferindo antes o efeito nos experimentos associados. Editar um anúncio já publicado pode alterar o anúncio na Meta.
• Consultar, atualizar ou criar listas de palavras-chave negativas do Google. Ver as campanhas associadas e conferir o impacto antes de desvincular e excluir uma lista.

Imagens, vídeos e recursos da Meta

• Consultar Páginas, perfis Instagram e empresas. Encontrar pixels, eventos de conversão, conversões personalizadas e formulários de leads.
• Consultar públicos e contas WhatsApp. Verificar se uma Página pode anunciar no WhatsApp. O teste completo cria e remove uma campanha temporária.
• Verificar o endereço de destino de um anúncio e atualizar as conversões personalizadas.
• Enviar imagens ou vídeos por link para a conta Meta. Para uma imagem do computador, pedir a página de seleção e conferir o envio. Vídeos locais são enviados pelo aplicativo.

Resultados, Raio-X e recomendações

• Comparar métricas com o período anterior e atualizar séries de resultados por dia, semana, mês ou ano.
• Consultar o Raio-X salvo, os problemas encontrados e os itens envolvidos. Gerar um novo Raio-X para um cliente ou para os clientes acessíveis, dentro dos limites diários, e retomar a geração pendente.
• Pedir uma proposta de experimento ou a prévia de uma correção. Aplicar uma ação do Raio-X após confirmação e registrar o que foi visto, descartado ou resolvido.
• Consultar recomendações da IA e decisões pendentes. Aplicar uma recomendação ou um conjunto delas, ou dispensar uma sugestão.
• Executar ou retomar a análise de IA do Agencify. Ela pode ajustar orçamentos conforme o modo de IA do cliente. Gerar apenas o Raio-X não aplica as sugestões.

Relatórios e compartilhamento

• Consultar relatórios salvos por período e rede, ou atualizar os dados para gerar um novo retrato dos resultados.
• Gerar links de relatórios de resultados ou do histórico de ações. Consultar e abrir relatórios já compartilhados, respeitando a proteção de acesso.
• Obter os links de exportação em PDF que um agendamento tiver gerado.

Envios agendados

• Consultar agendamentos e histórico de entregas. Criar ou editar envios por e-mail ou WhatsApp, escolhendo destinatários e frequência.
• Ver a prévia do e-mail sem enviar, ou pedir um envio de teste para os destinatários escolhidos.
• Pausar, reativar ou excluir agendamentos. Executar agora um agendamento salvo de histórico de alterações.

Saldos e alertas

• Consultar e atualizar saldos, gastos do mês e limites das contas de anúncios. Ver os dados de pagamento disponíveis.
• Configurar, pausar ou excluir alertas de saldo baixo. Enviar um alerta de teste e acompanhar o resultado.
• Ajustar os dados de faturamento Google usados pelos alertas.

Histórico, acompanhamento e ajuda

• Consultar alterações recentes ou de um período e identificar ações feitas por pessoas ou pela IA.
• Acompanhar importações, criação de campanhas e experimentos, sincronizações, edição de anúncios e testes de alerta. Conferir o que terminou e o que falhou.
• Quando a operação permitir, cancelar ou retomar um trabalho e desfazer itens publicados por uma criação de campanha que falhou. Isso não é um desfazer geral de qualquer alteração.
• Buscar artigos da Central de Ajuda, consultar guias e ler instruções de tutoriais pela conversa.

Escolha o que a IA pode fazer

• Acesso de leitura: para consultar informações e entender resultados.
• Acesso de escrita: permite também fazer alterações, como editar campanhas. Use quando quiser executar tarefas pela conversa.
• Acesso administrativo: permite também gerenciar a equipe e desconectar integrações. Só escolha se precisar dessas tarefas.

A IA continua limitada ao que sua conta pode acessar no Agencify. Autorizar a conexão não dá acesso a clientes que você não pode ver. Faça login na página do Agencify, sem enviar sua senha na conversa.

Antes de pedir uma alteração

Um pedido para executar pode alterar sua conta de verdade. Criar uma campanha pode iniciar gastos, e mudar um orçamento afeta a veiculação. Nem toda alteração pede uma segunda confirmação.

Se quiser apenas uma sugestão, diga isso no pedido. Por exemplo:

“Quero avaliar uma mudança de orçamento na campanha de Natal da Loja Exemplo. Mostre a proposta, sem alterar nada.”

Quando decidir executar, confira o cliente e a campanha. Revise também o valor, quando houver. Se a IA apresentar uma confirmação, leia o resumo antes de aprovar.

Se algo não funcionar

• A IA pede para entrar novamente: abra a conexão do Agencify no assistente e refaça o login.
• Um cliente não aparece: confira o Espaço de Trabalho conectado e se sua conta tem acesso a esse cliente.
• A IA consulta, mas não consegue alterar: você pode ter autorizado apenas leitura. Confira também suas permissões no Agencify antes de autorizar mais acesso.
• Os números parecem antigos: confira o período e peça para atualizar os dados. Se a atualização falhar, verifique a conexão da conta em Integrações no Agencify.
• A resposta parou no meio de uma alteração: peça “Confira se o pedido anterior foi concluído antes de tentar novamente”. Isso ajuda a evitar repetir uma ação que já aconteceu.

Como conferir o resultado

Depois de uma alteração, peça à IA que diga o que foi concluído e o que ficou pendente. Abra o mesmo cliente no Agencify e confira a campanha ou o recurso alterado. “Em andamento” ainda não significa concluído.

Se precisar de ajuda, use o suporte desta página. Conte o que tentou fazer e qual mensagem apareceu. Não envie senhas nem dados privados de clientes.