Saltar al contenido principal
Conecta OneSignal a cualquier herramienta o agente de IA compatible con servidores remotos de Model Context Protocol (MCP) añadiendo la URL del servidor MCP de OneSignal. Usa esta página para conectar Cursor, Claude Code, Codex CLI, VS Code o tu propio agente, o para ver la lista completa de herramientas. Para instalar OneSignal desde el directorio de Claude o ChatGPT, consulta Usar OneSignal en Claude y ChatGPT. MCP es un estándar abierto para conectar aplicaciones de IA con sistemas externos. El servidor MCP de OneSignal expone acciones de OneSignal, como buscar un usuario o enviar un mensaje, como herramientas que tu herramienta de IA puede llamar.

Requisitos previos \

  • Una cuenta de OneSignal con acceso a las apps de OneSignal que quieres administrar.
  • Permiso para aprobar el acceso a OneSignal mediante OAuth, el inicio de sesión basado en navegador que usa OneSignal.
  • Una herramienta de IA compatible con servidores MCP remotos a través de HTTP con OAuth.

Detalles de la conexión \

Todas las herramientas de IA se conectan al mismo endpoint alojado:
Te autenticas iniciando sesión en OneSignal en tu navegador y aprobando el acceso. No hay ninguna clave de la REST API que configurar. Deja en blanco los campos de ID de cliente y secreto de cliente de OAuth: OneSignal registra tu herramienta de IA automáticamente y, si rellenas esos valores, la conexión falla.

Configura tu herramienta de IA \

Cursor \

Instala OneSignal desde Cursor Marketplace.
1

Abre el plugin de OneSignal

Ve a OneSignal en Cursor Marketplace o busca OneSignal en el marketplace de Cursor.
2

Instala el plugin

Haz clic en Add to Cursor. Cursor instala el plugin de OneSignal, incluido el servidor MCP.
3

Inicia sesión en OneSignal

Abre Settings > MCP & Integrations y haz clic en Authenticate junto a OneSignal. Inicia sesión en tu navegador y haz clic en Agree & Allow Access.
4

Usa OneSignal en el chat de Agent

Inicia un nuevo chat de Agent y pide a OneSignal que ejecute una comprobación de solo lectura, como listar tus apps de OneSignal.
Para configurar Cursor manualmente, añade OneSignal a tu mcp.json:

Claude Code \

1

Añade el servidor MCP de OneSignal

Ejecuta el siguiente comando en tu terminal:
2

Autentícate desde Claude Code

Inicia claude y escribe /mcp para abrir el panel de MCP. Selecciona onesignal y elige Authenticate para abrir la página de inicio de sesión de OneSignal en tu navegador.
3

Aprueba el acceso

Inicia sesión y haz clic en Agree & Allow Access. Vuelve a Claude Code. El estado del servidor cambia a connected.
Ejecuta claude mcp list, o /mcp dentro de Claude Code, para ver el número de herramientas.

Conector personalizado de Claude \

Usa un conector personalizado solo cuando no puedas instalar OneSignal desde el directorio de Claude. Los servidores MCP remotos no se pueden añadir mediante claude_desktop_config.json, que es solo para servidores stdio locales.
1

Añade un conector personalizado

Ve a Customize > Connectors y haz clic en Add custom connector.
2

Introduce los detalles del servidor

Establece Name en OneSignal y Remote MCP server URL en https://api.onesignal.com/mcp/oauth. Deja en blanco OAuth Client ID y OAuth Client Secret en Advanced settings.
3

Inicia sesión en OneSignal

Haz clic en Add, completa el inicio de sesión de OneSignal en tu navegador y haz clic en Agree & Allow Access.

Codex CLI \

1

Abre el navegador de plugins

Ejecuta codex y escribe /plugins.
2

Instala OneSignal

Busca OneSignal, ábrelo e instálalo.
3

Inicia una nueva sesión e inicia sesión

Inicia una nueva sesión. Cuando Codex te pida que te autentiques, inicia sesión en OneSignal en tu navegador y haz clic en Agree & Allow Access.
La extensión de Codex para IDE no es compatible con plugins. Para usar OneSignal con Codex, instálalo desde Codex CLI o desde la pestaña Plugins de la app de escritorio de ChatGPT.

GitHub Copilot en VS Code \

Añade OneSignal a .vscode/mcp.json en tu espacio de trabajo para compartirlo con tu equipo, o ejecuta MCP: Open User Configuration desde la paleta de comandos para instalarlo en tu perfil de usuario:
La primera vez que Copilot necesita una herramienta de OneSignal, VS Code te pide que te autentiques y abre la página de inicio de sesión de OneSignal.

Otras herramientas y agentes de IA \

Añade https://api.onesignal.com/mcp/oauth en la configuración de servidores MCP remotos de tu herramienta de IA. La primera vez que la herramienta de IA llama a una herramienta de OneSignal, abre la página de inicio de sesión de OneSignal en tu navegador. Inicia sesión y haz clic en Agree & Allow Access. Tu herramienta de IA muestra las herramientas de OneSignal una vez que la conexión se completa.

Verifica la conexión \

