Cómo conectar OneSignal a Cursor vía MCP

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

OneSignal + Cursor

Deja que tu IA trabaje con OneSignal: revisa los mensajes push, de email y SMS enviados con sus resultados de entrega y outcomes, consulta segmentos, usuarios y plantillas y, cuando lo confirmes, envía o programa mensajes, cancélalos, crea segmentos y actualiza los tags de los usuarios.

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:

ONESIGNAL_APP_ID, ONESIGNAL_APP_API_KEY

Paso 1 — Obtener credenciales

1. En OneSignal abre la app y luego Settings → Keys & IDs. Copia el App ID (un UUID) en ONESIGNAL_APP_ID.
2. En la misma página haz clic en Add Key bajo App API keys, ponle un nombre a la clave y créala. El valor empieza por os_v2_app_ y solo se muestra una vez: pégalo enseguida en ONESIGNAL_APP_API_KEY, sin el prefijo Key.
3. Instala el conector y ejecuta onesignal_view_app: muestra el nombre de la app y el número de suscripciones y comprueba que el App ID y la clave van juntos. La clave solo sirve para esta app; para otra app, vuelve a instalar el conector con el ID y la clave de esa app.

Quién puede hacer qué: la clave actúa para toda la app, no para una persona. Quien use el conector ve los usuarios de la app y, mientras las herramientas de envío estén activas, puede enviar mensajes a su audiencia. Comparte el servidor MCP solo con personas autorizadas a hacerlo.

Qué lee: la app con su número de suscripciones, los mensajes push, de email y SMS enviados con los recuentos de entrega y estadísticas por plataforma, los outcomes (clics, entregas confirmadas, sesiones y tus outcomes personalizados, guardados unos 30 días), los segmentos, los usuarios por alias (normalmente external_id) con sus tags y suscripciones, y las plantillas de mensajes. Con onesignal_export_message_history, OneSignal genera un archivo CSV de quién recibió o hizo clic en un mensaje; los eventos de envío solo existen para mensajes a 1.000 destinatarios o más.

Confirmar antes: onesignal_send_push, onesignal_send_email y onesignal_send_sms envían mensajes reales a personas reales, ya o a una hora programada. La IA te muestra primero el contenido, la audiencia y la hora, y solo envía cuando lo confirmas; para un segmento o más de un destinatario espera un "sí, envía" explícito. onesignal_cancel_message detiene un mensaje programado, y onesignal_create_segment y onesignal_update_user (tags, idioma, zona horaria, país) también se ejecutan solo después de tu confirmación. onesignal_delete_user viene desactivada al instalar.

Sin destinatarios: un envío responde con el id del mensaje. Un id vacío significa que nadie coincidió con la segmentación, y la lista de errores dice por qué, por ejemplo "All included players are not subscribed".

Errores comunes: 401 "Access denied": la clave es incorrecta, se eliminó o se rotó, o pertenece a otra app distinta del App ID. 400 "Failed to parse app_id": el App ID no es un UUID válido; vuelve a copiarlo desde Keys & IDs. 400 en un envío: el contenido o la segmentación no son válidos, por ejemplo falta el contenido en inglés o se combinan segmentos con alias. 403: la clave está limitada por una lista de IP permitidas, o tu plan no incluye la función. 429: se alcanzó el límite de peticiones de OneSignal; espera y vuelve a intentarlo.

El conector no cubre tareas a nivel de organización (todas las apps, crear apps, gestionar claves API, registros de auditoría), la gestión de suscripciones y alias, Live Activities, mensajes de bandeja de entrada, journeys ni exportaciones CSV de todas las suscripciones y de eventos personalizados.

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 OneSignal.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué notificaciones push enviamos la semana pasada, y cuántas se entregaron y recibieron clics?"
• "Muéstrame los clics y las entregas confirmadas de toda la app en el último día, por plataforma."
• "Busca al usuario con external_id 4821 y muéstrame sus tags y suscripciones."
• "Programa un push al segmento Subscribed Users para el viernes a las 9:00 con el título Rebajas de fin de semana, y muéstrame contenido, audiencia y hora antes de enviarlo."

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