dbroker-mcp

Servidor MCP que conecta Claude Desktop con el sistema DBroker. Permite consultar contratos, pólizas y crear renovaciones usando lenguaje natural.

Para usuarios finales

Requisito: tener Node.js instalado

Descárgalo desde nodejs.org (versión LTS).

Instalación (un solo comando)

Abre una terminal y ejecuta el comando que te entregó el administrador:

npx @stpfdigital/dbroker-mcp <tu-token>

Listo. Reinicia Claude Desktop y escríbele:

¿Qué pólizas vencen la próxima semana?

Ejemplos de uso

¿Cuántas pólizas se emitieron hoy?
¿Qué pólizas vencen la próxima semana?
Busca los contratos del contratante 1042
Muéstrame el contrato 53548
Renueva la póliza 10110 con vigencia del 2026-07-01 al 2027-06-30

Para administradores

Generar token para un usuario

node -e "
const jwt = require('jsonwebtoken');
console.log(jwt.sign(
  { sub: 'nombre.usuario', cdCompania: 1, roles: ['mcp'] },
  process.env.JWT_SECRET
));
"

Entrega ese token al usuario. El comando completo para enviarle es:

npx @stpfdigital/dbroker-mcp <token-generado>

Servidor HTTP (para integraciones y API)

MCP_MODE=http
PORT=3100
JWT_SECRET=<secret compartido con NestJS>
DBROKER_URL=https://dbroker.dbrokercloud.com

npm run build && npm start

Herramientas disponibles

| Herramienta | Descripción | |---|---| | buscar_contratos | Busca por número de póliza, contratante o tipo | | buscar_detalles | Busca ramos con filtros de fecha de emisión y vigencia | | obtener_contrato | Detalle completo de un contrato por ID | | crear_renovacion | Crea una renovación de póliza |

Solución de problemas

Claude no encuentra las herramientas
Verifica que Node.js esté instalado (node --version) y reinicia Claude Desktop.

Error de token inválido
Solicita un nuevo token al administrador.

Las consultas devuelven vacío
Verifica que cdCompania en el token coincida con tu compañía.