Verifika MCP

Para desarrolladores · MCP Server

Verifika en tu
IA favorita

Instala el MCP Server y verifica comprobantes bancarios directamente desde Claude, Cursor o Windsurf. Sin salir de tu editor. Sin copiar APIs. Solo lenguaje natural.

Claude Code / Desktop Cursor Windsurf

Antes de instalar el MCP

Necesitas una cuenta activa en Verifika con tus cuentas bancarias y patrones configurados. El MCP valida los comprobantes contra tu información real.

1. Crear cuenta gratuita → 2. Ir al dashboard
1

Configura tu cuenta Verifika

En tu dashboard completa estos tres pasos antes de continuar:

Cuentas bancarias receptoras

Dashboard → Cuentas bancarias: agrega banco, titular, número y tipo de cada cuenta donde recibes pagos.

Biblioteca de patrones

Dashboard → Patrones: sube ejemplos reales de comprobantes de los bancos que usas. Más patrones = mayor precisión.

Obtén tu API Key

Dashboard → API Keys: genera una clave de producción (vfk_*) o sandbox (test_*). La necesitarás en el siguiente paso. No uses la llave publicable (vpk_*): esa es exclusiva del widget embebible y está restringida por dominio, por lo que el MCP la rechazaría.

Ir al Panel API
2

Instala el MCP en tu LLM

Selecciona tu herramienta y agrega la configuración. Reemplaza vfk_tu_clave_aqui con tu API Key.

Agrega esto a claude_desktop_config.json o en Configuración → MCP Servers en Claude Code.

claude_desktop_config.json 
{
  "mcpServers": {
    "verifika": {
      "command": "npx",
      "args": ["verifika-mcp"],
      "env": {
        "VERIFIKA_API_KEY": "vfk_tu_clave_aqui"
      }
    }
  }
}

Agrega esto al archivo .cursor/mcp.json en tu directorio home o en el proyecto.

.cursor/mcp.json 
{
  "mcpServers": {
    "verifika": {
      "command": "npx",
      "args": ["verifika-mcp"],
      "env": {
        "VERIFIKA_API_KEY": "vfk_tu_clave_aqui"
      }
    }
  }
}

Agrega esto al archivo ~/.codeium/windsurf/mcp_config.json.

mcp_config.json 
{
  "mcpServers": {
    "verifika": {
      "command": "npx",
      "args": ["verifika-mcp"],
      "env": {
        "VERIFIKA_API_KEY": "vfk_tu_clave_aqui"
      }
    }
  }
}
3

Verifica en lenguaje natural

Una vez instalado, tu LLM tiene acceso a analizar_comprobante. Solo descríbele lo que quieres verificar:

"Verifica este comprobante [imagen adjunta] contra mi cuenta Bancolombia Ahorros 1234567890 a nombre de Juan Pérez."

"El cliente pagó $150,000 a Nequi 3001234567. El comprobante está en /downloads/pago.jpg. ¿Es legítimo?"

El LLM responde con el resultado completo:

Respuesta 
✅ Estado: pre_aprobado
📊 Puntaje: 94/100
💡 Instrucción: Aprueba el pedido — pago verificado
🏦 Datos extraídos:
  · Monto: $150.000
  · Fecha: 2026-06-26
  · Referencia: TXN-789123
  · Remitente: María García
💳 Créditos restantes: 47

Modo sandbox

Usa tu API Key test_* para probar sin consumir créditos reales.

✅

success

Pre-aprobado, score alto

⚠️

review

Pendiente revisión humana

❌

fraud

Rechazado, fraude detectado

Parámetros de la herramienta

imageBase64 *Imagen del comprobante en Base64 o data URL. El LLM convierte automáticamente la imagen adjunta. Requerido salvo que uses imagePath.
imagePathRuta local al archivo del comprobante. El servidor MCP lo lee y lo convierte a Base64. Alternativa a imageBase64.
mimeTypeOpcional; se infiere de la extensión. image/jpeg · image/png · image/webp
bancoBanco receptor esperado (opcional). Ej: Bancolombia, Nequi, Daviplata, Banco Agrícola. Si se omite, se usan las cuentas configuradas en tu cuenta Verifika.
titularNombre del titular de la cuenta receptora (opcional).
numero_cuentaNúmero de la cuenta receptora (opcional). Mismatch en 6+ dígitos = rechazo duro automático.
tipo_cuentaOpcional: Ahorros o Corriente
transfer_codeCódigo de referencia esperado (opcional, 6–20 alfanumérico). Se cruza con el extraído del comprobante.
monto_limiteOpcional. Pagos iguales o mayores a este monto se marcan con acción RETENER.
simulate_scenarioSolo con llaves test_*: success · review · fraud. El modo sandbox se activa automáticamente según el prefijo de tu API Key.

¿Necesitas más control?

Usa la API REST directamente desde tu backend →

¿Quieres notificaciones automáticas?

Configura Webhooks para recibir resultados →