Conexões de IA (MCP)

Com uma conexão de IA, um assistente como o Claude ou o ChatGPT, ou uma automação feita em n8n, Make ou Zapier, consegue ler e operar o seu Leadz: buscar e editar contatos, organizar o quadro do CRM, criar tarefas, montar funis, preparar disparos e responder conversas. A IA age sempre dentro das permissões que você escolher, e as ações de maior risco esperam a sua aprovação.

A ligação usa um padrão chamado MCP (Model Context Protocol), aceito por esses aplicativos.

#Antes de começar

• O recurso «Integração MCP» precisa estar no seu plano.
• Seu cargo precisa da permissão «Conectar IA (MCP)». Ela vem ligada para Dono e Administrador.
• Para dar à IA permissões de maior risco (enviar mensagens, criar disparos, publicar funis, ligar agentes, excluir), ative antes a Verificação em duas etapas (2FA) em Configurações › Perfil.

#O que a IA consegue fazer

As permissões são divididas em três grupos. Você marca só as que quiser.

Uma permissão aparece bloqueada quando o seu cargo ou o plano não a permitem. A IA nunca faz mais do que a pessoa que a conectou pode fazer.

#Conectar o Claude ou o ChatGPT

Esses aplicativos se conectam com o seu login do Leadz, sem token.

A conexão passa a aparecer na lista Conexões, como Cliente conectado.

#Conectar uma automação com token

Use este caminho para n8n, Make, Zapier, Cursor, Claude Code e outros programas que pedem um token.

No programa de automação, informe o Endereço do servidor MCP e mande o token no cabeçalho:

Authorization: Bearer SEU_TOKEN

A própria tela traz modelos prontos para copiar, um para cada caso: Claude Code, Cursor (mcp.json), n8n / Make / Zapier e Outros (mcp-remote). Use o endereço e os modelos que a tela mostrar.

#Aprovar o que a IA pede

As ações de maior risco não são feitas na hora. A IA faz o pedido e espera a sua decisão.

• Com o Leadz aberto, aparece um aviso na tela com o título «A IA pede sua aprovação». Leia o resumo e clique em Aprovar ou Recusar. O botão Decidir depois adia.
• Com o Leadz fechado, o pedido fica no sino de notificações e chega por e-mail.
• Exclusões sempre pedem aprovação. O aviso vem como «Exclusão pedida pela IA», e você precisa digitar o código de confirmação que ele mostra.

Todos os pedidos ficam em Aprovações da IA, que você abre pelo botão Aprovações. A aba Pendentes mostra o que espera decisão. A aba Histórico mostra o que já foi decidido.

Um pedido recusado ou vencido não volta sozinho. Se recusou sem querer, peça de novo à IA.

#Regras pré-aprovadas

Quem administra o workspace pode criar uma regra para uma ação que se repete, e a IA passa a executá-la sem perguntar a cada vez.

Uma regra pode ficar em modo de só observar antes de ser ligada. Exclusões nunca entram em regra.

#Acompanhar e controlar

Em Configurações › Conexões de IA:

• Uso hoje mostra quantas chamadas as IAs fizeram no dia e o limite do plano.
• Conexões lista cada IA ligada, com a quantidade de permissões, o último uso e o vencimento. As conexões de outras pessoas aparecem com a marca «de outra pessoa».
• Pausar suspende uma conexão. Retomar volta a ligar.
• Revogar corta o acesso na hora e não tem volta.
• Pausar todas as IAs interrompe todas as conexões do workspace de uma vez. Aparece para quem administra o workspace.
• Atividade recente registra o que cada IA fez, com data, ação e resultado.

#Segurança

• A IA herda os seus limites. Se você perde uma permissão no workspace, a IA que você conectou perde junto.
• Segredos nunca saem. Senhas, chaves de API e tokens das suas integrações não são entregues à IA. Ela só vê que estão configurados.
• Mensagens identificadas. O que a IA envia sai marcado como automação, com o nome do aplicativo e de quem aprovou.
• Dados pessoais mascarados. No modo Mascarados, a IA recebe e-mail e telefone parciais.
• Seus dados no aplicativo de IA. O aplicativo que você conecta recebe os dados que pedir, dentro das permissões dadas, e os trata conforme os termos do fornecedor dele.

#Problemas comuns

Aparece «Integração com IA ainda não disponível»

O recurso ainda não foi liberado para o seu workspace. Fale com o suporte para participar.

Aparece «Não incluída no seu plano»

O plano do workspace não inclui a conexão de IA. Veja os planos em sparkleleadz.com/planos.

Na janela de autorização aparece «Seu cargo não tem a permissão «Conectar IA (MCP)» neste workspace.»

Só Dono e Administrador têm essa permissão de fábrica. Peça a quem administra o workspace para liberar no seu cargo, ou peça que essa pessoa faça a conexão.

Aparece «Pedido de conexão vencido ou já decidido.»

A janela de autorização ficou aberta tempo demais ou já foi usada. Volte ao aplicativo de IA e comece a conexão de novo.

Uma permissão aparece bloqueada com «Seu cargo ou o plano não permitem»

Você só pode dar à IA o que o seu cargo e o plano permitem. Para as permissões de maior risco, confira também se a verificação em duas etapas está ativa.

Aparece «As IAs deste workspace estão pausadas»

Alguém clicou em Pausar todas as IAs. Nenhuma conexão age até um administrador clicar em Retomar as IAs.

A IA diz que não conseguiu fazer uma ação

Abra Aprovações: o pedido pode estar esperando a sua decisão. Depois confira Atividade recente para ver o resultado de cada ação.

Perdi o token

O token não aparece de novo. Clique em Revogar na conexão e crie um token novo.

#Veja também

• Visão geral das integrações
• API de eventos
• Webhook de saída