> ## Documentation Index > Fetch the complete documentation index at: https://docs.appreval.com/llms.txt > Use this file to discover all available pages before exploring further. # Conectá Claude y ChatGPT a tu tienda (MCP) > El servidor MCP de Reval deja que Claude, ChatGPT y otros asistentes consulten tus suscripciones, clientes, pedidos, planes, cajas, métricas y configuración. Solo lectura; el asistente inicia sesión con tu tienda (OAuth) o usa una API key. Guía paso a paso para Claude (web, desktop, Code) y ChatGPT, preguntas de ejemplo, datos personales y límites. 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?». > [!NOTE] > > 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](https://docs.appreval.com/desarrolladores/api.md). *** ## 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: ```text theme={null} https://api.appreval.com/mcp ``` 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 ```bash theme={null} claude mcp add --transport http reval https://api.appreval.com/mcp ``` 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?». > [!TIP] > > 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 | Herramienta | Devuelve | | - | - | | `get_store` | Idioma, moneda, zona horaria, reglas del checkout, pedidos e inventario (política de stock, auto-merge, envío gratis), portal, notificaciones (Klaviyo, Flow, GTM conectados o no), estado de Mercado Pago, marca y qué datos personales devuelve este servidor. Nunca credenciales. | | `get_dashboard_metrics` | Lo mismo que ves en **Inicio** para un período (hoy, ayer, 7, 30 o 90 días): ingresos, nuevas, netas, unidades, pedidos (con el período anterior y el % de cambio), suscripciones por estado, MRR, totales históricos, motivos de cancelación y la serie diaria. | | `list_subscriptions` | Suscripciones con filtros: estado, cliente, producto, plan, caja, fechas de alta y de próximo cobro, y **cobro fallido** (el mismo filtro que el admin). Cada fila trae productos con nombre, monto, cadencia, próximo cobro y estado de cobro. | | `get_subscription` | Una suscripción completa: productos, condiciones del plan, envío e impuestos, tarjeta enmascarada, ciclos cobrados, historial de estados y precios, últimos pedidos. | | `search_customers` | Busca por nombre, apellido o email (sin distinguir mayúsculas ni acentos). | | `get_customer` | Un cliente con todas sus suscripciones y pedidos. | | `list_orders` / `get_order` | Pedidos generados por las suscripciones, con el número de pedido de Shopify, el pago de Mercado Pago, motivo de espera y estado de envío. | | `list_plans` | Los **Planes** con cadencia, precio, descuentos, ciclos mínimos y máximos y los productos de cada uno. | | `list_boxes` | Las **Cajas** con sus planes, tamaños, productos elegibles, add-ons y tiers. | 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: | | Qué incluye | | - | - | | **Siempre** | Nombre, email, ID de cliente de Shopify, ciudad, provincia, país y marca de la tarjeta. | | **Solo si lo activás** | Teléfono, dirección completa (calle, piso, código postal), empresa, documento fiscal y últimos dígitos y vencimiento de la tarjeta. | | **Nunca** | Credenciales de Mercado Pago, tokens de tarjeta, API key de Klaviyo, secretos de webhooks y la facturación de Reval. | 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](https://docs.appreval.com/desarrolladores/api.md#límites) 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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.