Verificação de Idade com Claude: Sessões Hospedadas vs. Arquivos Locais

Principais pontos

• Um conector Claude hospedado não pode enviar uma selfie ou foto de documento de identidade para didit_verify_age ou didit_verify_id do dispositivo do usuário. Essas ferramentas leem caminhos absolutos na máquina que executa o servidor Model Context Protocol (MCP).
• O caminho hospedado correto é baseado em sessão: crie uma sessão para um fluxo de trabalho existente, forneça à pessoa o url retornado e recupere a decisão concluída com didit_session_get_decision.
• Um fluxo de trabalho pode incluir estimativa de idade facial, que estima a idade, ou verificação de documento, que extrai a data de nascimento e outros campos do documento. Esses são diferentes níveis de evidência.
• As ferramentas de caminho de arquivo continuam úteis para implantações stdio locais ou auto-hospedadas onde o servidor MCP e o arquivo de imagem estão na mesma máquina.
• O endpoint MCP hospedado do Didit expõe 115 ferramentas. O servidor é gratuito, e o plano gratuito inclui 500 verificações gratuitas por mês.

“Verificar a idade desta pessoa a partir do Claude” soa como uma única chamada de ferramenta. A integração real possui um limite importante: onde a imagem reside? Isso determina se o Claude deve criar uma sessão de verificação hospedada ou chamar uma ferramenta de imagem autônoma.

A página do desenvolvedor MCP do Didit e o repositório público no GitHub descrevem o servidor que conecta o Claude a verificações de identidade e fraude. Para garantia de idade, a rota de sessão hospedada é a escolha prática para uma pessoa real usando o Claude remotamente. A rota de caminho de imagem autônoma é projetada para ambientes locais ou auto-hospedados com acesso direto ao sistema de arquivos.

A fronteira do sistema de arquivos que a maioria dos exemplos de MCP ignora

A ferramenta autônoma didit_verify_age aceita um image_path absoluto. didit_verify_id, de forma semelhante, aceita um front_image_path absoluto e um back_image_path opcional. Dentro do servidor MCP, esses caminhos são validados e lidos do disco antes que os arquivos sejam enviados.

Isso é simples em uma implantação stdio local. Se o Claude Desktop e um servidor Didit MCP auto-hospedado rodam na mesma estação de trabalho, um caminho como /Users/example/checks/selfie.jpg pode se referir a um arquivo real disponível para o processo do servidor. A mesma ideia funciona em um servidor interno controlado quando a aplicação já colocou o arquivo em um diretório local permitido.

Não funciona da mesma forma com o endpoint hospedado. Quando o Claude chama https://mcp.didit.me/mcp, um caminho absoluto se refere ao sistema de arquivos do servidor do Didit, não ao laptop ou telefone do usuário do Claude. Digitar um caminho local no Claude hospedado não faz o upload desse arquivo. Um usuário remoto, portanto, não pode fornecer à ferramenta hospedada uma selfie ou foto de documento simplesmente nomeando um caminho.

Esta não é uma limitação da própria estimativa de idade. É uma distinção de transporte e sistema de arquivos. Para usuários hospedados, o Didit resolve a transferência com uma sessão de verificação e uma URL voltada para o usuário.

O fluxo do Claude hospedado que funciona

Primeiro, a organização precisa de um fluxo de trabalho existente configurado no Didit Business Console. Esse fluxo de trabalho define as verificações que a pessoa completará. Um fluxo de trabalho de garantia de idade pode incluir estimativa de idade facial, verificação de documento com extração de data de nascimento, ou uma sequência mais ampla de Know Your Customer (KYC).

O Claude então chama didit_session_create. O único input necessário é workflow_id; a ferramenta não aceita uma “configuração de fluxo de trabalho” inline. Inputs opcionais incluem a referência do usuário da troca ou aplicação em vendor_data, um callback de redirecionamento e um language da UI.

Use didit_session_create com:
{
  "workflow_id": "<uuid-do-fluxo-de-trabalho-existente>",
  "vendor_data": "user_18427",
  "callback": "https://example.com/age-check/complete",
  "language": "en"
}

Retorne a URL da sessão ao usuário. Não peça a ele um caminho de imagem local.

A resposta contém session_id, url e session_token. O Claude fornece à pessoa a url retornada. A pessoa abre a UI de verificação hospedada do Didit em seu próprio dispositivo e completa as etapas de captura definidas pelo fluxo de trabalho. A transferência da imagem ocorre nessa UI, em vez de por um caminho digitado no chat.

Após a conclusão, o Claude chama didit_session_get_decision com o ID da sessão retornado:

Use didit_session_get_decision com:
{
  "session_id": "<uuid-da-sessao-de-criacao>"
}

Resuma a decisão da sessão e apenas os campos extraídos retornados pelo fluxo de trabalho.

A ferramenta retorna a decisão completa da verificação e todos os dados extraídos para aquela sessão. Os dados exatos dependem do fluxo de trabalho. A fonte do MCP não documenta um atalho booleano separado para o limite de idade. Para verificações de documentos, a decisão pode incluir os dados estruturados do documento retornados pelas etapas de verificação configuradas; o agente deve ler a resposta real em vez de inventar um campo de conveniência.

