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

As verificações Know Your Customer (KYC) sempre envolveram a integração de um SDK, gestão de webhooks e validação de um endpoint de decisão. O servidor oficial Model Context Protocol (MCP) da Didit (https://didit.me/developers/mcp) simplifica este processo numa conversação. 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, devolver o link que o seu utilizador abrirá e validar a decisão final, tudo a partir de um prompt em linguagem natural. Em segundo plano, executa a mesma verificação de documentos, liveness e correspondência facial que impulsionam o onboarding para mais de 1500 empresas em produção, a 0,33€ por verificação KYC completa. Este artigo explica 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 conclusões

• O servidor MCP da Didit expõe mais de 130 ferramentas em 11 categorias através de HTTP Streamable em https://mcp.didit.me/mcp – alojado ou auto-alojado.
• A autenticação é OAuth 2.1 + Proof Key for Code Exchange (PKCE) – “Iniciar sessão com a Didit” através de business.didit.me, sem chave de API para o servidor alojado. O acesso é limitado ao utilizador e respeita o seu papel na consola.
• Um agente pode criar uma sessão KYC, apresentar o link de verificação e validar a decisão sem que tenha de escrever código de validação ou webhooks.
• Uma verificação KYC completa (documento de identificação + liveness passivo + correspondência facial) custa 0,33€, com 500 verificações gratuitas por mês e inferência inferior a 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 iniciar sessão.
• A camada MCP é gratuita – apenas paga por cada verificação bem-sucedida.

O que é o servidor Didit MCP

O Model Context Protocol é um padrão aberto que permite que agentes de IA chamem ferramentas externas através 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. Usa HTTP Streamable no endpoint de produção https://mcp.didit.me/mcp e pode ser executado alojado ou auto-alojado no seu próprio ambiente.

Inclui mais de 130 ferramentas em 11 categorias: Descoberta, Sessões (KYC e KYB), Fluxos de Trabalho e Questionários, Verificação Independente, Monitorização de Transações e Anti-Branqueamento de Capitais (AML), Utilizadores e Empresas, Listas (lista negra e lista branca), Casos, Relatórios/Auditoria/Alertas, Webhooks e Espaço de Trabalho/Cobrança. Para um fluxo KYC, irá principalmente interagir com a Descoberta (para encontrar os seus fluxos de trabalho) e Sessões.

Autenticação sem chave de API

O servidor alojado utiliza OAuth 2.1 com PKCE – o fluxo “Iniciar sessão com a Didit” através de business.didit.me. Não existe chave de API para colar num ficheiro de configuração para a configuração alojada. Quando o seu agente se conecta pela primeira vez, abre um navegador, aprova o acesso e o token é limitado ao seu utilizador. Isso significa que o agente só pode fazer o que o seu papel na consola já permite, através de dois âmbitos: didit:management e didit:verification. Se for um membro com acesso apenas de leitura, o agente herda acesso apenas de leitura. Este modelo limitado ao utilizador mantém a automatização dentro dos mesmos limites de permissão da interface do utilizador da consola.

Executar uma sessão KYC em linguagem natural

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

Um prompt realista seria:

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

O agente chama a ferramenta de criação de sessão, que devolve uma URL de verificação alojada. Transmita esse link ao seu candidato (ou adicione-o ao seu e-mail de onboarding). Quando este completar o fluxo – tirando uma fotografia do seu documento de identificação e uma selfie – o agente utiliza as ferramentas de recuperação de sessão para validar o estado e reportar 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 tarefa cron, sem ciclo de validação manual do seu lado.

Para trabalhos de maior volume, pode pedir ao agente para processar em lote: “Crie dez sessões KYC para estes candidatos e forneça uma tabela de links.” Como as ferramentas são compostas, o agente lida com o processamento em lote e agrega os resultados.

Conectar o seu cliente MCP

O Claude Code conecta-se 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 “Iniciar sessão com a Didit”. Uma vez autenticado, as ferramentas da Didit aparecem na sua sessão.

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

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

O suporte para o Modo de Desenvolvedor ChatGPT está disponível através do fluxo beta do conector OpenAI; como esta superfície ainda está em beta, espere que os passos de conexão mudem à medida que a OpenAI itera. A matriz de clientes completa e os últimos snippets de configuração estão disponíveis nos documentos de visão geral do MCP.

O que a verificação KYC realmente verifica

Quando executa Verificação de Identidade através de uma sessão KYC, a plataforma lê o documento em relação a mais de 14000 tipos de documentos suportados em mais de 220 países e territórios, em mais de 48 idiomas. O liveness passivo confirma que a selfie é uma captura ao vivo e não uma fotografia de uma fotografia ou uma reprodução de ecrã. A correspondência facial avalia a selfie em relação ao retrato do documento. O resultado combinado é uma única decisão que o seu agente reporta, apoiada por mais de 200 sinais de fraude e inferência inferior a 2 segundos.

Como é o mesmo motor usado no onboarding em produção, o caminho MCP não é um brinquedo de teste – a decisão que um agente devolve é a decisão que tomaria. Também pode encaminhar sessões através de um fluxo de trabalho personalizado para que o agente dispare módulos adicionais (comprovativo de morada, rastreio AML, validação de base de dados) quando a sua lógica de risco o exigir.

Preços e onde a camada MCP se encaixa

Uma verificação KYC completa – documento de identificação, liveness passivo e correspondência facial – custa 0,33€. Todas as contas recebem 500 verificações gratuitas por mês e o servidor MCP não tem custo adicional: apenas paga por verificações bem-sucedidas, quer sejam acionadas a partir da consola, da API, de um SDK ou de um agente. Isso torna o MCP uma forma fácil de prototipar um fluxo de identidade. Pode conectá-lo a um agente, executar algumas sessões reais dentro do seu nível gratuito e confirmar as decisões antes de tocar numa linha de código de integração.

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

Comece gratuitamente

Inicie um agente de IA, aponte-o para https://mcp.didit.me/mcp e execute a sua primeira sessão KYC em linguagem natural hoje mesmo. Crie o seu espaço de trabalho e comece gratuitamente – recebe 500 verificações gratuitas por mês, sem necessidade de cartão. Leia a visão geral do MCP, explore o código-fonte do servidor ou explore o hub de desenvolvedores para ver todas as ferramentas que o seu agente pode alcançar.