Como conectar ferramentas externas (MCP) ao agente
Ligue o CRM, o ERP ou a loja virtual da empresa ao agente de IA para ele consultar e agir nesses sistemas durante o atendimento.
2 min de leituraBásicoAtualizado em 12 de novembro de 2026
Onde fica no Cognizy
Videoaula em breve. Por enquanto, siga o passo a passo abaixo.
Com uma ferramenta externa conectada, o agente de IA consegue, no meio da conversa, buscar um cadastro, consultar um pedido ou registrar algo no sistema da empresa. A conexão usa o padrão MCP, oferecido por vários sistemas. Ações que alteram dados pedem a aprovação de um administrador, a não ser que você libere.
Onde fica no Cognizy
Antes de começar
- O seu sistema precisa oferecer um servidor MCP. Peça ao fornecedor, ou a quem cuida do sistema, o endereço (URL) e, se houver, o token de acesso.
- Só o dono e os administradores conectam ferramentas.
- A IA precisa estar ligada no atendimento (IA responde ou Fluxos + IA).
- Leva uns 5 minutos com o endereço e o token em mãos.
Passo a passo
- Passo 1:
Antes de começar, pegue no seu sistema o endereço do servidor MCP e, se ele pedir, um token de acesso.
- Passo 2:
No rodapé do menu, clique em Configurações.
- Passo 3:
Em IA, clique em Comportamento geral.
- Passo 4:
Role até Ferramentas conectadas e clique em Adicionar integração.
- Passo 5:
Preencha o Nome (como a equipe vai reconhecer o sistema) e a URL do servidor MCP. Se o sistema usa token, cole em Token de autenticação (opcional).
- Passo 6:
Clique em Testar conexão. O Cognizy avisa quantas ferramentas encontrou no sistema.
- Passo 7:
Com o teste aprovado, clique em Salvar.
- Passo 8:
A integração aparece na lista como Ativa. Em Gerenciar ferramentas, escolha quais ações rodam direto e quais pedem aprovação: deixe exigindo aprovação tudo o que altera dados.
Como saber que deu certo
A integração aparece em Ferramentas conectadas como Ativa. Em uma conversa de teste, peça ao agente algo que dependa do sistema (por exemplo, a situação de um pedido): ele consulta e responde.
Se der errado
Aparece Falha ao testar a conexão.
Confira se o endereço está completo (começa com https) e se o token está certo e ainda vale. Se o sistema limita quem pode acessar, peça ao fornecedor para liberar o Cognizy.
O teste encontrou zero ferramentas.
O servidor respondeu, mas não oferece nenhuma ação para esse token. Confira as permissões do token no seu sistema.
O agente não usa a ferramenta.
Confira se a integração está Ativa e se a pergunta do cliente tem a ver com o que a ferramenta faz. Ações de escrita ficam esperando aprovação em Para revisar.
Não sei se o meu sistema tem servidor MCP.
Pergunte ao fornecedor do sistema por "servidor MCP" ou "integração MCP". Se não tiver, a alternativa são as integrações por webhook e API, em Configurações › Integrações.
Próximo passo
Teste o agente no playground, em Empresa › Agentes de IA › Testar agentes.
Para desenvolvedores
Entre com a sua conta Cognizy para salvar o progresso.
Entrar