Verificación de Edad con Claude: Sesiones Alojadas vs. Archivos Locales

Puntos clave

• Un conector de Claude alojado no puede enviar una selfie o una foto de documento de identidad a didit_verify_age o didit_verify_id desde el dispositivo del usuario. Esas herramientas leen rutas absolutas en la máquina que ejecuta el servidor del Protocolo de Contexto del Modelo (MCP).
• La ruta alojada correcta se basa en sesiones: cree una sesión para un flujo de trabajo existente, proporcione a la persona la url devuelta y recupere la decisión completada con didit_session_get_decision.
• Un flujo de trabajo puede incluir la estimación de edad facial, que estima la edad, o la verificación de documentos, que extrae la fecha de nacimiento y otros campos del documento. Estos son diferentes niveles de evidencia.
• Las herramientas de ruta de archivo siguen siendo útiles para implementaciones stdio locales o autoalojadas donde el servidor MCP y el archivo de imagen están en la misma máquina.
• El endpoint MCP alojado de Didit expone 115 herramientas. El servidor es gratuito y el nivel gratuito incluye 500 verificaciones al mes.

“Verificar la edad de esta persona desde Claude” suena como una única llamada a una herramienta. La integración real tiene una frontera importante: ¿dónde reside la imagen? Eso determina si Claude debe crear una sesión de verificación alojada o llamar a una herramienta de imagen independiente.

La página para desarrolladores de MCP de Didit y el repositorio público de GitHub describen el servidor que conecta Claude con las verificaciones de identidad y fraude. Para la garantía de edad, la ruta de la sesión alojada es la opción práctica para una persona real que usa Claude de forma remota. La ruta de ruta de imagen independiente está diseñada para entornos locales o autoalojados con acceso directo al sistema de archivos.

La frontera del sistema de archivos que la mayoría de los ejemplos de MCP pasan por alto

La herramienta independiente didit_verify_age acepta una image_path absoluta. didit_verify_id acepta de manera similar una front_image_path absoluta y una back_image_path opcional. Dentro del servidor MCP, esas rutas se validan y se leen del disco antes de que se envíen los archivos.

Esto es sencillo en una implementación stdio local. Si Claude Desktop y un servidor Didit MCP autoalojado se ejecutan en la misma estación de trabajo, una ruta como /Users/example/checks/selfie.jpg puede referirse a un archivo real disponible para el proceso del servidor. La misma idea funciona en un servidor interno controlado cuando la aplicación ya ha colocado el archivo en un directorio local permitido.

No funciona de la misma manera con el endpoint alojado. Cuando Claude llama a https://mcp.didit.me/mcp, una ruta absoluta se refiere al sistema de archivos del servidor de Didit, no al ordenador portátil o teléfono del usuario de Claude. Escribir una ruta local en Claude alojado no carga ese archivo. Por lo tanto, un usuario remoto no puede entregar una selfie o una foto de documento a la herramienta alojada simplemente nombrando una ruta.

Esto no es una limitación de la estimación de edad en sí. Es una distinción de transporte y sistema de archivos. Para los usuarios alojados, Didit resuelve la entrega con una sesión de verificación y una URL orientada al usuario.

El flujo de Claude alojado que funciona

Primero, la organización necesita un flujo de trabajo existente configurado en la Consola de Negocios de Didit. Ese flujo de trabajo define las verificaciones que la persona completará. Un flujo de trabajo de garantía de edad podría incluir estimación de edad facial, verificación de documentos con extracción de fecha de nacimiento o una secuencia más amplia de Conozca a su Cliente (KYC).

Claude luego llama a didit_session_create. La única entrada requerida es workflow_id; la herramienta no acepta una “configuración de flujo de trabajo” en línea. Las entradas opcionales incluyen la referencia de usuario del intercambio o la aplicación en vendor_data, una callback de redirección y un language de interfaz de usuario.

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

Devuelva la URL de la sesión al usuario. No le pida una ruta de imagen local.

La respuesta contiene session_id, url y session_token. Claude le da a la persona la url devuelta. La persona abre la interfaz de usuario de verificación alojada de Didit en su propio dispositivo y completa los pasos de captura definidos por el flujo de trabajo. La transferencia de la imagen ocurre en esa interfaz de usuario en lugar de a través de una ruta escrita en el chat.

Después de la finalización, Claude llama a didit_session_get_decision con el ID de sesión devuelto:

Use didit_session_get_decision con:
{
  "session_id": "<uuid-de-sesión-de-creación>"
}

Resuma la decisión de la sesión y solo los campos extraídos devueltos por el flujo de trabajo.

La herramienta devuelve la decisión completa de verificación y todos los datos extraídos para esa sesión. Los datos exactos dependen del flujo de trabajo. La fuente de MCP no documenta un atajo booleano separado para el umbral de edad. Para las verificaciones de documentos, la decisión puede incluir los datos de documentos estructurados devueltos por los pasos de verificación configurados; el agente debe leer la respuesta real en lugar de inventar un campo de conveniencia.

Lo que realmente hacen las herramientas de imagen local

En una configuración stdio local o autoalojada, las herramientas independientes pueden ser una ruta directa para trabajos por lotes, utilidades de revisión interna o aplicaciones que ya controlan la ingesta de imágenes.

