Crie um Fluxo de Verificação KYC com um Agente de IA (PT-BR)

Um fluxo de Conheça seu Cliente (KYC) é mais do que uma única verificação. Cadeias de integração reais combinam verificações — verificação do documento de identidade, confirmação da detecção de vida, validação de dados em um banco de dados, análise de risco de Lavagem de Dinheiro (AML) — e ramificam com base nos resultados, direcionando usuários sem problemas diretamente e aqueles sinalizados para revisão. Criar isso geralmente significa clicar em um editor sem código ou implementar chamadas de API manualmente. O servidor oficial Model Context Protocol (MCP) da Didit, juntamente com o Workflow Orchestrator, permite que um agente de IA faça isso a partir de um prompt. Aponte um agente para https://mcp.didit.me/mcp e ele pode compor um fluxo de trabalho multi-módulo, conectar um webhook, definir ramificações condicionais e publicá-lo — sem código, sem cliques. Este post mostra como.

Principais conclusões

• O servidor MCP da Didit expõe mais de 130 ferramentas em 11 categorias via Streamable HTTP em https://mcp.didit.me/mcp, incluindo uma categoria de Fluxos de Trabalho e Questionários.
• Um agente de IA pode compor um fluxo de trabalho KYC — verificação de identidade, detecção de vida, validação de dados e análise de AML — a partir de um único prompt em linguagem natural.
• O Workflow Orchestrator é um construtor visual sem código com ramificação condicional, testes A/B, webhooks e ativação de módulos com um clique; o agente o direciona programaticamente via MCP.
• A ramificação condicional permite que o fluxo de trabalho direcione os usuários com base no resultado — aprovar sessões limpas, enviar as de risco moderado para revisão manual — e o agente define essas regras para você.
• A autenticação é OAuth 2.1 + Proof Key for Code Exchange (PKCE) via business.didit.me, sem chave de API no servidor hospedado e acesso restrito à sua função no console.
• Conecte o Claude Code em uma linha: claude mcp add --transport http didit https://mcp.didit.me/mcp — as camadas MCP e Orchestrator são gratuitas.

Por que compor um fluxo de trabalho em vez de uma única verificação

Uma sessão KYC única é boa para um protótipo. A integração em produção precisa de orquestração: quais módulos executar, em que ordem e o que acontece em cada resultado. O Workflow Orchestrator da Didit lida com isso — é um construtor visual sem código com ramificação condicional, decisões aninhadas, testes A/B, webhooks e ativação de módulos com um clique. Tudo que o servidor MCP expõe a um agente é a mesma capacidade que você montaria arrastando módulos em uma tela.

A vantagem do caminho MCP é a velocidade de iteração. Você descreve o fluxo de trabalho que deseja, o agente o constrói, você o revisa e o ajusta na conversa — “adicione uma etapa de comprovante de endereço antes da AML” — sem sair do seu editor.

As ferramentas que um agente usa

O Model Context Protocol é um padrão aberto para agentes de IA chamarem ferramentas externas de forma consistente. O servidor da Didit é a implementação oficial, licenciado pelo MIT em github.com/didit-protocol/mcp, servido via Streamable HTTP em https://mcp.didit.me/mcp. De seus mais de 130 ferramentas em 11 categorias, uma construção de fluxo de trabalho toca em Descoberta (para ver módulos e fluxos de trabalho existentes), Fluxos de Trabalho e Questionários (para compor e publicar) e Webhooks (para conectar notificações). As categorias Verificação Independente e Monitoramento de Transações e AML dão suporte aos módulos individuais que você compõe.

Um único prompt que constrói todo o fluxo

Aqui está o tipo de instrução que produz um fluxo de trabalho completo e publicado:

“Crie um fluxo de trabalho KYC chamado 'Integração Padrão' que execute a verificação de identidade, em seguida, a detecção passiva de vida e correspondência facial, em seguida, a validação de dados e, em seguida, a análise de AML. Se a AML retornar uma ocorrência, direcione a sessão para revisão manual em vez de aprová-la automaticamente. Adicione um webhook para https://example.com/didit/hooks para sessões concluídas e, em seguida, publique-o.”

O agente compõe os módulos em ordem, define a ramificação condicional no resultado da AML para que as ocorrências passem para a revisão, enquanto as sessões limpas são aprovadas, registra o webhook para que seu backend seja notificado na conclusão e publica o fluxo de trabalho para que ele esteja ativo. Você pode então pedir que ele “crie uma sessão contra o Integração Padrão e me dê o link” para testar tudo de ponta a ponta.

