Graspil MCP

Para el índice completo de documentación, consulta llms.txt. Las versiones Markdown de las páginas de documentación están disponibles añadiendo .md a las URL de las páginas; esta página está disponible como Markdown.

Servidor MCP (agentes de IA)

Graspil ofrece su propio servidor MCP: una forma de conectar un agente de IA (Claude, ChatGPT o cualquier otro cliente compatible con MCP) directamente a tus datos en Graspil, para que el agente pueda crear informes, consultar tus estadísticas y gestionar broadcasts y automatizaciones por sí solo, sin abrir el dashboard.

Una vez que el servidor MCP está conectado a tu agente, puedes simplemente pedirle en lenguaje natural:

"Muéstrame cuántos usuarios nuevos se registraron la semana pasada comparado con la anterior"
"Crea un informe de embudo de pagos para junio y guárdalo"
"¿Cuánto gané con el programa de referidos este mes?"
"Crea un broadcast con este texto... y envíalo a todos los usuarios activos"

— y el agente llamará a las herramientas adecuadas, obtendrá los datos y responderá.

{% hint style="info" %} El servidor MCP es una capa delgada sobre la API regular de Graspil: el agente trabaja con los mismos bots y permisos que permite tu clave de API, y las restricciones de acceso/plan se aplican exactamente igual que a través del dashboard o la API. {% endhint %}

---

Qué puede hacer el agente a través de MCP

Área	Qué puede hacer el agente	Plan
Informes	Listar eventos y recursos disponibles (bots), crear y previsualizar informes (tendencias, embudos, retención, UTM), guardar informes terminados, listar los guardados anteriormente	Premium
Dashboards	Listar, crear, editar y eliminar dashboards	Premium
Broadcasts	Crear, editar, lanzar, cancelar y listar broadcasts	Premium
Automatizaciones	Crear, editar, publicar/despublicar, eliminar y listar automatizaciones (disparador → acción)	Premium
Landings	Crear, editar, eliminar y listar páginas de aterrizaje	Premium
Integraciones	Listar integraciones conectadas y tipos de integración disponibles	Premium
Historial de conversaciones	Ver el historial de mensajes del bot con los usuarios, con filtros y búsqueda de texto (solo lectura)	Premium
Programa de referidos	Ver saldo, lista de referidos, historial de pagos y tarifas efectivas (solo lectura)	Premium
Documentación	Búsqueda de texto completo en la documentación de Graspil: el agente puede buscar "cómo funciona esto" por sí solo	Cualquiera (incl. gratis)

{% hint style="warning" %} En el plan gratuito, solo la búsqueda de documentación está disponible a través de MCP. Cualquier otra área (informes, dashboards, broadcasts, automatizaciones, landings, integraciones, historial de conversaciones, programa de referidos) requiere un plan Premium (o de prueba); de lo contrario, la solicitud falla con 403 Forbidden ("Se requiere tarifa Premium"). {% endhint %}

{% hint style="warning" %} Las operaciones sensibles del programa de referidos (acumulaciones, pagos, titularidad de códigos) no están expuestas a través de MCP; esas acciones siguen disponibles solo a través del dashboard o de la API directa. {% endhint %}

---

Autenticación

El agente se conecta usando tu clave personal de la sección API Keys: una clave simple de un solo bot (de la sección "My Bots", ver Autorización) no funciona para MCP; necesitas una clave personal (a nivel de usuario).

1. Abre Perfil → API Keys en el dashboard.
2. Haz clic en "Crear clave" y asígnale un nombre (por ejemplo, "Claude MCP").
3. Opcionalmente, restringe la clave a bots específicos y a permisos por sección (solo lectura / acceso completo); por defecto, la clave da acceso a todos tus bots.
4. Copia el valor de la clave: solo se muestra una vez en texto plano, así que guárdalo en un lugar seguro.

Una sola clave funciona en todos los bots a los que tienes acceso: el agente elige el bot correcto durante la conversación (preguntándote si hay más de uno), así que no es necesario conectar cada bot por separado.

---

Conexión de un agente

El servidor MCP de Graspil habla Streamable HTTP: la mayoría de los clientes de IA modernos (Claude Desktop, Claude Code, etc.) lo admiten como un "servidor MCP remoto" configurado mediante URL.

Dirección del servidor: https://mcp.graspil.com/mcp

Forma general de configuración para clientes que admiten servidores MCP remotos por URL con encabezados personalizados:

{% code overflow="wrap" %}

{
  "mcpServers": {
    "graspil": {
      "url": "https://mcp.graspil.com/mcp",
      "headers": {
        "Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

{% endcode %}

Los pasos exactos varían según el cliente:

• Claude Desktop / Claude Code: agrega el servidor en la configuración de integraciones (Settings → Connectors / MCP servers), especificando la URL y el encabezado Api-Key.
• Otros clientes compatibles con MCP: usa el mecanismo equivalente para agregar un servidor MCP remoto por URL con un encabezado de autenticación personalizado.

Una vez conectado, el agente pedirá la lista de bots disponibles (si hay más de uno) y confirmará cuál usar para la conversación.

---

FAQ

¿Puede el agente ver los datos de otros usuarios?
No. El agente opera estrictamente dentro de los permisos de tu clave de API: solo ve los bots y datos a los que tu clave tiene acceso.

¿Puedo restringir lo que el agente puede hacer?
Sí. Al igual que con una clave de API normal, puedes restringirla a bots específicos y otorgar permisos de "solo lectura" por sección (por ejemplo, permitir que el agente vea informes pero no cree broadcasts), configurado al crear o editar la clave en la sección "API Keys".

¿Qué sucede si revoco la clave?
El agente pierde el acceso de inmediato: el servidor MCP no guarda datos propios ni almacena permisos por mucho tiempo; cada solicitud se verifica con la misma clave.

¿Necesito instalar algo?
No, el servidor ya está implementado y mantenido por Graspil: solo necesitas la clave de API y un cliente compatible con MCP.

¿Por qué el agente recibe 403 Forbidden?
En el plan gratuito, solo la búsqueda de documentación está disponible a través de MCP; cualquier otra área (informes, dashboards, broadcasts, automatizaciones, landings, integraciones, historial de conversaciones, programa de referidos) requiere un plan Premium (o de prueba); la solicitud se rechaza con 403 ("Se requiere tarifa Premium"). Actualiza la cuenta/bot a Premium.