Conectar seu agente de IA à Uniafy (MCP)

O MCP liga o Claude, o Codex ou outro agente de IA à sua conta da Uniafy. Com ele, você pergunta em linguagem natural ("como foi o CPL do cliente X nesta semana?") e o agente lê campanhas, métricas, criativos e leads. Se a credencial permitir, ele também prepara mudanças nos anúncios e pede a sua aprovação.

A tela fica em Infra › MCP.

1. Crie uma credencial

Clique em Nova credencial e preencha:

• Nome: para saber depois onde ela está ("Gestor-Noite", "Claude Code — notebook").

• Validade: 7, 30, 90, 180 ou 365 dias (o padrão é 90). A data de vencimento aparece logo abaixo. Credencial vencida para de funcionar; use Renovar para estender a partir de hoje, sem trocar a chave.

• O que o agente pode fazer: marque só o que ele precisa.

  • Ler: vê números, campanhas, criativos e leads. Não muda nada. Toda credencial tem.
  • Escrever na Uniafy: cria e organiza coisas dentro da Uniafy, como peças no Estúdio. Não mexe nos anúncios.
  • Montar plano: prepara um plano de mudanças nos anúncios e deixa como rascunho. Ninguém é avisado e nada é executado.
  • Pedir execução: manda o plano para aprovação. Só roda quando alguém da equipe clicar em Autorizar.
  • Pausar e ativar direto: para o agente em que você confia. Ele pausa e liga campanha, conjunto e anúncio sem esperar, até o teto por dia que você escolher. Passou do teto, o pedido vai para aprovação.
  • Falar com o cliente: em breve.

  Algumas opções dependem de outras e se marcam sozinhas: para pedir execução, o agente precisa montar plano; para pausar e ativar direto, precisa poder pedir execução.

• Clientes que a credencial enxerga: Todos os clientes ou Só alguns. Com "Só alguns", o agente não vê nenhum outro cliente: nem nas listas, nem nos totais. Use essa opção para um freelancer ou um cliente final.

• Áreas que a credencial enxerga: Todas ou Só algumas (Campanhas e métricas, Criativos e Estúdio, Leads e rastreamento, Públicos e segmentação, Saldo e financeiro, MAIA e conhecimento). Passe o mouse numa área para ver o que ela inclui.

O rodapé resume em uma frase o que a credencial vai poder fazer. Confira antes de criar.

A chave aparece uma vez só, em Sua chave. Copie só a chave ou o comando do Claude Code logo abaixo, que já vem com ela. Se perder, revogue e crie outra.

Gestores e comerciais criam credencial só para os clientes que acompanham, e só com o que o cargo deles permite.

2. Conecte o agente

Claude Code

No terminal, rode o comando que a tela mostra. Na janela da credencial criada, ele já vem com a chave:

Confira com claude mcp list. Não precisa instalar nada.

Claude Desktop e Cursor

Copie o bloco de configuração da tela para o arquivo de MCP do aplicativo, troque SUA_CHAVE_AQUI pela chave e reinicie o aplicativo. As ferramentas da Uniafy aparecem sozinhas.

Outros agentes

Use o Endereço do servidor MCP da tela e a chave no cabeçalho de autorização, como no comando acima. O jeito de colar isso muda de um aplicativo para outro: veja a ajuda do seu agente.

3. O agente pede, você aprova

Quando o agente quer mudar um anúncio (orçamento, pausar, duplicar, trocar criativo), ele não muda sozinho: ele pede. O pedido aparece em Central da MAIA › Registro de ações do cliente, na faixa Esperando você, e no sino. Uma pessoa da equipe que cuida do cliente lê o pedido e decide. Veja Aprovar o pedido de um agente.

A única exceção é Pausar e ativar direto, se você der essa permissão: aí o agente pausa e ativa até o teto do dia, e cada ação fica no Registro com recibo e Desfazer.

4. O que fica de fora

• Google Ads: pelo MCP, o agente só lê os números das contas do Google. As mudanças no Google Ads são feitas pela MAIA, com plano e a sua aprovação.
• Mudanças que ainda não cabem num plano (como criar conjunto ou mexer na segmentação) não aparecem para o agente.

5. Acompanhe e revogue

A lista mostra, para cada credencial: o que ela pode fazer, os clientes, a validade (fica em âmbar perto de vencer), o último uso e as chamadas das últimas 24 horas.

• Ver registro: todas as chamadas do agente, com filtro por resultado (deu certo, negado, limite, virou pedido).
• Editar: muda o que o agente pode fazer. A chave continua a mesma.
• Revogar: a credencial para de funcionar na hora. Os pedidos que ela já fez continuam no Registro e ainda podem ser aprovados por uma pessoa.

Credenciais antigas

Chaves criadas antes das permissões aparecem com o selo Credencial antiga e um prazo de revisão. Elas continuam lendo e pausando e ativando direto, com recibo e Desfazer; qualquer outra mudança nos anúncios já vira pedido para a equipe aprovar. Clique em Revisar para escolher o que cada uma pode fazer.

Segurança

• A chave é uma senha da sua organização. Não cole em lugar público.
• Cada credencial tem limite de chamadas por minuto e por dia. Passou do limite, o agente recebe o aviso e tenta de novo depois.
• O que o agente escreve no pedido aparece como texto dele, nunca como instrução para a MAIA.
• Pedidos ao Estúdio feitos pela credencial ficam registrados com ela, e o custo entra no custo do mês do cliente.