> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Servidor MCP de OneSignal

> Conecta cualquier herramienta o agente de IA compatible con servidores MCP remotos a OneSignal con la URL del servidor MCP alojado. Incluye la configuración en Claude Code, Codex CLI, Cursor, VS Code y conectores personalizados, y todas las herramientas del servidor, incluidas las de Journeys.

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](https://documentation.onesignal.com/docs/en/onesignal-in-claude-chatgpt.md).

[MCP](https://modelcontextprotocol.io/docs/getting-started/intro) 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:

```text theme={null}
https://api.onesignal.com/mcp/oauth
```

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](https://cursor.com/marketplace/onesignal) 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`:

```json theme={null}
{
  "mcpServers": {
    "onesignal": {
      "url": "https://api.onesignal.com/mcp/oauth"
    }
  }
}
```

### Claude Code \\

**1. Añade el servidor MCP de OneSignal**

Ejecuta el siguiente comando en tu terminal:

```bash theme={null}
claude mcp add --transport http onesignal https://api.onesignal.com/mcp/oauth
```

**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](https://claude.ai/directory/connectors/onesignal). 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:

```json theme={null}
{
  "servers": {
    "onesignal": {
      "type": "http",
      "url": "https://api.onesignal.com/mcp/oauth"
    }
  }
}
```

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:

```text theme={null}
Use the list_apps tool to list the OneSignal apps I can access.
```

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](#troubleshooting).

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) \\

| Acción | Herramienta |
| - | - |
| Listar las apps a las que puede acceder el usuario autenticado | `list_apps` |
| Comprobar qué canales de mensajería están habilitados en una app | `get_app_channel_availability` |

### Journeys (9 herramientas) \\

| Acción | Herramienta |
| - | - |
| Listar las Journeys de una app | `list_journeys` |
| Ver la estructura de una Journey y su clave de concurrencia actual | `get_journey` |
| Ver estadísticas de Journeys, pasos, ramas y mensajes | `get_journey_stats` |
| Obtener el JSON Schema para crear, duplicar o actualizar una Journey o un paso | `get_journey_schema` |
| Crear una Journey como borrador | `create_journey_draft` |
| Duplicar una Journey como un nuevo borrador | `duplicate_journey` |
| Actualizar campos de una Journey o cambiar su estado | `update_journey` |
| Actualizar un paso individual de una Journey | `update_journey_node` |
| Eliminar una Journey de forma permanente | `delete_journey` |

> [card] [Administrar Journeys con MCP](https://documentation.onesignal.com/docs/en/mcp-journeys.md)
>
> Estructura las solicitudes de herramientas, obtén los schemas y aplica cambios en las Journeys de forma segura.

### Mensajería (3 herramientas) \\

| Acción | Herramienta |
| - | - |
| Enviar una notificación push, un email o un SMS | `send_message` |
| Listar notificaciones recientes | `list_messages` |
| Ver detalles de una notificación y estadísticas de entrega | `view_message` |

Para iniciar o actualizar una Live Activity, consulta [Live Activities](#live-activities-2-tools) más abajo.

### Usuarios y suscripciones (12 herramientas) \\

| Acción | Herramienta |
| - | - |
| Buscar un usuario por alias | `view_user` |
| Obtener los alias de identidad de un usuario | `get_user_identity` |
| Obtener la identidad por ID de suscripción | `get_user_identity_by_subscription` |
| Crear un nuevo usuario con propiedades | `create_user` |
| Actualizar propiedades del usuario (etiquetas, idioma y más) | `update_user` |
| Añadir o actualizar alias de identidad | `create_or_update_alias` |
| Añadir alias mediante ID de suscripción | `create_alias_by_subscription` |
| Añadir una suscripción push, de email o de SMS | `create_subscription` |
| Actualizar una suscripción existente | `update_subscription` |
| Actualizar una suscripción por token | `update_subscription_by_token` |
| Dar de baja una dirección de email | `unsubscribe_email` |
| Transferir una suscripción a otro usuario | `transfer_subscription` |

### Plantillas (4 herramientas) \\

| Acción | Herramienta |
| - | - |
| Listar plantillas | `list_templates` |
| Ver una plantilla | `get_template` |
| Crear una plantilla | `create_template` |
| Actualizar una plantilla | `update_template` |

### Segmentos (4 herramientas) \\

| Acción | Herramienta |
| - | - |
| Listar segmentos | `list_segments` |
| Ver un segmento y sus filtros | `get_segment` |
| Crear un segmento | `create_segment` |
| Actualizar un segmento | `update_segment` |

### Live Activities (2 herramientas) \\

| Acción | Herramienta |
| - | - |
| Iniciar una Live Activity de iOS | `start_live_activity` |
| Actualizar o finalizar una Live Activity | `update_live_activity` |

### Exportaciones (2 herramientas) \\

| Acción | Herramienta |
| - | - |
| Exportar suscripciones a CSV | `export_subscriptions_csv` |
| Exportar la actividad de la audiencia de una notificación a CSV | `export_audience_activity_csv` |

### Eventos personalizados (2 herramientas) \\

| Acción | Herramienta |
| - | - |
| Crear eventos personalizados para usuarios | `create_custom_events` |
| Listar las definiciones de eventos personalizados indexados | `get_custom_events` |

### Entregabilidad de email (4 herramientas) \\

| Acción | Herramienta |
| - | - |
| Comprobar el estado de verificación DNS del dominio de email (SPF, DKIM, DMARC) | `get_email_domains` |
| Ver las tasas de rebote y de quejas por spam de toda la app | `get_email_reputation` |
| Obtener métricas de entregabilidad por proveedor de bandeja de entrada para un dominio | `get_provider_metrics` |
| Obtener una serie temporal de métricas de entregabilidad por proveedor | `get_provider_metrics_timeseries` |

### Calentamiento de email (5 herramientas) \\

| Acción | Herramienta |
| - | - |
| Comprobar si un envío necesita calentamiento de IP o de dominio | `check_send_volume` |
| Estimar el número de destinatarios a partir de segmentos y filtros | `estimate_recipient_count` |
| Obtener un calendario de calentamiento por etapas recomendado | `recommended_warm_up_schedule` |
| Aplicar un calendario de calentamiento a una campaña en borrador | `apply_warm_up_schedule` |
| Listar los calendarios de calentamiento en curso | `get_active_warm_up_schedules` |

### Analíticas y utilidades (4 herramientas) \\

| Acción | Herramienta |
| - | - |
| Ver analíticas de resultados | `view_outcomes` |
| Comprobar el estado del servidor | `onesignal_health` |
| Ver la configuración del servidor | `onesignal_config` |
| Ver un resumen de referencia de todas las herramientas | `onesignal_reference_overview` |

## 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](https://documentation.onesignal.com/docs/en/mcp-journeys.md).
* 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](https://dashboard.onesignal.com/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 \\

> [card] [Usar OneSignal en Claude y ChatGPT](https://documentation.onesignal.com/docs/en/onesignal-in-claude-chatgpt.md)
>
> Instala OneSignal desde el directorio de Claude o ChatGPT.

> [card] [Administrar Journeys con MCP](https://documentation.onesignal.com/docs/en/mcp-journeys.md)
>
> Crea borradores, actualiza pasos de Journeys y administra el estado de las Journeys desde tu cliente MCP.

> [card] [Descripción general de la REST API](https://documentation.onesignal.com/reference/rest-api-overview.md)
>
> Referencia de los endpoints a los que llama el servidor MCP de OneSignal.

> [card] [API para crear mensajes](https://documentation.onesignal.com/reference/create-message.md)
>
> Referencia del endpoint que utiliza `send_message`.

> [card] [Prácticas de datos de IA](https://documentation.onesignal.com/docs/en/ai-data-practices.md)
>
> Cómo trata OneSignal los datos de las funciones de IA y de las herramientas de IA conectadas.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.