verifika-mcp

Servidor MCP oficial de Verifika. Permite verificar comprobantes bancarios en lenguaje natural desde Claude, Cursor, Windsurf o cualquier cliente compatible con MCP, usando tu cuenta de Verifika.

Requisitos previos

1. Una cuenta activa en Verifika con tus cuentas bancarias receptoras y tu biblioteca de patrones configuradas.
2. Una API Key generada en el Panel API:
   • vfk_* → producción (consume créditos).
   • test_* → sandbox (no consume créditos; usa simulate_scenario).

Instalación

No necesitas clonar nada: se ejecuta con npx.

Claude Desktop / Claude Code

claude_desktop_config.json:

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

Cursor — .cursor/mcp.json

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

Windsurf — ~/.codeium/windsurf/mcp_config.json

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

Variables de entorno

| Variable | Requerida | Descripción | | ------------------- | --------- | ---------------------------------------------------------------------- | | VERIFIKA_API_KEY | Sí | Tu llave vfk_* (producción) o test_* (sandbox). | | VERIFIKA_API_URL | No | Base de la API. Default: la nube de Verifika. |

Herramientas expuestas

analizar_comprobante

Verifica un comprobante contra tus cuentas receptoras.

| Parámetro | Tipo | Notas | | ------------------- | ------- | ---------------------------------------------------------------- | | imageBase64 | string | Imagen en Base64 o data URL. Alternativa a imagePath. | | imagePath | string | Ruta local; el servidor la lee y codifica. | | mimeType | enum | image/jpeg | image/png | image/webp (se infiere). | | banco | string | Banco receptor esperado. | | titular | string | Titular de la cuenta receptora. | | numero_cuenta | string | Número de cuenta receptora. | | tipo_cuenta | enum | Ahorros | Corriente. | | transfer_code | string | Referencia esperada (6–20 alfanumérico). | | monto_limite | number | Pagos ≥ este monto → acción RETENER. | | simulate_scenario | enum | Solo test_: success | review | fraud. |

Debes enviar imageBase64 o imagePath. Los campos de cuenta son opcionales: si se omiten, Verifika usa las cuentas configuradas en tu perfil.

clasificar_ejemplo

Extrae banco + OCR de un comprobante y lo guarda en tu Biblioteca de Patrones. No consume créditos.

Desarrollo

npm install
npm run build      # compila a dist/
npm run typecheck  # verificación de tipos
VERIFIKA_API_KEY=test_... node dist/index.js