Servidor MCP
Conecta Consultas Non Stop a Claude, Cursor o cualquier cliente compatible con el Model Context Protocol. El asistente consulta el buró, resuelve el NIP y entrega el reporte sin salir del chat, con las mismas reglas de saldo, certificación y consentimiento que la API.
Qué es
El servidor MCP expone las operaciones de Consultas Non Stop como herramientas que tu asistente puede llamar: consultar el saldo, iniciar una consulta de crédito, resolver el NIP del consultado, descargar el reporte y comprar paquetes. El transporte es HTTP (Streamable) sobre JSON-RPC 2.0.
El flujo del NIP se resuelve dentro del chat: el asistente le muestra al operador la liga de términos y condiciones y las leyendas legales, y el operador captura el código que recibió el consultado. No hace falta escribir código.
Requiere plan Ilimitado
El servidor MCP está incluido únicamente en el plan Ilimitado. Con cualquier otro plan responde 403 mcp_no_disponible. Compara los planes en Precios.
URL y entornos
https://dashboard.consultasnonstop.com/mcpHay una sola URL para sandbox y producción. Tu credencial define el entorno, nunca la URL: un token de sandbox trabaja con datos de prueba y uno de producción consulta el buró real.
Cada respuesta de herramienta es JSON y empieza con "entorno": "sandbox" | "produccion", para que el asistente nunca confunda una consulta real con una de prueba: un éxito trae resultado y un error error, http_status y detalle. La herramienta entorno_actual dice en cuál estás y cómo cambiarlo, y listar_consultas sólo muestra las del entorno de la conexión.
URL de sandbox obsoleta
Si tu configuración usa sandbox.api.consultasnonstop.com/mcp con una API key, sigue funcionando por un tiempo, pero está obsoleta: cámbiala por la URL de arriba y un token MCP.
Autenticación
La credencial siempre viaja en el header Authorization: Bearer. Cuál usar depende del cliente:
Token MCPClaude Code y CursorLo generas en API y MCP con un nombre, el entorno y una caducidad de hasta 90 días. Se muestra una sola vez y lo puedes revocar. El prefijo dice el entorno: cnstp_mcp_sandbox_… o cnstp_mcp_live_….OAuth 2.1claude.ai, Claude Desktop y otros conectoresAl conectar inicias sesión, eliges Sandbox o Producción y autorizas. No necesitas token: la app aparece en Aplicaciones conectadas, donde la puedes desconectar.El token MCP no es tu API key
El token MCP es una credencial aparte de la API key REST: si se filtra desde un equipo, no expone tu API key, y caduca sola. La API key en x-api-key todavía funciona en el MCP durante la transición, pero está obsoleta: migra a un token MCP.
Claude (claude.ai)
En claude.ai entra a Conectores → Agregar conector personalizado, pega la URL del servidor MCP y deja vacíos los campos de OAuth. Se abrirá una pantalla para iniciar sesión con tu cuenta de Consultas Non Stop, elegir el entorno y autorizar el conector.
https://dashboard.consultasnonstop.com/mcp
Producción en claude.ai
La opción Producción sólo aparece si tu cuenta tiene el plan Ilimitado y al menos un servicio certificado: son consultas reales al buró y consumen saldo. Para cambiar de entorno, desconecta la aplicación (en claude.ai o en Aplicaciones conectadas del dashboard) y vuelve a conectarla eligiendo el otro.
Planes Team y Enterprise de Claude
En una organización, sólo un Owner puede agregar el conector personalizado. Una vez agregado, cada persona le da Connect e inicia sesión con su propia cuenta de Consultas Non Stop.
Claude Code
Registra el servidor desde la terminal. Sustituye TU_TOKEN_MCP por un token de API y MCP en el dashboard.
claude mcp add --transport http consultas-non-stop \ https://dashboard.consultasnonstop.com/mcp \ --header "Authorization: Bearer TU_TOKEN_MCP"
Cursor
Agrega el servidor al bloque mcpServers de mcp.json. Sirve igual para otros clientes que conectan servidores remotos por HTTP desde su configuración.
{
"mcpServers": {
"consultas-non-stop": {
"url": "https://dashboard.consultasnonstop.com/mcp",
"headers": { "Authorization": "Bearer TU_TOKEN_MCP" }
}
}
}Claude Desktop
Igual que en claude.ai: Ajustes → Conectores → Agregar conector personalizado, pega la URL del servidor MCP e inicia sesión. Sin token, sin archivos y sin instalar nada. Si ya lo agregaste en claude.ai, aparece solo en Claude Desktop y en el celular.
Planes y costo
El servidor MCP sólo está en el plan Ilimitado; con otro plan responde 403 mcp_no_disponible. En producción cada consulta descuenta saldo igual que desde el dashboard o la API, y sandbox es gratis. Compara los planes en Precios.
Errores
Los errores de conexión son HTTP: los 401 traen message y code, más el header WWW-Authenticate. Cuando una herramienta falla, la respuesta llega marcada como error: error le dice al asistente qué hacer y detalle trae el mismo error que la API (type y message). Los casos más comunes:
Respuestas de error
{
"message": "invalid or expired token",
"code": "UNAUTHORIZED"
}Herramientas
entorno_actual—Dice en qué entorno corren las consultas de la conexión (sandbox o produccion) y cómo cambiarlo. No cuesta. El asistente la usa si no está claro con qué credencial se conectó.consultar_saldo—Devuelve el saldo de consultas disponible por tipo de reporte (ordinario y especial).listar_consultas—Lista las consultas de la cuenta con su id, tipo, estado y fecha, sólo del entorno de la conexión.campos_sujetotipo, canalDevuelve qué datos del consultado se requieren según el tipo y el canal, para saber qué pedirle al operador antes de iniciar la consulta.consultar_reportetipo, canal, sujetoInicia la consulta de crédito. Devuelve el id, la fase del NIP, la leyenda de aceptación y la URL de términos y condiciones que hay que mostrarle al operador.enviar_nipconsulta_idEnvía el NIP al consultado por SMS, correo o WhatsApp. Se llama solo después de que el operador confirma que el consultado aceptó.reenviar_nipconsulta_id, celular?Pide otro NIP cuando no llegó, y corrige el teléfono si se manda celular (10 dígitos). Pasados 3 reenvíos el buró cambia al medio de respaldo; pasados 6 abandona la consulta. No se usa en la segunda captura.validar_nipconsulta_id, nipValida el código que dio el consultado. Se llama dos veces con el mismo NIP; la segunda devuelve la leyenda de autorización y cierra la consulta con el reporte_id.obtener_reporteconsulta_idDevuelve una liga temporal de 30 minutos para descargar el PDF del reporte de una consulta COMPLETADA.comprar_paquetetipo, cantidadCompra un paquete de consultas adicionales para recargar el saldo de la cuenta.tipo es ORDINARIO o ESPECIAL; canal es SMS, EMAIL o WHATSAPP. El asistente pregunta el canal en vez de asumirlo: es el medio por el que el consultado recibe el NIP.
Respuestas de ejemplo
{
"entorno": "sandbox",
"descripcion": "Las consultas responden con datos de prueba y no consumen saldo. El NIP de prueba es 123456. Para cambiar de entorno hay que cambiar la credencial: …"
}Flujo de una consulta
Así se ve una consulta completa resuelta desde el chat, de principio a fin:
campos_sujeto devuelve la lista exacta de campos según el tipo de reporte y el canal, para que el asistente le pida al operador solo lo necesario.consultar_reporte con el tipo, el canal y los datos del consultado. Devuelve la liga de términos y condiciones y la leyenda de aceptación que el asistente le presenta al operador.enviar_nip con el consulta_id. El consultado lo recibe por el canal elegido.validar_nip con el código. La fase pasa a VALIDATE_2 y la respuesta trae la leyenda de autorización del buró que hay que mostrarle al operador.validar_nip otra vez con el mismo código. Esta llamada cierra la consulta y devuelve el reporte_id.obtener_reporte devuelve una liga temporal de 30 minutos para descargar el PDF. Si expira, se vuelve a pedir.Un solo NIP, dos capturas
El buró pide el mismo código dos veces: una para ingresarlo y otra para confirmarlo. No es un segundo código distinto, así que el asistente no debe pedirle al operador un NIP nuevo en la segunda vuelta.
Consentimiento del consultado
El consultado tiene que autorizar la consulta de su historial crediticio, y el MCP lleva esa autorización al chat en dos momentos:
consultar_reporteterminos_url con la liga de términos y condiciones y leyenda_aceptacion con el texto que el consultado debe aceptar: términos y condiciones, uso del NIP como medio electrónico de autenticación y creación de su cuenta.validar_nip (2.ª)autorizacion con el título y la leyenda legal del buró, que varía según el tipo de reporte: Reporte de Crédito Especial para ESPECIAL y Buró de Crédito para ORDINARIO.El asistente le presenta ambos textos al operador y solo continúa si el operador confirma que el consultado los aceptó.