Saltar al contenido principal
Reval publica un servidor MCP (Model Context Protocol, el estándar con el que Claude, ChatGPT, Cursor y otros se conectan a fuentes de datos). Lo conectás una vez, iniciando sesión con tu tienda, y después le preguntás al asistente en tu idioma: «¿cuántas suscripciones activas tengo?», «¿qué clientes tuvieron un cobro rechazado esta semana?», «¿qué productos están en más cajas?».
Es solo lectura. El asistente consulta tu tienda; no puede pausar, cancelar, editar ni cambiar la configuración, con ninguna clave. Para operar suscripciones desde tus propios sistemas está la API.

​
Antes de empezar

  • Una tienda con Reval instalado y acceso al admin (Reval → Integraciones).
  • Un cliente MCP. Esta guía cubre Claude (web, desktop, móvil y Claude Code) y ChatGPT; cualquier otro cliente que soporte servidores MCP remotos por HTTP funciona con la misma URL.
  • Un plan que permita conectores personalizados. Al 21 de octubre de 2026: en Claude, los planes Pro, Max, Team y Enterprise; en ChatGPT, Plus, Pro, Business, Enterprise y Edu con el modo desarrollador activado. Los menús y requisitos de cada cliente cambian seguido: si algo no coincide, buscá «conectores» o «MCP» en la ayuda del cliente.

​
Paso 1: conectá el asistente

La URL del servidor está en Reval → Integraciones → Asistentes de IA. En producción es:
Pegás esa URL en el asistente como conector personalizado y elegís iniciar sesión. Reval te pregunta cuál es tu tienda, te lleva a tu admin de Shopify (con tu usuario de siempre) y ahí confirmás el acceso. No hay claves que copiar: el asistente recibe un token atado a esa tienda, que vence y se renueva solo, y que podés cortar cuando quieras desde Integraciones → Asistentes conectados.

​
Claude (web, desktop y móvil)

  1. Entrá a Configuración → Conectores (en claude.ai o en la app de escritorio) y tocá Agregar conector personalizado.
  2. Nombre: Reval. URL: https://api.appreval.com/mcp. Dejá la autenticación en Iniciar sesión (Claude la detecta sola) y el cliente OAuth en la opción recomendada.
  3. Tocá Agregar y después Conectar: se abre Reval, ingresás tu tienda (tu-tienda.myshopify.com), confirmás en tu admin de Shopify con Autorizar y volvés a Claude.
  4. En un chat nuevo, abrí el menú + (o el de herramientas), activá Reval y preguntá: «¿Cuántas suscripciones activas tengo?».
Los conectores se comparten entre web, desktop y móvil, así que lo configurás una vez.

​
Claude Code

Después, en una sesión, /mcp muestra el estado; elegí Reval → Authenticate la primera vez: se abre el navegador con el mismo flujo (tienda → admin de Shopify → Autorizar). Claude Code recibe la autorización en una dirección local (localhost), por eso la pantalla lo advierte.

​
ChatGPT

  1. Entrá a Configuración → Conectores (o Apps y conectores), abrí Configuración avanzada y activá el modo desarrollador.
  2. Tocá Crear (conector). Nombre: Reval. URL del servidor MCP: https://api.appreval.com/mcp. Autenticación: OAuth.
  3. Confirmá: ChatGPT abre Reval, ingresás tu tienda, confirmás en tu admin de Shopify con Autorizar y ChatGPT muestra las herramientas disponibles.
  4. En un chat, abrí + → Más y elegí Reval, o activá el modo desarrollador en el chat y preguntá: «¿Cuántas suscripciones activas tengo?».
Cualquier cliente MCP que soporte OAuth (Cursor, MCP Inspector, un agente propio) se conecta igual: la URL, descubrimiento automático y el mismo inicio de sesión. Reval publica los metadatos estándar en /.well-known/oauth-authorization-server y /.well-known/oauth-protected-resource/mcp.

​
Alternativa: una API key

