Ya tienes Claude Desktop, Claude Code o Cursor abiertos más horas al día que el panel de PushEngage. Cada vez que necesitas comprobar una tasa de clics o enviar una notificación, cambias a otra ventana desde la que se está realizando el trabajo real. La configuración de PushEngage MCP cierra esa brecha: un comando npx, un inicio de sesión en el navegador, y las herramientas de PushEngage se encuentran dentro de la misma sesión de chat que ya estás utilizando para escribir código, depurar un flujo de trabajo o responder a una pregunta de tu equipo.
Esta es la guía de configuración completa: instalación, las dos variables de entorno que vale la pena conocer, el primer inicio de sesión y las tres cosas específicas que rompen la conexión cuando no funciona a la primera. Al final, tendrás una sesión autenticada con un sitio seleccionado, no solo un indicador verde de "conectado".
Lo que podrás hacer una vez que estés conectado
@pushengage/mcp incluye 27 herramientas en 10 dominios, y una vez que te hayas autenticado en un sitio, todas estarán a una frase de distancia en lugar de a un clic del panel. Algunos ejemplos de cómo se ve esto una vez finalizada la configuración:
- Envía una notificación push ahora, prográmala para una hora específica o configura un envío recurrente, en la zona horaria local de cada suscriptor si lo solicitas.
- Ejecuta una prueba A/B entre dos titulares y deja que el asistente informe sobre la tasa de clics una vez que los resultados estén disponibles.
- Crea un segmento o un grupo de audiencia a partir de una descripción en lenguaje natural en lugar de una interfaz de reglas.
- Obtén análisis como un resumen de por vida o como una serie temporal día a día.
- Enumera tus campañas de goteo, campañas activadas y flujos de trabajo para comprobar qué se está ejecutando realmente.
- Lee la configuración de tu sitio, la configuración del service worker y la configuración del widget de chat.
Nada de eso requiere que el asistente tenga tu contraseña de PushEngage, y nada de eso requiere que abandones tu editor o terminal. PushEngage ejecuta esta integración para una base de 25.000+ propietarios de negocios en más de 150 países, enviando 15.200 millones de notificaciones en los últimos 30 días. El servidor MCP habla con la misma API de producción sobre la que se ejecuta ese volumen, no con una demo en sandbox.
Antes de empezar: lo que necesitas
Tres cosas, y es probable que ya tengas al menos dos de ellas:
- Una cuenta de PushEngage, gratuita o de pago, con al menos un sitio añadido. El servidor MCP no crea un sitio por ti; opera sobre sitios que ya has configurado en tu panel de PushEngage.
- Node.js 18 o posterior: el asistente ejecuta el servidor a través de
npx, que viene incluido con Node. Compruébalo connode -ven una terminal. - Un cliente compatible con MCP: Claude Desktop, Claude Code, Cursor o cualquier otro cliente que se comunique con MCP a través de la entrada/salida estándar (stdio).
Una cosa que vale la pena decir claramente antes de empezar a editar archivos de configuración: @pushengage/mcp se ejecuta localmente en tu máquina a través de stdio. No hay un servidor remoto al que apuntar ni una URL de conector alojada. El cliente inicia el proceso y el proceso habla con la API de PushEngage en tu nombre. Si una guía de configuración para otra herramienta te dice que pegues un punto final remoto, ese es un tipo de servidor MCP diferente a este.
Configuración del servidor en Claude Desktop, Claude Code y Cursor
Sin instalación global. npx descarga @pushengage/mcp bajo demanda la primera vez que tu cliente lo inicia, usando el comando exacto npx -y @pushengage/mcp. Añades ese comando a la configuración MCP de tu cliente, reinicias el cliente y el servidor aparece en tu lista de herramientas.
Cada cliente guarda su configuración en un lugar diferente.
Claude Desktop
Edita ~/Library/Application Support/Claude/claude_desktop_config.json en macOS (o la ruta equivalente en tu plataforma):
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Reinicia Claude Desktop. El servidor “pushengage” debería aparecer en tu lista de herramientas.
Cursor
Edita ~/.cursor/mcp.json:
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Claude Code
Claude Code se comunica con MCP a través de stdio de la misma manera que Claude Desktop y Cursor, por lo que la misma estructura command/args funciona si editas su archivo de configuración MCP directamente. Si prefieres no editar JSON a mano, Claude Code también acepta servidores a través de su propio comando CLI claude mcp add, que es un comportamiento general de Claude Code y no algo específico de PushEngage. Consulta la documentación de Claude Code para conocer la sintaxis exacta de las banderas si eliges esa ruta.
Cualquier otro cliente MCP
Si tu cliente no es uno de los tres anteriores, el requisito subyacente es el mismo en todas partes: configúralo para ejecutar npx -y @pushengage/mcp como un servidor stdio. Ese es todo el paso de instalación, independientemente de qué cliente lea la configuración.
Nombrar la conexión y aislar tokens: PE_MCP_CLIENT_NAME y PE_MCP_CONFIG_PATH
No se requiere ninguna configuración adicional más allá del paso de instalación. El servidor se comunica con la API de producción de PushEngage por defecto; existen dos variables de entorno para configuraciones menos comunes:
| Variable de entorno | Predeterminado | Propósito |
|---|---|---|
PE_MCP_CLIENT_NAME | Asistente de IA | La etiqueta que se muestra en la pantalla de autorización de PushEngage como la aplicación que solicita acceso. Establécela si deseas algo más específico, como "Claude Desktop". |
PE_MCP_CONFIG_PATH | ~/.pushengage/mcp.json | Donde se almacena el token de acceso. Establécelo para ejecutar más de una cuenta de PushEngage una al lado de la otra. Debe ser una ruta absoluta; no se permite la expansión de ~. |
La mayoría de las configuraciones de cuenta única nunca necesitan tocar ninguna de las dos variables. PE_MCP_CLIENT_NAME es una conveniencia cosmética, útil si deseas que la pantalla de autorización diga algo más legible que "Asistente de IA" cuando seas tú quien haga clic en Autorizar. PE_MCP_CONFIG_PATH es importante en el momento en que necesites un segundo token de archivo separado, que es exactamente el caso que se cubre a continuación.
Primera ejecución: iniciar sesión y elegir un sitio
La autenticación se basa en el navegador, por lo que el asistente nunca ve tu contraseña de PushEngage. El flujo consta de tres pasos, y vale la pena repasar lo que llama cada uno internamente:
- Pídele al asistente que inicie sesión. En lenguaje sencillo: "Inicia sesión en PushEngage". Esto invoca
pushengage_auth_login, que abre una pestaña del navegador a la página de autorización de PushEngage. - Haz clic en Autorizar. El panel envía el token al servidor como una solicitud POST; nunca aparece en una URL, historial del navegador o registro de acceso. El token se guarda localmente con permisos
0600, legible solo por tu usuario. - Pídele al asistente que muestre tus sitios y luego elige uno. "Mostrar mis sitios de PushEngage" llama a
pushengage_list_sites; "Usar sitio 12345" llama apushengage_select_site. La selección se recuerda entre reinicios, y cada herramienta con ámbito de sitio actúa sobre ella a menos que pases explícitamente unsite_iddiferente.
Las herramientas involucradas, por nombre:
| Herramienta | Propósito |
|---|---|
pushengage_auth_login | Abre el navegador a PushEngage y almacena el token si tiene éxito. |
pushengage_auth_status | Muestra si estás autenticado y qué sitio está seleccionado actualmente. |
pushengage_list_sites | Enumera los sitios de PushEngage a los que tu cuenta puede acceder. |
pushengage_select_site | Establece el sitio actual sobre el que actuarán las otras herramientas. |
Una vez que hayas elegido un sitio, ejecuta pushengage_auth_status (preguntar "¿cuál es mi estado de autenticación de PushEngage?" es suficiente) y confirma que informa tanto de una sesión autenticada como de un sitio seleccionado antes de intentar cualquier otra cosa. Esa es la línea de meta real para la configuración, no el momento en que el cliente muestra por primera vez que el servidor está conectado.
Solución de problemas, por causa
La mayoría de los problemas de conexión se remontan a una de estas tres causas específicas. Diagnostica en este orden.
El servidor no se conecta en absoluto y tu cliente muestra "Conexión cerrada". Esto es casi siempre un problema de PATH, no un error en el servidor. Claude Desktop, Cursor y clientes similares se inician desde tu Dock o Finder, no desde una terminal, por lo que nunca cargan los archivos de inicio de tu shell. Si Node se instaló a través de un administrador de versiones (nvm, fnm, volta), el cliente no puede encontrar npx en absoluto. El proceso nunca se inicia y obtienes un error de conexión genérico en lugar de un claro "comando no encontrado". Ejecuta which npx en una terminal para obtener la ruta absoluta, luego apunta tu cliente directamente a ella:
{
"mcpServers": {
"pushengage": {
"command": "/absolute/path/from/which-npx",
"args": ["-y", "@pushengage/mcp"],
"env": {
"PATH": "/absolute/folder/containing/that/npx:/usr/bin:/bin:/usr/sbin:/sbin"
}
}
}
}Reinicia el cliente después de editar. Si which npx en lugar de eso imprime una ruta en /usr/local/bin o /opt/homebrew/bin, un gestor de versiones probablemente no sea tu problema; revisa los propios registros MCP del cliente para ver el error real.
[AUTH_EXPIRED]. Tu token ha expirado. Pide al asistente que inicie sesión de nuevo; esa es toda la solución.
[NO_SITE_SELECTED]. Estás autenticado, pero aún no se ha elegido ningún sitio. Llama a pushengage_list_sites, luego pide usar uno de los sitios devueltos, antes de intentar usar de nuevo cualquier herramienta con ámbito de sitio.
Un caso más que vale la pena conocer, aunque no sea un error: si el navegador no se abre automáticamente, es probable que estés en una sesión sin interfaz gráfica o remota (SSH, un contenedor). La URL de autorización se imprime en la terminal que ejecuta el servidor. Ábrela manualmente.
Ejecutar más de una cuenta o cliente de PushEngage
Si gestionas PushEngage para más de una marca, o eres una agencia que ejecuta MCP contra varias cuentas de clientes, la solución es PE_MCP_CONFIG_PATH de antes: registra el servidor bajo dos nombres diferentes, cada uno con su propia ruta para que los tokens no colisionen.
{
"mcpServers": {
"pushengage-client-a": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"],
"env": {
"PE_MCP_CONFIG_PATH": "/Users/you/.pushengage/mcp-client-a.json",
"PE_MCP_CLIENT_NAME": "Claude Desktop (Client A)"
}
},
"pushengage-client-b": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"],
"env": {
"PE_MCP_CONFIG_PATH": "/Users/you/.pushengage/mcp-client-b.json",
"PE_MCP_CLIENT_NAME": "Claude Desktop (Client B)"
}
}
}
}Inicia sesión en cada nombre de servidor por separado, autorizando la cuenta de PushEngage que elijas en el navegador cada vez. Cada entrada de servidor guarda su propio archivo de tokens, por lo que cambiar entre cuentas de cliente es una cuestión de qué nombre de herramienta llamas, no de volver a iniciar sesión cada vez. Si este es tu caso de uso real, la serie tiene un tutorial completo sobre cómo ejecutar varias cuentas de cliente de PushEngage desde un único asistente de IA.
Qué hacer una vez que estés conectado
Con la autenticación hecha y un sitio seleccionado, las 27 herramientas se dividen en unos pocos grupos prácticos que vale la pena conocer por nombre, no solo por cantidad.
Para el trabajo diario de ejecutar campañas, la serie cubre cómo enviar y programar notificaciones push desde tu asistente de IA en lugar del panel, y cómo realizar pruebas A/B de notificaciones push y dejar que la IA elija al ganador por tasa de clics. Para construir tu lista, hay una guía completa para crear segmentos de suscriptores en lenguaje sencillo.
Para la medición, leer análisis de notificaciones push a través de tu asistente de IA cubre resúmenes de por vida y series temporales día a día. Esas son las mismas herramientas de análisis que hacen que el resultado de una prueba A/B o el envío de una campaña valgan la pena informar, no solo ejecutar. La serie también cubre la auditoría de campañas de goteo y flujos de trabajo para verificar qué está realmente activo, y la gestión del widget de chat que muestra WhatsApp y otros canales en el sitio.
Para el trabajo a nivel de sitio, cambiar la configuración del sitio de PushEngage desde un asistente de IA cubre la zona horaria, la geolocalización y la configuración del service worker. Y si estás configurando esto para más de una cuenta de PushEngage, la publicación enfocada en agencias sobre cómo ejecutar varias cuentas de cliente de PushEngage desde un único asistente de IA (enlazada arriba) profundiza más que el ejemplo de configuración en esta guía.
Si lo estás configurando para alguien con menos conocimientos técnicos (un fundador que quiere que el asistente de IA se encargue de PushEngage día a día sin tocar un archivo de configuración), la primera semana de un fundador no técnico con PushEngage MCP es la versión narrativa de esta misma configuración, escrita para ese lector.
La configuración en sí funciona igual independientemente de tu plan de PushEngage. Cada plan de PushEngage, incluido el nivel gratuito, admite el servidor MCP. Si estás decidiendo qué plan se adapta antes de conectar nada, la página de precios de PushEngage tiene los niveles actuales.
