Integrações com IA usando MCP

As Integrações com IA permitem usar um assistente compatível para consultar e gerenciar sua conta do Grupos Inteligentes.

A conexão usa o MCP (Model Context Protocol). Ele funciona como uma ponte segura entre o assistente e as funções que você autoriza.

O que Você Pode Fazer

Depois da conexão, você pode pedir ao assistente para:

Consultar seu plano, limites e configurações.
Procurar redirecionadores e ver suas configurações.
Listar os grupos de um redirecionador.
Consultar o resumo do painel e relatórios de desempenho.
Analisar dados agrupados de leads permitidos pelo seu plano.
Criar redirecionadores com configurações seguras.
Adicionar grupos a um redirecionador.
Remover um grupo após sua confirmação explícita.

Dica: Faça pedidos diretos, como: “Mostre o desempenho deste redirecionador nos últimos 30 dias” ou “Liste os grupos cheios deste redirecionador”.

Como Conectar um Assistente

Para usar as Integrações com IA, você precisa de uma assinatura ativa ou estar no período de teste. Sem isso, o item Integrações com IA fica desativado no menu.

Passo 1: Abrir as Integrações com IA

Entre no painel do Grupos Inteligentes.
No menu, clique em Integrações com IA.
Clique em Conectar um assistente de IA e escolha OpenCode ou Codex.
Avance por Escolher, Configurar e Autorizar. Você também pode abrir Ver configuração no cartão do assistente.

Essa tela mostra a configuração mais recente para o cliente escolhido.

O Claude Code ainda não aparece nessa tela. Consulte a configuração manual abaixo.

Passo 2: Adicionar o Grupos Inteligentes

OpenCode

Adicione ao OpenCode a configuração exibida no painel. Ela terá este formato:

{
  "mcp": {
    "grupos-inteligentes": {
      "type": "remote",
      "url": "https://api.gruposinteligentes.com/mcp"
    }
  }
}

Depois, execute o comando de autenticação mostrado no painel:

opencode mcp auth grupos-inteligentes

Codex

Execute os dois comandos mostrados no painel:

codex mcp add grupos-inteligentes --url https://api.gruposinteligentes.com/mcp
codex mcp login grupos-inteligentes

Claude Code

No terminal, adicione o servidor MCP remoto:

claude mcp add --transport http grupos-inteligentes https://api.gruposinteligentes.com/mcp

Depois:

Abra o Claude Code com o comando claude.
Digite /mcp.
Escolha grupos-inteligentes.
Inicie a autenticação e conclua a autorização no navegador.

Por padrão, essa configuração fica disponível somente no projeto atual. Para usá-la em todos os seus projetos, adicione --scope user ao comando.

Passo 3: Autorizar no Navegador

O cliente de IA abrirá uma página no navegador.
Entre na sua conta do Grupos Inteligentes, se necessário.
Confira o nome do cliente e todas as permissões solicitadas.
Clique em Autorizar cliente se concordar.

Volte para Integrações com IA e clique em Atualizar lista. O novo cliente aparecerá em Assistentes conectados.

Permissões da Conexão

Antes de autorizar, você verá o que o cliente poderá consultar e alterar:

Permissão	O que permite
Visualizar conta e plano	Consultar recursos, limites e configurações.
Visualizar redirecionadores e grupos	Consultar redirecionadores e seus grupos.
Visualizar desempenho	Consultar cliques, tendências, capacidade e relatórios agrupados.
Visualizar análises de leads	Consultar análises agrupadas disponíveis no seu plano.
Gerenciar redirecionadores	Criar redirecionadores dentro dos limites do plano.
Gerenciar grupos	Adicionar grupos e remover somente após sua confirmação.

O cliente de IA não pode:

Excluir redirecionadores ou sua conta.
Gerenciar cobranças ou formas de pagamento.
Consultar senhas, tokens ou outros segredos.
Acessar registros individuais de leads.
Exibir os links de convite dos seus grupos.

Pequenos conjuntos de dados de leads também são ocultados. Essa proteção reduz o risco de identificar uma pessoa.

Consultar a operação sem fazer alterações

As permissões whatsapp:read e automations:read liberam consultas sobre o WhatsApp e a automação. Elas podem aparecer com esses nomes na autorização.

Consulte o status registrado da conexão e o resultado de uma operação específica.
No Scale, inclusive no teste, consulte os grupos do WhatsApp, os vínculos pendentes, a fila, o histórico e as configurações de criação automática.
Confira a data da última atualização. Uma contagem indisponível não significa zero participantes.

Por exemplo: “Quais grupos ainda precisam de atenção?” ou “Por que a criação deste redirecionador está aguardando?”.

Essas consultas não fazem uma nova verificação no WhatsApp nem criam, editam, importam, cancelam ou repetem operações. Configuração salva não confirma execução. Estar na fila, criar o grupo e liberar o grupo no link são etapas diferentes. Se o resultado for desconhecido, confira antes de repetir a criação.

Conexões antigas mantêm o acesso aprovado anteriormente. Para incluir as novas consultas, use Revogar acesso e conecte o assistente de novo. Apenas atualizar a lista não concede novas permissões.

Como Usar Depois da Conexão

Abra o cliente conectado e escreva seu pedido em linguagem simples. Por exemplo:

“Mostre o resumo da minha conta nos últimos 30 dias.”
“Quais redirecionadores estão ativos?”
“Liste os grupos cheios do redirecionador 123.”
“Crie um redirecionador chamado Lançamento de Agosto com o endereço lancamento-agosto.”
“Adicione este grupo ao redirecionador 123: [link de convite].”

Para remover um grupo, informe o redirecionador e o grupo exatos. O assistente deve pedir sua confirmação antes de concluir a remoção.

Dica: Confira nomes e números antes de aprovar uma alteração. O assistente usa os mesmos limites e regras da sua conta.

Como Revogar o Acesso

Você pode desconectar um cliente a qualquer momento:

Acesse Integrações com IA no painel.
Encontre o cliente em Assistentes conectados. Use Ver permissões para conferir o acesso.
Clique em Revogar acesso.
Confira as informações e confirme.

O acesso desse cliente será interrompido imediatamente. Seus outros clientes e suas sessões normais continuarão funcionando.

Solução de Problemas

O navegador não abriu

Execute novamente o comando de autenticação do seu cliente.

No Claude Code, digite /mcp e inicie a autenticação novamente. Se o navegador concluir o acesso, mas não voltar ao Claude Code, copie a URL completa exibida no navegador e cole no Claude Code.

O cliente não aparece como conectado

Confirme que você clicou em Autorizar cliente. Depois, volte ao painel e clique em Atualizar lista.

A solicitação expirou ou está indisponível

Inicie a autenticação novamente pelo cliente de IA. A solicitação é temporária e pode ser usada apenas uma vez.

O item Integrações com IA está desativado

Confira se sua assinatura está ativa em Configurações > Plano atual. Durante o teste, o acesso também fica liberado.

Uma análise de leads não está disponível

As análises de leads dependem dos recursos incluídos no seu plano. As outras funções autorizadas continuam disponíveis.

Ainda precisa de ajuda?

Envie um e-mail para suporte@gruposinteligentes.com.