Si tu cliente no sabe iniciar sesión (un script, un agente sin navegador), podés usar una clave:
  1. En Reval → Integraciones → API keys, escribí el nombre del asistente, marcá Solo lectura y tocá Generar clave. Se muestra completa una sola vez.
  2. Mandala en el header: Authorization: Bearer reval_…, por ejemplo en Claude Code con --header "Authorization: Bearer reval_…".
La forma https://api.appreval.com/mcp/reval_… (clave al final de la URL) sigue funcionando para clientes que solo aceptan una URL, pero deja la clave guardada en el cliente y en los registros de acceso. Preferí iniciar sesión; si usás esta forma, que la clave sea de solo lectura y revocala en Integraciones si la ves expuesta.

​
Qué preguntarle

  • «¿Cuántas suscripciones activas tengo? ¿Y pausadas?»
  • «¿Qué clientes tuvieron un cobro rechazado esta semana?»
  • «¿Cuánto facturé por suscripciones en los últimos 30 días comparado con el período anterior?»
  • «¿Cuáles son los motivos de cancelación más frecuentes?»
  • «Buscá a Martín Pérez y decime qué tiene suscripto y cuándo es su próximo cobro.»
  • «¿Qué productos están en más cajas?»
  • «¿Qué suscripciones se cobran la semana que viene?»
  • «¿Tengo envío gratis activado? ¿Y Klaviyo conectado?»
  • «¿Qué pedidos quedaron en espera por falta de stock?»
El asistente combina las herramientas que necesite. Si la respuesta parece incompleta, pedile que use una herramienta concreta («usá list_subscriptions con payment_failed») o que pida más filas.

​
Qué puede consultar

Los nombres de estas herramientas son un contrato: no cambian. Montos en la moneda de la tienda; fechas en UTC.

​
Datos personales de tus suscriptores

Cada respuesta del servidor viaja al proveedor del asistente (Anthropic, OpenAI u otro). Por eso vos decidís cuánto de tus suscriptores se comparte: La opción Compartir datos de contacto de los suscriptores con los asistentes está en Reval → Integraciones → Asistentes de IA y aplica a todas las claves de la tienda. Antes de activarla, revisá las normas de protección de datos de tu país y las condiciones del asistente que uses; la decisión y la responsabilidad son del merchant.

​
Límites

El servidor comparte los límites de la API para que una conversación larga nunca afecte el admin, el checkout ni los cobros:
  • 2000 requests por minuto por conexión (un asistente que inició sesión, o una clave contando API y MCP juntos). Si se supera, el asistente recibe un mensaje claro («Usage limit reached… works again in Ns») y vuelve a funcionar al liberarse la ventana.
  • Cada listado devuelve hasta 100 filas (25 por defecto) y continúa con un cursor.
  • Un asistente desconectado o una clave revocada reciben «Unauthorized» en toda consulta y no devuelven ningún dato.
  • El token de un asistente dura 1 hora y se renueva solo durante 30 días de uso; después de 30 días sin usarlo, el asistente te pide iniciar sesión otra vez.

​
Problemas frecuentes

  • El cliente dice que no puede conectarse. Verificá que la URL sea exactamente https://api.appreval.com/mcp, sin espacios ni barra final. Si usás clave, que empiece con reval_ y no esté revocada.
  • Al iniciar sesión dice que la tienda no tiene Reval. Ingresá el dominio .myshopify.com (no el dominio propio de la tienda) y revisá que Reval esté instalado en esa tienda.
  • El asistente pide iniciar sesión de nuevo. Pasaron 30 días sin usarlo, o lo desconectaste desde Integraciones. Volvé a conectar; es un minuto.
  • Claude Code avisa que la dirección es local. Es normal: recibe la autorización en localhost. Autorizá solo si fuiste vos quien ejecutó el comando.
  • El asistente no encuentra un cliente que existe. Buscá por email o por una parte del nombre; si sigue sin aparecer, es de otra tienda: cada clave ve solo la tienda que la generó.
  • Faltan el teléfono o la dirección. Es la opción de datos personales (ver arriba): por defecto no se comparten.