Inicia un nuevo chat o sesión y envía:
Si la respuesta muestra tus apps de OneSignal, la conexión funciona. Si devuelve “tool access is not enabled for this application”, consulta Solución de problemas. Para comprobar solo que tu herramienta de IA llega al servidor, llama a onesignal_health. Responde antes de que se active el acceso de herramientas de IA, por lo que un resultado correcto no confirma que las demás herramientas funcionen.

Solución de problemas \

  • Vuelve a autenticarte. Vuelve a conectar OneSignal desde la configuración de MCP o de conectores de tu herramienta de IA e inicia una nueva sesión.
  • Comprueba la URL del servidor. La URL debe ser exactamente https://api.onesignal.com/mcp/oauth, sin rutas adicionales ni caracteres al final.
  • Vacía los campos del cliente OAuth. Si tu herramienta de IA tiene campos de ID o secreto de cliente OAuth, déjalos en blanco.
  • Comprueba el acceso de herramientas de IA. Si una herramienta devuelve “tool access is not enabled for this application”: OneSignal aún no ha activado el acceso de herramientas de IA para tu inicio de sesión de OneSignal. Contacta con el soporte de OneSignal.
  • Reinicia tu herramienta de IA e inicia una nueva sesión. Esto resuelve la mayoría de los problemas de conexión transitorios.

Herramientas \

Explora las herramientas a continuación. La detección de herramientas depende de que MCP esté habilitado en tu app o cuenta de OneSignal. Cada operación también comprueba los permisos de tu app de OneSignal.

Apps (2 herramientas) \

Journeys (9 herramientas) \

Administrar Journeys con MCP

Estructura las solicitudes de herramientas, obtén los schemas y aplica cambios en las Journeys de forma segura.

Mensajería (3 herramientas) \

Para iniciar o actualizar una Live Activity, consulta Live Activities más abajo.

Usuarios y suscripciones (12 herramientas) \

Plantillas (4 herramientas) \

Segmentos (4 herramientas) \

Live Activities (2 herramientas) \

Exportaciones (2 herramientas) \

Eventos personalizados (2 herramientas) \

Entregabilidad de email (4 herramientas) \

Calentamiento de email (5 herramientas) \

Analíticas y utilidades (4 herramientas) \

Seguridad y salvaguardas \

  • OneSignal marca send_message como una herramienta de alto impacto, por lo que las herramientas de IA que respetan las anotaciones de herramientas pueden pedir confirmación antes de ejecutarla.
  • send_message valida la segmentación antes de enviar: solo se permite un método de segmentación por solicitud y los filtros tienen un límite.
  • OneSignal valida las entradas antes de ejecutarlas, incluidos identificadores, direcciones de email y números de teléfono.
  • Para conocer los requisitos de concurrencia de las Journeys, los controles del ciclo de vida y la recuperación tras escrituras inciertas, consulta la guía de solicitudes de Journeys.
  • OneSignal activa o desactiva el acceso de herramientas de IA para cada inicio de sesión de OneSignal.
  • El servidor MCP no almacena los datos de tus clientes (suscriptores, mensajes, exportaciones).

Límites y uso \

Conectar OneSignal es gratis. Cada acción cuenta para los límites de uso normales de la API de OneSignal. El plan de tu proveedor de IA puede tener sus propios costos.
  • Las llamadas a herramientas tienen un límite de frecuencia para evitar bucles descontrolados.
  • Una conexión sigue los permisos del usuario que inició sesión y puede acceder a todas las apps de OneSignal que ese usuario puede administrar.
  • Es posible que OneSignal tenga que activar el acceso de herramientas de IA para tu inicio de sesión antes de que funcionen las herramientas distintas de las de utilidad.

FAQ \

¿Necesito una clave de la REST API? \

No. Todas las conexiones usan OAuth de OneSignal. Inicias sesión en tu navegador y apruebas el acceso, así que no hay ninguna clave de API que copiar, almacenar o rotar.

¿Cómo trabajo con más de una app de OneSignal? \

Una conexión cubre todas las apps que tu cuenta de OneSignal puede administrar. Llama a list_apps para encontrar los ID de las apps. No necesitas una configuración independiente para cada app.

¿Puedo conectar una herramienta de IA que solo es compatible con servidores stdio locales? \

No. El servidor MCP de OneSignal es un servidor remoto a través de HTTP. Tu herramienta de IA debe ser compatible con servidores MCP remotos con OAuth.

¿Cómo revoco el acceso de una herramienta de IA? \

Ve a Settings > Account settings > Connected apps en OneSignal y revoca la conexión. Revocarla no afecta a las conexiones de tus compañeros de equipo.

Usar OneSignal en Claude y ChatGPT

Instala OneSignal desde el directorio de Claude o ChatGPT.

Administrar Journeys con MCP

Crea borradores, actualiza pasos de Journeys y administra el estado de las Journeys desde tu cliente MCP.

Descripción general de la REST API

Referencia de los endpoints a los que llama el servidor MCP de OneSignal.

API para crear mensajes

Referencia del endpoint que utiliza send_message.

Prácticas de datos de IA

Cómo trata OneSignal los datos de las funciones de IA y de las herramientas de IA conectadas.