Os acompanhamentos permanecem conversacionais: “adicione um teste A/B que envie metade do tráfego através da detecção ativa de vida em vez da passiva” ou “insira um questionário personalizado antes da etapa de identificação.” Cada alteração é um prompt, e o agente edita o fluxo de trabalho no local.

Ramificação condicional, feita em linguagem natural

A ramificação é onde os fluxos de trabalho compensam, e é a parte mais complicada de construir manualmente. Via MCP você descreve a regra e o agente a codifica. Aprovar em uma passagem limpa. Direcionar para revisão manual em uma ocorrência de AML. Exigir uma segunda tentativa de detecção de vida em uma pontuação baixa de correspondência facial. Acionar um módulo de comprovante de endereço apenas para usuários de regiões de maior risco. Como o Orchestrator suporta decisões aninhadas, você pode empilhá-las — e como o agente está dirigindo-o, você pode raciocinar sobre a lógica em inglês simples antes de se comprometer.

Os módulos que você pode compor abrangem o catálogo: Verificação de Identidade a US$ 0,15, detecção passiva de vida a US$ 0,10, correspondência facial a US$ 0,05, validação de dados, análise de AML a US$ 0,20 e muito mais. Um pacote KYC completo típico — identificação, detecção passiva de vida, correspondência facial e análise de IP — custa US$ 0,33, e você compõe exatamente os módulos que seu modelo de risco precisa.

Webhooks fecham o ciclo

Um fluxo de trabalho publicado precisa informar seus sistemas quando algo acontece. O agente registra um webhook através da categoria de ferramentas Webhooks, para que seu backend receba um evento quando uma sessão for concluída, aprovada ou sinalizada. Isso significa que o fluxo de trabalho que o agente constrói não é uma demonstração — ele está conectado à sua infraestrutura no momento em que é publicado. Você pode pedir ao agente para listar, atualizar ou remover webhooks da mesma forma que pediu para adicionar um.

Conectando seu cliente

Claude Code se conecta com um comando:

claude mcp add --transport http didit https://mcp.didit.me/mcp

Execute /mcp para concluir o fluxo de “Login com Didit” OAuth 2.1 + PKCE através de business.didit.me. Não há chave de API para gerenciar no servidor hospedado, e cada ação que o agente realiza respeita sua função no console em todos os escopos didit:management e didit:verification — portanto, um agente só pode construir e publicar fluxos de trabalho se sua função já puder.

Para Claude Desktop, Cursor, VS Code, Windsurf e Zed, adicione uma entrada JSON apontando para a mesma URL:

{
  "mcpServers": {
    "didit": {
      "type": "http",
      "url": "https://mcp.didit.me/mcp"
    }
  }
}

O ChatGPT Developer Mode funciona através do conector beta da OpenAI, então espere que seus passos mudem enquanto esse recurso estiver em beta. A matriz completa do cliente está nos documentos de visão geral do MCP.

Preços e o que é gratuito

O servidor MCP e o Workflow Orchestrator são ambos gratuitos — você paga apenas pelas verificações que um fluxo de trabalho executa. Cada conta recebe 500 verificações gratuitas por mês, e a inferência é inferior a 2 segundos em 220+ países, 14.000+ tipos de documentos e 48+ idiomas. Isso é espaço suficiente para construir um fluxo de trabalho com um agente, executar sessões de teste reais e confirmar que cada ramificação se comporta antes de enviar um único usuário de produção.

A Didit é Y Combinator W26, lucrativa, arrecadou US$ 7,5 milhões e está em execução em produção para mais de 1.500 empresas — então um fluxo de trabalho que um agente compõe sobre MCP é construído no mesmo mecanismo de orquestração que essas empresas integram todos os dias.

Comece grátis

Aponte um agente de IA para https://mcp.didit.me/mcp, descreva o fluxo de trabalho KYC que você deseja e deixe-o compor, ramificar, conectar o webhook e publicar. Crie seu espaço de trabalho e comece grátis com 500 verificações todos os meses, sem cartão de crédito necessário. Leia a visão geral do MCP, navegue pelo servidor de código aberto ou explore o hub de desenvolvedores para ver cada ferramenta de fluxo de trabalho que um agente pode alcançar.