Ranla

npx add-mcp 'https://mcp.ranla.ai/mcp'

Ranla MCP

Ranla MCP conecta Cursor, Claude Code y agentes compatibles con:

• Ranla para estrategia de crecimiento, análisis del ciclo de vida, trabajo con audiencias y aprobaciones.
• Herramientas de correo transaccional, dominios, plantillas y entregabilidad cuando las necesites.

Usa Ranla para el trabajo de crecimiento para que la conversación, la memoria y el flujo de aprobaciones permanezcan en un solo lugar. Instalar MCP no requiere cambiar el correo transaccional de tu producto.

Conexión alojada

El servidor alojado no necesita clave API. Añade la URL:

{
  "mcpServers": {
    "ranla": {
      "url": "https://mcp.ranla.ai/mcp"
    }
  }
}

En Claude Code:

claude mcp add --transport http ranla https://mcp.ranla.ai/mcp

En la primera conexión, tu cliente abre un navegador (en Claude Code, ejecuta /mcp). Inicia sesión en app.ranla.ai y haz clic en Permitir acceso. Usa un encabezado Bearer (Authorization: Bearer rnl_…) solo para una configuración avanzada que no pueda iniciar sesión.

Añadir Ranla a ChatGPT

ChatGPT se conecta al mismo servidor alojado. Para añadirlo tú mismo:

1. En ChatGPT, abre Configuración → Seguridad e inicio de sesión y activa Modo desarrollador.
2. Abre Plugins, selecciona + e introduce https://mcp.ranla.ai/mcp como URL del servidor. Elige OAuth para la autenticación.
3. Inicia sesión en app.ranla.ai y haz clic en Permitir acceso.

Luego pregunta en un chat nuevo, por ejemplo "¿Cómo va el crecimiento en Ranla esta semana?" o "¿Qué está esperando mi aprobación en Ranla?". ChatGPT pregunta antes de ejecutar un paso que cambie tu espacio de trabajo, y cualquier cosa que envíe, gaste o publique aún espera tu aprobación en Ranla.

Para desconectar, elimina Ranla de los plugins de ChatGPT. Eso termina su acceso a tu espacio de trabajo.

Instalar en Cursor

Crea una clave API en Configuración → Claves API, luego añade esto a .cursor/mcp.json o a tu configuración global de MCP en Cursor:

{
  "mcpServers": {
    "ranla": {
      "command": "npx",
      "args": ["-y", "ranla-mcp@latest"],
      "env": {
        "RANLA_API_KEY": "rnl_your_key_here"
      }
    }
  }
}

Reinicia Cursor después de cambiar la configuración.

Instalar en Claude Code

claude mcp add --transport stdio ranla -- npx -y ranla-mcp@latest

Exporta RANLA_API_KEY en el entorno donde se ejecuta Claude Code.

Herramientas

Herramientas del agente Ranla

• arc_ensure_thread / arc_list_threads — encuentra o crea un hilo duradero, o lista hilos (los más recientes primero; pasa nextBefore como before para los más antiguos).
• arc_get_thread — lee los mensajes de un hilo, incluyendo las herramientas que Ranla usó, lo que creó y las aprobaciones que esperan por ti. Pasa earlierBefore como before para mensajes más antiguos.
• arc_message — envía una solicitud a Ranla y espera el turno. Devuelve la respuesta de Ranla (text), los borradores, planes y documentos que creó o abrió (artifacts), y pendingApproval cuando un paso necesita tu sí.
• arc_list_approvals, arc_approve, arc_reject — responde aprobaciones sin abrir el panel.
• arc_ranla — ejecuta uno de los comandos de Ranla tú mismo: command es un sustantivo y un verbo, como campaign list, segment create, page propose o connection request, y input contiene sus campos. La descripción de la herramienta lista cada comando, y help <noun> devuelve los comandos de un sustantivo con cada campo. Son los mismos comandos que Ranla ejecuta, bajo las mismas reglas: cualquier cosa que envíe, gaste o publique vuelve como pendingApproval y no hace nada hasta que la respondas con arc_approve. La lista proviene de tu espacio de trabajo, así que los nuevos comandos aparecen sin actualizar. Los enlaces en los resultados son URLs completas de la aplicación.

Flujo recomendado: arc_ensure_thread, luego arc_message para cualquier cosa que necesite el juicio o la investigación de Ranla ("diseña una campaña de reactivación"), o arc_ranla cuando conozcas el paso (" campaign list "). Si un paso necesita aprobación, arc_list_approvals, luego arc_approve o arc_reject.

Estas herramientas necesitan una clave API de acceso completo. El inicio de sesión con OAuth y las claves creadas en Configuración → Claves API tienen acceso completo; una clave solo de envío recibe un 403 en cada herramienta arc_*.

Herramientas de correo

• Envío: send_email (ahora, o más tarde con scheduled_at), cancel_email, list_emails, get_email.
• Entrante: list_received_emails, get_received_email.
• Dominios: list_domains, get_domain, create_domain, apply_domain_dns, verify_domain.
• Plantillas: list_templates, get_template, create_template, publish_template.
• Webhooks: list_webhooks, create_webhook, delete_webhook, send_test_webhook_event.
• Supresiones y entregabilidad: list_suppressions, add_suppression, remove_suppression, get_deliverability.

Hasta que tu dominio esté verificado, envía desde [email protected] solo a tu correo de cuenta.

Elegir herramientas

Para trabajo de crecimiento, envía un mensaje a Ranla y deja que elija las herramientas de lectura apropiadas o solicite una aprobación. Para integración de aplicaciones, usa el SDK de Ranla y la habilidad ranla para añadir contactos de Audience y eventos del ciclo de vida.

El correo transaccional está disponible a través del mismo servidor. Usa esas herramientas solo cuando el usuario pida enviar, inspeccionar o configurar correo.

Consulta Agent Skills y la guía rápida de instrumentación.