Blog · 1 de julho de 2026

MCP para KYC: Verificação de Identidade em Linguagem Natural (PT-BR)

O servidor Model Context Protocol (MCP) da Didit permite que um agente de IA crie uma sessão de Know Your Customer (KYC), obtenha o link de verificação e receba a decisão – documento, liveness e correspondência facial – por.

Por Didit1 de julho de 2026Atualizado 3 de jul. de 2026

As verificações Know Your Customer (KYC) sempre envolveram a integração de um SDK, o gerenciamento de webhooks e a consulta a um endpoint de decisão. O servidor oficial Model Context Protocol (MCP) da Didit simplifica todo esse processo em uma conversa. Aponte um agente de IA – Claude Desktop, Claude Code, Cursor ou qualquer cliente compatível com MCP – para https://mcp.didit.me/mcp e ele poderá criar uma sessão de verificação, retornar o link que seu usuário abrirá e obter a decisão final, tudo a partir de um prompt em linguagem natural. Nos bastidores, ele executa a mesma verificação de documentos, liveness e correspondência facial que impulsiona o onboarding de mais de 1.500 empresas em produção, com um custo de US$ 0,33 por verificação KYC completa. Este artigo mostra o que a camada MCP faz, como um agente executa um fluxo KYC de ponta a ponta e como conectá-lo em poucos minutos.

Principais vantagens

O servidor MCP da Didit expõe mais de 130 ferramentas em 11 categorias via Streamable HTTP em https://mcp.didit.me/mcp – hospedado ou auto-hospedado.
A autenticação é OAuth 2.1 + Proof Key for Code Exchange (PKCE) – “Entrar com a Didit” via business.didit.me, sem chave de API para o servidor hospedado. O acesso é restrito ao usuário e respeita sua função no console.
Um agente pode criar uma sessão KYC, exibir o link de verificação e obter a decisão sem que você precise escrever código para polling ou webhooks.
Uma verificação KYC completa (documento de identidade + liveness passivo + correspondência facial) custa US$ 0,33, com 500 verificações gratuitas por mês e inferência abaixo de 2 segundos.
A configuração no Claude Code é um único comando: claude mcp add --transport http didit https://mcp.didit.me/mcp, seguido de /mcp para fazer login.
A própria camada MCP é gratuita – você paga apenas pelas verificações bem-sucedidas.

O que é o servidor Didit MCP

O Model Context Protocol é um padrão aberto que permite que agentes de IA chamem ferramentas externas por meio de uma interface consistente. A implementação da Didit é o servidor MCP oficial para a plataforma de identidade e fraude, publicado sob a licença MIT em github.com/didit-protocol/mcp. Ele usa Streamable HTTP no endpoint de produção https://mcp.didit.me/mcp e você pode executá-lo hospedado ou auto-hospedado em seu próprio ambiente.

Ele oferece mais de 130 ferramentas em 11 categorias: Descoberta, Sessões (KYC e KYB), Fluxos de Trabalho e Questionários, Verificação Autônoma, Monitoramento de Transações e Anti-Lavagem de Dinheiro (AML), Usuários e Empresas, Listas (lista de bloqueio e lista de permissão), Casos, Relatórios/Auditoria/Alertas, Webhooks e Workspace/Faturamento. Para um fluxo KYC, você usará principalmente Descoberta (para encontrar seus fluxos de trabalho) e Sessões.

Autenticação sem chave de API

O servidor hospedado usa OAuth 2.1 com PKCE – o fluxo “Entrar com a Didit” via business.didit.me. Não há chave de API para colar em um arquivo de configuração para a configuração hospedada. Quando seu agente se conectar pela primeira vez, ele abre um navegador, você aprova o acesso e o token é restrito ao seu usuário. Isso significa que o agente só pode fazer o que sua função no console já permite, em dois escopos: didit:management e didit:verification. Se você for um membro com acesso somente leitura, o agente herda o acesso somente leitura. Este modelo restrito ao usuário mantém a automação dentro dos mesmos limites de permissão da interface do usuário do console.

Executando uma sessão KYC em linguagem natural

