Pushpad MCP

Servidor MCP de Pushpad para enviar notificaciones web push y gestionar recursos en Pushpad (acciones CRUD sobre notificaciones, suscripciones, proyectos y remitentes) utilizando la API de Pushpad.

Este proyecto es una capa delgada construida sobre la API de Pushpad, utilizando la especificación OpenAPI oficial de Pushpad y FastMCP para TypeScript.

Seguridad

El uso de la tecnología MCP para interactuar con tu cuenta de Pushpad puede conllevar riesgos.

Este servidor MCP otorga acceso completo a la API de Pushpad, lo que incluye acciones irreversibles y destructivas (como actualizar, eliminar, etc.). La API también puede devolver datos sensibles como claves de suscripción push (API de Suscripciones) y claves VAPID (API de Remitentes).

Recomendamos usar un modo de permisos adecuado en tu agente y utilizar un token de Pushpad con acceso restringido.

Puedes cambiar el modo de permisos a Manual o establecer permisos de permitir / denegar para las diferentes herramientas proporcionadas por este servidor MCP en la configuración de tu agente.

Recomendamos excluir las claves VAPID almacenadas en Remitentes de tu contexto de IA: puedes usar un token de Pushpad con acceso restringido o denegar las herramientas que dan acceso a la API de Remitentes.

Recuerda mantener el token de acceso privado y nunca almacenarlo en el repositorio de Git.

Related MCP server: Dialpad Universal MCP Server

Instalación

Paso 1: Configurar tu Token de API como Variable de Entorno

Primero, necesitas crear un nuevo token de Pushpad: abre el panel de Pushpad, haz clic en tu nombre de cuenta, luego haz clic en Tokens de acceso y crea un nuevo token.

Luego necesitas almacenar el token de Pushpad como una variable de entorno. Puedes configurarlo globalmente en tu máquina (~/.bashrc, ~/.zshrc u otro perfil de shell), usar un gestor de contraseñas (como 1Password CLI), configurarlo en un archivo .env específico del proyecto, o añadirlo directamente al archivo de configuración del cliente MCP (como .mcp.json). Recuerda añadir .env, .mcp.json u otros archivos que puedan incluir el secreto a .gitignore.

Paso 2: Añadir el Servidor MCP a tu Agente de IA

El servidor MCP local se inicia directamente por tu cliente MCP utilizando la configuración definida en tu archivo de configuración JSON de MCP. La ubicación exacta de este archivo y cómo se aplica depende de tu cliente MCP.

Para habilitar los servicios MCP, añade una entrada al bloque mcpServers:

{
  "mcpServers": {
    "pushpad": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "pushpad-mcp"],
      "env": {
        "PUSHPAD_TOKEN": "${PUSHPAD_TOKEN}"
      }
    }
  }
}

El ejemplo anterior configura el servidor MCP de Pushpad con ${PUSHPAD_TOKEN}. Reemplázalo con tu token de Pushpad o utiliza el método específico del cliente de sustitución de variables (si está disponible) para mantener tu token fuera del archivo de configuración.

Paso 3: Usar Pushpad MCP

Finalmente, puedes interactuar con Pushpad usando MCP y tu agente de IA.

Por ejemplo:

Usa Pushpad para enviar a todos una notificación sobre XYZ.

Envía una notificación al usuario 123 usando Pushpad.

¿Cuántos clics recibió la notificación 98765?

¿Cuál es el TTL predeterminado para las notificaciones en el proyecto 456?

El servidor MCP soporta la API completa de Pushpad, incluyendo la API de Notificaciones, API de Suscripciones, API de Proyectos y API de Remitentes.

Desarrollo

Si quieres contribuir a este proyecto, no dudes en abrir un issue o enviar un pull request.

Si quieres hacer cambios en este paquete, para desarrollo local, puedes clonar este repositorio y usar VS Code con un contenedor de desarrollo para una configuración más fácil.

Luego puedes usar los siguientes comandos:

• npm run build para compilar el proyecto TypeScript

• npm run start para iniciar el servidor MCP

• npm run inspect para iniciar el servidor MCP e inspeccionarlo con @modelcontextprotocol/inspector

Puedes configurar PUSHPAD_TOKEN en un archivo .env y se leerá automáticamente.

Este repositorio también incluye Claude Code en el contenedor de desarrollo y un .mcp.json que puedes usar para probar la versión local de este servidor MCP. Esto solo es útil si planeas hacer cambios en este paquete y quieres probar la versión modificada antes de enviar un pull request.

Licencia

Este servidor MCP se publica bajo una licencia de código abierto (MIT).