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:Configura tu herramienta de IA \
Cursor \
Instala OneSignal desde Cursor Marketplace.Abre el plugin de OneSignal
Instala el plugin
Inicia sesión en OneSignal
Usa OneSignal en el chat de Agent
mcp.json:
Claude Code \
Añade el servidor MCP de OneSignal
Autentícate desde Claude Code
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.Aprueba el acceso
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 medianteclaude_desktop_config.json, que es solo para servidores stdio locales.
Añade un conector personalizado
Introduce los detalles del servidor
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.Inicia sesión en OneSignal
Codex CLI \
Abre el navegador de plugins
codex y escribe /plugins.Instala OneSignal
Inicia una nueva sesión e inicia sesión
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:
Otras herramientas y agentes de IA \
Añadehttps://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: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
Mensajería (3 herramientas) \
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_messagecomo 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_messagevalida 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 alist_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.Páginas relacionadas \
Usar OneSignal en Claude y ChatGPT
Administrar Journeys con MCP
Descripción general de la REST API
API para crear mensajes
send_message.