Uma sessão KYC na Didit agrupa as verificações de identidade essenciais: verificação de documento de identidade, liveness passivo para confirmar que uma pessoa real está presente e correspondência facial 1:1 entre a selfie e o retrato do documento. Depois que o servidor MCP estiver conectado, você não chama esses itens individualmente – você descreve o resultado desejado e deixa o agente orquestrar as ferramentas.

Um prompt realista seria:

“Crie uma sessão de verificação KYC para nosso fluxo de onboarding padrão, me forneça o link para enviar ao candidato e, em seguida, verifique e me informe a decisão assim que ele terminar.”

O agente chama a ferramenta de criação de sessão, que retorna uma URL de verificação hospedada. Você encaminha esse link para seu candidato (ou o adiciona ao seu e-mail de onboarding). Quando ele concluir o fluxo – tirando uma foto de seu documento de identidade e uma selfie – o agente usa as ferramentas de recuperação de sessão para verificar o status e relatar o resultado: aprovado, rejeitado ou em análise, com os campos do documento extraídos e a pontuação de correspondência. Sem endpoint de webhook, sem job cron e sem loop de polling manual do seu lado.

Para trabalhos de alto volume, você pode pedir ao agente para processar em lote: “Crie dez sessões KYC para esses candidatos e me forneça uma tabela de links.” Como as ferramentas são compostas, o agente lida com o envio e coleta os resultados.

Conectando seu cliente MCP

O Claude Code se conecta com um único comando:

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

Em seguida, execute /mcp dentro do Claude Code para iniciar o fluxo OAuth “Entrar com a Didit”. Depois de autenticado, as ferramentas Didit aparecerão em sua sessão.

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

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

O suporte para o Modo Desenvolvedor do ChatGPT está disponível por meio do fluxo beta do conector OpenAI; como essa superfície ainda está em beta, espere que as etapas de conexão mudem à medida que a OpenAI iterar. A matriz de clientes completa e os snippets de configuração mais recentes estão nos documentos de visão geral do MCP.

O que a verificação KYC realmente verifica

Quando você executa a Verificação de Identidade por meio de uma sessão KYC, a plataforma lê o documento em relação a mais de 14.000 tipos de documentos suportados em mais de 220 países e territórios, em 48 idiomas. O liveness passivo confirma que a selfie é uma captura ao vivo e não uma foto de uma foto ou uma reprodução de tela. A correspondência facial pontua a selfie em relação ao retrato do documento. O resultado combinado é uma única decisão que seu agente relata, com base em mais de 200 sinais de fraude e inferência abaixo de 2 segundos.

Como é o mesmo mecanismo usado no onboarding em produção, o caminho MCP não é um ambiente de teste – a decisão que um agente retorna é a decisão que você tomaria. Você também pode rotear sessões por meio de um fluxo de trabalho personalizado para que o agente acione módulos adicionais (comprovante de endereço, rastreamento de AML, validação de banco de dados) quando sua lógica de risco exigir.

Preços e onde a camada MCP se encaixa

Uma verificação KYC completa – documento de identidade, liveness passivo e correspondência facial – custa US$ 0,33. Cada conta recebe 500 verificações gratuitas por mês e o servidor MCP não adiciona nenhum custo: você paga apenas pelas verificações bem-sucedidas, seja elas acionadas pelo console, pela API, por um SDK ou por um agente. Isso torna o MCP uma maneira fácil de prototipar um fluxo de identidade. Você pode conectá-lo a um agente, executar algumas sessões reais dentro de sua camada gratuita e confirmar as decisões antes de tocar em uma única linha de código de integração.

A Didit é Y Combinator W26, arrecadou US$ 7,5 milhões, é lucrativa e opera em mais de 220 países com 14.000 tipos de documentos e 48 idiomas – portanto, o mesmo endpoint MCP que o ajuda a prototipar dimensiona para volume de produção sem uma replataforma.

Comece de graça

Inicie um agente de IA, aponte para https://mcp.didit.me/mcp e execute sua primeira sessão KYC em linguagem natural hoje mesmo. Crie seu workspace e comece de graça – você recebe 500 verificações todos os meses sem custo, sem cartão de crédito necessário. Leia a visão geral do MCP, explore o código-fonte do servidor ou explore o hub do desenvolvedor para ver todas as ferramentas que seu agente pode acessar.