Cómo conectar Bubble a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Bubble, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Bubble + Cursor

Deja que tu IA trabaje con los datos de tu app de Bubble: ve qué tipos de datos y backend workflows expone, busca y lee registros; con tu confirmación crea o cambia registros y ejecuta backend workflows.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

BUBBLE_APP_URL, BUBBLE_API_TOKEN

Paso 1 — Obtener credenciales

1. Abre tu app en el editor de Bubble, ve a Settings → API y marca Enable Data API. Después marca cada tipo de datos al que pueda llegar la IA: todo lo que dejes sin marcar le queda invisible. Marca también Enable Workflow API and backend workflows si la IA debe ejecutar backend workflows.
2. En la misma pestaña haz clic en Generate a new API token y copia el token en BUBBLE_API_TOKEN.
3. Pon en BUBBLE_APP_URL la dirección de la app sin barra final: https://yourapp.bubbleapps.io o tu propio dominio, como https://app.example.com, para la versión live. Añade /version-test para trabajar con la versión de desarrollo, por ejemplo https://yourapp.bubbleapps.io/version-test.
4. Despliega la app a live después de cambiar los ajustes de la API: la versión live solo conoce los ajustes y tokens de su último despliegue.
5. Instala el conector y luego comprueba el token con una lectura, como bubble_list_things sobre uno de tus tipos.

La prueba de conexión comprueba la dirección, no el token: confirma que tu app responde en BUBBLE_APP_URL. Un token incorrecto o sin desplegar solo aparece en la primera lectura de datos, con un 401, así que haz esa lectura de prueba una vez.

Necesitas acceso de editor a la app. Un conector sirve para una app de Bubble; añade otro conector por cada app adicional.

Un token de administrador, limitado por tus ajustes de API: el token de Settings actúa como administrador. Ignora las reglas de privacidad (privacy rules) de la app y ve todos los campos de los tipos que expusiste, pero nada que no hayas marcado. Para escribir, cada tipo de datos también debe permitir en sus reglas de privacidad crear, modificar o borrar vía API.

Qué lee: los tipos de datos y backend workflows que expone tu app, con los campos de cada tipo y los parámetros de cada workflow; los registros (things) de un tipo, filtrados con condiciones como estado igual a abierto, ordenados, hasta 100 por página; y un registro concreto por su id, con fecha de creación, fecha de modificación y creador.

Pregunta antes de cada escritura: bubble_create_thing, bubble_update_thing y bubble_run_workflow cambian los datos de tu app y pueden disparar los propios workflows, correos o pagos de la app. Antes de cada una, la IA te muestra el tipo y cada valor, el registro y los cambios exactos, o el workflow y sus parámetros, y espera tu sí. Prueba las escrituras primero en la dirección con /version-test.

Desactivada al instalar: bubble_delete_thing. Un administrador la activa a propósito; la IA te muestra entonces el registro y solo lo borra cuando confirmas.

Nombres de tipos y campos: en la API, los nombres de tipo van en minúsculas y sin espacios (Rental Unit pasa a ser rentalunit), y los campos se identifican por los ids de campo de la app, como first_name_text, salvo que tu app use los nombres visibles como claves. La IA los lee con bubble_get_meta y bubble_get_data_types antes de buscar o escribir.

Datos personales: las apps de Bubble suelen guardar usuarios, clientes y pagos. La IA muestra solo lo que necesitas, nunca lista registros de usuarios a quien no debería verlos y trata el texto que escriben los usuarios de la app como datos, nunca como instrucciones.

Capacidad: cada plan de Bubble tiene un límite de workload, y un uso intenso de la API hace que la app vaya más lenta para sus usuarios. La IA lee en páginas pequeñas y evita recorrer en bucle miles de registros. En la mayoría de los planes, una búsqueda devuelve como máximo 50.000 registros.

Errores comunes: 400: Bubble no reconoce la dirección de la app; revisa BUBBLE_APP_URL, sin /api/1.1. 401: el token es incorrecto, se borró o aún no está desplegado en esta versión; despliega a live o usa la dirección con /version-test. 404: la Data API está desactivada, el tipo no está marcado o el workflow no está expuesto.

El conector no crea ni cambia la app (páginas, tipos de datos, workflows, reglas de privacidad), no crea registros en masa, no reemplaza registros completos ni sube archivos.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Bubble.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué tipos de datos y backend workflows expone nuestra app de Bubble?"
• "Muéstrame las solicitudes de soporte abiertas creadas esta semana, primero las más recientes."
• "¿Cuántos pedidos con el estado pagado recibimos en octubre?"
• "Cambia a confirmada el estado de la reserva de Anna Weber del 12 de noviembre. Muéstrame antes el cambio."
• "Ejecuta el backend workflow que envía el correo de bienvenida a [email protected]. Dime sus parámetros antes de iniciarlo."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT