Servidor MCP

Conecte un asistente de IA a Certivant mediante el Model Context Protocol: gestione la cola de verificación, envíe y siga formularios, reclame a los solicitantes inactivos, explique decisiones e informe, todo con su clave de API existente.

El servidor MCP de Certivant expone la plataforma de verificación a los asistentes de IA mediante el Model Context Protocol. Apunte a él un host compatible (Claude Desktop, Claude Code, Cursor, VS Code, OpenAI Codex, Gemini o Mistral) y el asistente podrá trabajar con su cola: ver qué requiere atención esta mañana, enviar un formulario de verificación a un cliente concreto y seguir si ha respondido, reclamar a las personas que han dejado de responder, explicar por qué se rechazó un caso y consultar las cifras de cumplimiento del mes.

El servidor MCP es un cliente de la misma API REST /api/v1/kyc que ya usa. No tiene conexión a la base de datos ni inventa un segundo modelo de permisos: lo que recibe el asistente es exactamente la organización, los ámbitos y el límite de solicitudes de su clave de API.

De un vistazo


Transporte	Streamable HTTP: `POST /mcp`
Puerto por defecto	`3007` (`MCP_PORT`)
API de origen	`CERTIVANT_API_BASE_URL`, por defecto `http://localhost:3005`
Autenticación	`Authorization: Bearer kyk_…`: una clave de API de Certivant existente
Comprobación de estado	`GET /health` (sin autenticación, informa solo de este proceso)
Catálogo	26 herramientas · 4 recursos · 5 prompts

Las tareas que realiza

Gestionar la jornada: una sola llamada devuelve la instantánea completa de la cola: qué está escalado, qué está estancado, qué comprobaciones de sanciones han fallado y qué escalados han superado el SLA de revisión.

Hacer avanzar el trabajo: iniciar una verificación (una sola o hasta 50 a la vez), enviar un formulario a un cliente por correo electrónico, recordar a alguien que se ha estancado, renovar una comprobación que caduca.

Entender una decisión: leer los veredictos de factores del propio motor de puntuación, las descalificaciones y los desencadenantes de revisión, en lugar de adivinar a partir de una puntuación.

Realizar investigaciones KYB: leer el registro declarado de la empresa y contrastar los directores declarados con el registro público.

Informar: tasa de aprobación, embudo completo, volumen por tipo de documento, tasas de fallo por comprobación y una tendencia de 30 días, sin datos de filas ni datos personales.

El modelo de seguridad en un párrafo

Las respuestas son de tipo veredicto por defecto: un estado, una decisión, una puntuación; nunca una fecha de nacimiento, un número de documento ni texto OCR sin procesar. Todo lo que un solicitante escribió, o lo que se extrajo de un documento que subió, llega dentro de un sobre no confiable etiquetado, de modo que el modelo informa sobre ello en lugar de obedecerlo. Las herramientas que envían correos a clientes reales se marcan como no de solo lectura para que su host pida confirmación antes de ejecutarlas, y la única herramienta realmente destructiva lo indica. Consulte los detalles en Seguridad y límites.

Lo que aún no está disponible

Autenticación. Todas las vías de instalación de este sitio usan una clave de API Bearer. También está implementado un flujo de inicio de sesión OAuth 2.1 (registro dinámico de clientes, consentimiento y tokens limitados a una sola organización) para los directorios de conectores; los tokens que emite se comportan exactamente como las claves de API.

Un límite que conviene conocer antes de empezar, porque se encontrará con él:

explain_verification_decision no puede explicar la mayoría de las verificaciones antiguas. El razonamiento estructurado del motor de puntuación solo existe en las solicitudes puntuadas después de que se registrara; la herramienta informa de reasoningAvailable: false para el resto.

Cada llamada a una herramienta se registra en el mismo registro de auditoría de KYC a prueba de manipulaciones (kyc_audit_log) que las acciones humanas, a través de la API REST con la propia clave del llamador.

Siguientes pasos

Instalación: JSON de configuración por host, vinculado a su clave de API existente.

Referencia de herramientas: las 26 herramientas agrupadas por tarea, con lo que devuelve cada una y lo que no hace.

Recursos y prompts: el contexto que el modelo puede consultar sin coste, y los cinco flujos de trabajo empaquetados.

Seguridad y límites: niveles de datos personales, el sobre no confiable, las restricciones y los límites de solicitudes.