MCP

Conecta tu asistente de IA a Renaska

Pídele a tu IA que explore Renaska, cree tu cuenta y configure tu negocio — todo desde el chat, sin que tengas que llenar formularios.

Endpointhttps://bk.renaska.com/mcp

Pega esta URL en tu cliente de IA.

Qué puedes hacer

Explorar Renaska

Tu IA puede consultar qué módulos ofrece Renaska y cómo funciona el precio, para ver si encaja con tu negocio.

Crear tu cuenta conversando

Le cuentas a tu IA sobre tu negocio y ella lo registra. Tú verificas tu correo y fijas tu contraseña desde el email que te enviamos.

Configurar tu negocio

Tu IA puede ajustar los datos de tu negocio y activar módulos, después de que verifiques tu correo desde el email que te enviamos.

Seguridad

La IA nunca pide ni ve tu contraseña ni los datos de tu tarjeta — todo lo sensible viaja por email con links de un solo uso.

Cómo conectar

Elige tu cliente de IA y sigue estos pasos.

Claude

  1. Configuración → Conectores → Agregar conector personalizado.
  2. Pega la URL del endpoint de arriba.
  3. Si ya tienes cuenta, Claude te lleva al login de Renaska para autorizar el acceso.
  4. Si no tienes cuenta, pídele a Claude que te ayude a crearla.

ChatGPT

  1. Configuración → Conectores → Agregar.
  2. Pega la URL del endpoint. ChatGPT detecta la autorización automáticamente.
  3. Autoriza con tu sesión de Renaska.

Otros agentes

  1. Genera una clave rnk_live_… desde Configuración → Claves de API y MCP.
  2. Envíala como header Authorization: Bearer … en cada llamada.
  3. Sirve para scripts o cualquier agente que no soporte el login interactivo.

Tu clave rnk_live_… es un secreto: pégala solo en la configuración del conector o servidor, nunca en un chat público.

Qué NO hace este MCP

Este servidor es de descubrimiento, onboarding y configuración de cuenta — no expone operaciones de negocio (crear pedidos, productos, clientes, etc.). Para eso existe la API pública de Renaska.

Referencia técnica para agentes y desarrolladores

Transporte Streamable HTTP (stateless) — un único endpoint, JSON-RPC 2.0 sobre HTTP.

Herramientas disponibles

17 tools organizadas en 3 grupos según qué credencial necesitan.

Grupo A — Descubrimiento

Sin credenciales

Solo lectura. Cualquier cliente MCP puede llamarlas sin autenticarse.

  • pingChequeo de vida — responde ok:true y la hora del servidor.
  • list_modulesLista todos los módulos de Renaska (slug, nombre, descripción, features) en el idioma pedido.
  • list_capabilitiesResumen estático de módulos y canales de IA de Renaska.
  • get_pricingPrecio de Renaska: un solo plan fijo (sin cobro por módulo) más el consumo de IA.
  • recommend_for_businessA partir de una descripción libre del negocio, recomienda módulos relevantes.

Grupo B — Onboarding

onboardingToken de la sesión

Crean y configuran una cuenta nueva. El token de la sesión de onboarding identifica el tenant — ningún tool recibe un tenantId como parámetro.

  • start_signupCrea la cuenta con datos básicos. Contraseña y pago SIEMPRE se envían por email con links seguros — nunca se piden ni se muestran en el chat.
  • check_signup_statusConsulta el progreso del onboarding (email verificado, contraseña fijada, tarjeta registrada, tenant aprovisionado).
  • resend_emailReenvía el email de verificación o de fijar contraseña.
  • configure_businessActualiza los datos del negocio (nombre, razón social, NIT/tax id, dirección, zona horaria, idioma, moneda). El país no se puede cambiar.
  • set_modulesActiva y/o desactiva módulos de Renaska. Los módulos base no se pueden desactivar.
  • get_recommended_setupSugiere módulos relevantes para ESTE tenant a partir de una descripción libre. Solo sugiere — nunca activa nada.
  • get_setup_statusResume el estado del onboarding: datos básicos completos, módulos activos, tarjeta registrada, email verificado.
  • request_payment_linkEnvía por email un link seguro (Stripe) para registrar el método de pago. El link nunca se devuelve en el chat.

Grupo C — Cuenta existente

API key o token OAuth

Configuración de una cuenta ya creada. Requieren credencial con scope mcp:query o mcp:admin — el tenant se resuelve de la credencial, nunca de un parámetro.

  • tenant_configure_businessIgual que configure_business pero para una cuenta ya existente. Requiere scope mcp:admin.
  • tenant_set_modulesIgual que set_modules pero para una cuenta ya existente. Requiere scope mcp:admin.
  • tenant_get_configDevuelve la configuración actual del tenant (datos del negocio, módulos activos) — nunca tokens, claves ni secretos. Requiere scope mcp:query.
  • tenant_recommend_setupIgual que get_recommended_setup pero para una cuenta ya existente. Requiere scope mcp:query.

Autenticación

API key

Prefijo rnk_live_, con scopes mcp:query (solo lectura) y mcp:admin (lectura y escritura). Nunca se emite una clave con acceso total (*) al namespace MCP. Se crea desde Configuración → Claves de API y MCP.

OAuth 2.1

PKCE obligatorio, registro dinámico de clientes (DCR), pantalla de consentimiento con tu sesión de Renaska y tokens opacos de un solo uso por código de autorización. Pensado para conectores interactivos como Claude y ChatGPT.

Flujo de onboarding por IA

La IA nunca pide ni ve una contraseña o un número de tarjeta — todo lo sensible viaja por email con links de un solo uso.

  1. 1

    Descubrir

    La IA consulta list_modules / get_pricing / recommend_for_business para entender qué ofrece Renaska y qué le conviene al negocio.

  2. 2

    Crear la cuenta

    start_signup crea el usuario con los datos básicos (nombre, email, negocio). Renaska envía dos emails: uno para verificar el correo y otro para fijar la contraseña.

  3. 3

    La persona verifica y fija su contraseña

    Desde el email, la persona confirma su correo y define su contraseña en la página de Renaska — nunca en el chat con la IA.

  4. 4

    Pago

    Si aplica, request_payment_link envía un link de Stripe por email para registrar el método de pago. El link nunca se devuelve en la respuesta del tool.

  5. 5

    Configurar

    Con el onboardingToken (o ya con API key/OAuth), la IA ajusta datos del negocio y activa módulos con configure_business / set_modules.