O que as ferramentas de imagem local realmente fazem

Em uma configuração stdio local ou auto-hospedada, as ferramentas autônomas podem ser um caminho direto para trabalhos em lote, utilitários de revisão internos ou aplicações que já controlam a ingestão de imagens.

Estimativa de idade facial

didit_verify_age requer image_path e opcionalmente aceita vendor_data. Ele estima a idade de uma pessoa a partir de uma imagem facial e também realiza uma verificação de vivacidade passiva. Uma estimativa não é prova de uma data de nascimento ou identidade exata.

# Apenas stdio local ou auto-hospedado
# O arquivo deve existir no sistema de arquivos do servidor MCP.
didit_verify_age {
  "image_path": "/absolute/server/path/selfie.jpg",
  "vendor_data": "user_18427"
}

A estimativa de idade tem o preço de $0.10 por verificação. A entrada ainda é uma imagem facial, e o serviço processa essa imagem para produzir o resultado. Descrever o método como livre de documentos é preciso; descrevê-lo como não coletando dados pessoais ou não armazenando nada não é suportado pelo contrato da ferramenta MCP.

Extração de data de nascimento baseada em documento

didit_verify_id requer front_image_path. Ele também pode receber back_image_path, minimum_age e outras opções documentadas. A ferramenta envia a imagem do documento de identidade, realiza reconhecimento óptico de caracteres (OCR) e retorna dados estruturados do documento e verificações de autenticidade. O OCR pode extrair a data de nascimento juntamente com outros campos presentes no documento.

# Apenas stdio local ou auto-hospedado
didit_verify_id {
  "front_image_path": "/absolute/server/path/id-front.jpg",
  "back_image_path": "/absolute/server/path/id-back.jpg",
  "minimum_age": 18,
  "vendor_data": "user_18427"
}

A fonte descreve minimum_age como recusando a verificação quando a idade extraída é inferior ao valor fornecido. O agente deve ler a decisão retornada em vez de esperar um campo de resultado de limite extra. A Verificação de ID custa $0.15 por verificação. Como a imagem completa do documento é enviada e os campos do documento são extraídos, esta rota não deve ser apresentada como coletando apenas uma data de nascimento.

Estimativa de idade, verificações de documentos e KYC completo não são intercambiáveis

Rota	O que estabelece	Caminho do Claude hospedado	Preço publicado
Estimativa de idade facial	Uma idade estimada a partir de uma imagem facial, mais vivacidade passiva	Use uma sessão hospedada cujo fluxo de trabalho inclua estimativa de idade	$0.10 por verificação
Verificação de ID	Verificações de autenticidade de documento e campos de documento extraídos, incluindo data de nascimento quando presente	Use uma sessão hospedada cujo fluxo de trabalho inclua verificação de documento	$0.15 por verificação
KYC Completo	Verificações de identidade configuradas combinando Verificação de ID, Vivacidade Passiva, Face Match e Análise de IP	Crie uma sessão para o fluxo de trabalho KYC existente e forneça a URL	$0.33 por pacote

A primeira rota estima. A segunda depende de um documento emitido pelo governo enviado. A terceira combina múltiplas verificações em uma decisão de identidade mais ampla. As equipes de produto podem distinguir esses níveis de evidência sem alegar que qualquer mecanismo satisfaz automaticamente uma lei ou regulador.

O cenário regulatório é específico do método

As regras de garantia de idade diferem por jurisdição, tipo de serviço, conteúdo e risco. No Reino Unido, a orientação de garantia de idade da Lei de Segurança Online da Ofcom discute vários métodos que podem ser altamente eficazes, incluindo estimativa de idade facial e correspondência de identificação por foto, ao mesmo tempo em que avalia a eficácia contra critérios como precisão, resistência à evasão, confiabilidade e justiça. Na União Europeia, a visão geral da Diretiva de Serviços de Mídia Audiovisual da Comissão Europeia descreve medidas de proteção de menores que podem incluir PINs ou sistemas mais sofisticados de verificação de idade.

Essas fontes ilustram por que a linguagem de implementação importa: “garantia de idade”, “estimativa de idade”, “verificação de documento” e “verificação de identidade” são termos relacionados, mas não sinônimos. Se um método particular se encaixa em um serviço específico é uma avaliação específica da jurisdição e do contexto. A integração MCP fornece as rotas técnicas; ela não faz essa avaliação para o operador.

Conecte o Claude sem borrar a fronteira

Use o link direto do conector Didit para o Claude hospedado. O endpoint usa OAuth 2.1 com Proof Key for Code Exchange (PKCE). A visão geral do MCP, o guia de autenticação e a referência de ferramentas cobrem a conexão e a descoberta.

Para o padrão de sessão mais amplo, leia Verificação de Identidade KYC sobre MCP. Para uma visão em nível de catálogo da integração, consulte a referência de ferramentas Didit MCP.

A regra prática é simples: o Claude hospedado deve criar uma sessão e fornecer a URL à pessoa; o stdio local ou auto-hospedado pode usar caminhos de imagem absolutos quando o servidor realmente possui esses arquivos. Manter essa fronteira explícita torna os prompts de garantia de idade precisos, executáveis e seguros para reutilização.