Estimación de edad facial

didit_verify_age requiere image_path y opcionalmente acepta vendor_data. Estima la edad de una persona a partir de una imagen facial y también realiza una verificación de vivacidad pasiva. Una estimación no es una prueba de una fecha de nacimiento o identidad exacta.

# Solo stdio local o autoalojado
# El archivo debe existir en el sistema de archivos del servidor MCP.
didit_verify_age {
  "image_path": "/ruta/absoluta/del/servidor/selfie.jpg",
  "vendor_data": "user_18427"
}

La estimación de edad tiene un precio de $0.10 por verificación. La entrada sigue siendo una imagen facial y el servicio procesa esa imagen para producir el resultado. Describir el método como libre de documentos es preciso; describirlo como que no recopila datos personales o no almacena nada no está respaldado por el contrato de la herramienta MCP.

Extracción de fecha de nacimiento basada en documentos

didit_verify_id requiere front_image_path. También puede recibir back_image_path, minimum_age y otras opciones documentadas. La herramienta envía la imagen del documento de identidad, realiza el reconocimiento óptico de caracteres (OCR) y devuelve datos de documentos estructurados y verificaciones de autenticidad. El OCR puede extraer la fecha de nacimiento junto con otros campos presentes en el documento.

# Solo stdio local o autoalojado
didit_verify_id {
  "front_image_path": "/ruta/absoluta/del/servidor/id-frontal.jpg",
  "back_image_path": "/ruta/absoluta/del/servidor/id-trasero.jpg",
  "minimum_age": 18,
  "vendor_data": "user_18427"
}

La fuente describe minimum_age como que rechaza la verificación cuando la edad extraída es inferior al valor proporcionado. El agente debe leer la decisión devuelta en lugar de esperar un campo de resultado de umbral adicional. La verificación de identidad cuesta $0.15 por verificación. Debido a que se envía la imagen completa del documento y se extraen los campos del documento, esta ruta no debe presentarse como que solo recopila una fecha de nacimiento.

La estimación de edad, las verificaciones de documentos y el KYC completo no son intercambiables

Ruta	Lo que establece	Ruta de Claude alojada	Precio publicado
Estimación de edad facial	Una edad estimada a partir de una imagen facial, más vivacidad pasiva	Utilice una sesión alojada cuyo flujo de trabajo incluya la estimación de edad	$0.10 por verificación
Verificación de identidad	Verificaciones de autenticidad de documentos y campos de documentos extraídos, incluida la fecha de nacimiento cuando esté presente	Utilice una sesión alojada cuyo flujo de trabajo incluya la verificación de documentos	$00.15 por verificación
KYC completo	Verificaciones de identidad configuradas que combinan verificación de identidad, vivacidad pasiva, coincidencia facial y análisis de IP	Cree una sesión para el flujo de trabajo KYC existente y entregue la URL	$0.33 por paquete

La primera ruta estima. La segunda se basa en un documento emitido por el gobierno. La tercera combina múltiples verificaciones en una decisión de identidad más amplia. Los equipos de producto pueden distinguir estos niveles de evidencia sin afirmar que cualquier mecanismo satisface automáticamente una ley o un regulador.

El panorama regulatorio es específico del método

Las reglas de garantía de edad difieren según la jurisdicción, el tipo de servicio, el contenido y el riesgo. En el Reino Unido, la guía de garantía de edad de la Ley de Seguridad en Línea de Ofcom analiza varios métodos que pueden ser altamente efectivos, incluida la estimación de edad facial y la coincidencia de identificación fotográfica, al tiempo que evalúa la efectividad según criterios como la precisión, la resistencia a la elusión, la fiabilidad y la equidad. En la Unión Europea, la descripción general de la Directiva de Servicios de Medios Audiovisuales de la Comisión Europea describe medidas de protección de menores que pueden incluir códigos PIN o sistemas de verificación de edad más sofisticados.

Esas fuentes ilustran por qué el lenguaje de implementación es importante: “garantía de edad”, “estimación de edad”, “verificación de documentos” y “verificación de identidad” están relacionados pero no son sinónimos. Si un método particular se ajusta a un servicio particular es una evaluación específica de la jurisdicción y el contexto. La integración de MCP proporciona las rutas técnicas; no hace esa evaluación para el operador.

Conecte Claude sin difuminar la frontera

Utilice el enlace profundo del conector Didit para Claude alojado. El endpoint utiliza OAuth 2.1 con Proof Key for Code Exchange (PKCE). La descripción general de MCP, la guía de autenticación y la referencia de herramientas cubren la conexión y el descubrimiento.

Para el patrón de sesión más amplio, lea la verificación de identidad KYC sobre MCP. Para una vista a nivel de catálogo de la integración, consulte la referencia de herramientas de Didit MCP.

La regla práctica es simple: Claude alojado debe crear una sesión y entregar a la persona su URL; stdio local o autoalojado puede usar rutas de imagen absolutas cuando el servidor realmente tiene esos archivos. Mantener explícita esa frontera hace que las indicaciones de garantía de edad sean precisas, ejecutables y seguras de reutilizar.