deepidv MCP

Servidor MCP para verificación de identidad nativa de IA y antifraude

Documentación

DeepIDV MCP Server

Acceso MCP alojado a las herramientas de verificación, flujos de trabajo, finanzas, solicitantes y screening de DeepIDV.

Características

Gestiona sesiones de verificación para tu organización DeepIDV.
Recupera artefactos de verificación, cronologías y enlaces de recursos de soporte.
Busca solicitantes, consulta el estado de las invitaciones y reenvía invitaciones.
Crea flujos de trabajo reutilizables con pasos de verificación de DeepIDV.
Revisa registros y métricas de extractos bancarios, y crea nuevas solicitudes de extractos.
Ejecuta comprobaciones de PEP y sanciones, comprobaciones de títulos, screening de medios adversos y sondeo de trabajos asíncronos.
Conéctate mediante OAuth 2.0 alojado con PKCE en lugar de ejecutar un servidor local.

Inicio rápido

Usa el endpoint MCP alojado:

URL del servidor: https://mcp.deepidv.com/v1/mcp
Manifiesto del servidor: https://mcp.deepidv.com/mcp.json
Metadatos de recursos protegidos: https://mcp.deepidv.com/.well-known/oauth-protected-resource

Ejemplos de indicaciones tras la instalación:

Lista mis sesiones de verificación más recientes.
Encuentra al solicitante con el correo jane@example.com.
Muestra los artefactos de la sesión de verificación <session_id>.
Ejecuta una comprobación de PEP y sanciones para Jane Doe nacida el 1980-05-12.

Si tu cliente MCP admite servidores HTTP remotos con descubrimiento OAuth, añadir la URL del servidor suele ser suficiente para que el cliente descubra automáticamente los metadatos OAuth de DeepIDV.

Instalación

DeepIDV es un servidor MCP alojado. No necesitas clonar, compilar ni ejecutar un proceso Node.js local para usarlo.

En tu cliente MCP, añade un servidor remoto.
Introduce https://mcp.deepidv.com/v1/mcp como URL del servidor.
Si el cliente solicita client_id, usa deepidv.
No introduzcas un client_secret.
Completa el flujo OAuth basado en navegador con tu correo y contraseña de deepidv y, a continuación, el MFA si es necesario.
Pide a tu asistente que llame a una herramienta de DeepIDV, como listar flujos de trabajo, listar sesiones de verificación o ejecutar una comprobación de screening.

Para instrucciones centradas en la instalación, consulta llms-install.md.

Autenticación

DeepIDV utiliza OAuth 2.0 alojado con PKCE para el acceso MCP.

El flujo alojado actual utiliza un cliente público compartido:

client_id es deepidv
client_secret no se utiliza
el intercambio de tokens utiliza PKCE con S256
el usuario inicia sesión con su correo y contraseña de deepidv
el MFA se aplica cuando la cuenta lo requiere

El acceso está limitado al usuario y la organización de DeepIDV autenticados. Las llamadas a herramientas se validan contra el estado activo de la cuenta antes de ejecutarse.

Herramientas disponibles

Solicitantes

Herramienta	Qué hace
`search_applicants`	Encuentra solicitantes coincidentes en sesiones y solicitudes de extractos bancarios.
`get_applicant`	Recupera un perfil consolidado del solicitante y su historial.
`get_invitation_status`	Comprueba el estado de entrega y participación de la invitación.
`resend_invitation`	Reenvía una invitación para una sesión de verificación o una solicitud de extracto bancario.

Verificación

Herramienta	Qué hace
`list_verification_sessions`	Lista sesiones de verificación con filtros y paginación.
`get_session_stats`	Recupera métricas y tendencias de verificación agregadas.
`get_verification_session`	Recupera los detalles completos de una sesión de verificación.
`get_verification_session_artifacts`	Recupera datos de análisis y enlaces de recursos de una sesión de verificación.
`get_session_timeline`	Recupera la cronología de una sesión de verificación.
`create_verification_session`	Crea y envía una nueva invitación de verificación.
`update_verification_session_status`	Marca manualmente una sesión como `VERIFIED` o `REJECTED`.
`expire_session`	Expira una sesión de verificación activa.

Flujos de trabajo

Herramienta	Qué hace
`list_workflows`	Lista los flujos de trabajo disponibles para la organización autenticada.
`get_workflow`	Recupera un flujo de trabajo y sus pasos configurados.
`create_workflow`	Crea un flujo de trabajo reutilizable con uno o más pasos de verificación de DeepIDV.

IDs de pasos de flujo de trabajo actuales expuestos a través de MCP:

ID_VERIFICATION
FACE_LIVENESS
AGE_ESTIMATION
PEP_SANCTIONS
ADVERSE_MEDIA

Finanzas

Herramienta	Qué hace
`list_bank_statements`	Lista los registros de extractos bancarios de la organización autenticada.
`get_bank_statement_stats`	Recupera métricas y tendencias agregadas de extractos bancarios.
`get_bank_statement`	Recupera un registro de extracto bancario y los detalles del extracto cuando estén disponibles.
`list_bank_statements_by_external_id`	Recupera registros de extractos bancarios que coincidan con tu ID de referencia externo.
`create_bank_statement_request`	Crea y envía una nueva invitación de solicitud de extracto bancario.

Screening silencioso

Herramienta	Qué hace
`run_pep_sanctions_check`	Ejecuta un screening síncrono de PEP y sanciones.
`run_title_check`	Ejecuta una búsqueda síncrona de título de propiedad o titularidad.
`run_adverse_media_check`	Pon en cola un screening asíncrono de medios adversos y devuelve un `job_id`.
`get_async_job`	Sondea un trabajo de screening de medios adversos asíncrono hasta que esté listo o haya fallado.

Requisitos

Necesitas:

Una cuenta de DeepIDV.
Un usuario de DeepIDV activo.
Tu correo y contraseña de deepidv.
Acceso MFA si tu cuenta lo requiere.
Un cliente MCP que admita servidores MCP HTTP remotos con código de autorización OAuth 2.0 y PKCE.

Cómo funciona

El endpoint público en https://mcp.deepidv.com/v1/mcp da acceso al transporte MCP alojado de DeepIDV. El servidor expone las operaciones de la plataforma DeepIDV a través de HTTP en streaming y utiliza la misma lógica central de verificación, flujos de trabajo, finanzas y screening que impulsa la plataforma principal.

Para los usuarios, el detalle importante es más sencillo: conéctate una vez, autoriza una vez y luego llama a las operaciones de DeepIDV como herramientas MCP desde tu cliente preferido.

Notas de seguridad

Todas las solicitudes MCP utilizan autenticación con token de portador.
El acceso está limitado a la organización y el usuario de DeepIDV autenticados.
Las llamadas a herramientas están sujetas a límites de frecuencia.
Algunas herramientas modifican el estado y pueden crear registros, reenviar invitaciones o consumir créditos.
Los artefactos de verificación y los enlaces devueltos deben tratarse como datos confidenciales de clientes.

Documentación

Guía de instalación para agentes de marketplace: llms-install.md
Sitio web de DeepIDV: https://www.deepidv.com
Soporte de DeepIDV: https://www.deepidv.com/support

Contribuciones

Esta carpeta documenta el servidor MCP alojado de DeepIDV para el repositorio público. Si encuentras un problema de documentación, abre un pull request o un issue en el repositorio principal.

Licencia

Esta documentación forma parte del repositorio principal y está cubierta por la licencia del repositorio.