ChatRail

ChatRail es una API de WhatsApp para desarrolladores: envía y recibe mensajes de WhatsApp a través de HTTP desde un número que ya tienes. Consulta la documentación de MCP para la referencia completa.

GitHubPrueba este MCPPatrocinado

Documentación

Servidor MCP de ChatRail

Opera un espacio de trabajo de ChatRail desde Claude, Cursor, VS Code y cualquier otro cliente de Model Context Protocol. Verifica la salud de tus conexiones de WhatsApp, busca grupos, rastrea por qué falló un mensaje, gestiona mensajes programados y reproduce entregas de webhooks sin salir de tu editor.

Privacidad por diseño

Los cuerpos de los mensajes, los números de teléfono de los destinatarios y las credenciales nunca son devueltos por ninguna herramienta.
Las herramientas que cambian el estado devuelven una vista previa primero y se aplican solo cuando se llaman nuevamente con confirm: true.
Cada llamada está limitada a un espacio de trabajo y se registra en su registro de auditoría.

Dos formas de conectarse

1. Servidor alojado con OAuth (recomendado)

Apunta cualquier cliente que admita servidores MCP remotos a:

https://www.chatrail.dev/v1/mcp

Tu cliente abre una ventana del navegador donde un propietario, administrador o desarrollador del espacio de trabajo aprueba el acceso. Nada que instalar y ninguna clave que copiar.

Claude Code

claude mcp add --transport http chatrail https://www.chatrail.dev/v1/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "chatrail": { "url": "https://www.chatrail.dev/v1/mcp" }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "chatrail": { "type": "http", "url": "https://www.chatrail.dev/v1/mcp" }
  }
}

2. Servidor stdio local con una clave de API

Para clientes que solo ejecutan servidores locales, o cuando prefieras usar una clave de API. Este paquete se ejecuta en tu máquina y reenvía las solicitudes al servidor alojado.

En el panel de ChatRail, crea una clave de API del espacio de trabajo con el alcance mcp:read. Agrega mcp:write si el asistente puede reprogramar, cancelar, reaccionar o reproducir.
Agrega el servidor a tu cliente.

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "chatrail": {
      "command": "npx",
      "args": ["-y", "github:chatrail/chatrail_mcp"],
      "env": { "CHATRAIL_API_KEY": "cr_live_..." }
    }
  }
}

Docker

docker build -t chatrail-mcp .
docker run -i --rm -e CHATRAIL_API_KEY=cr_live_... chatrail-mcp

Variable	Requerida	Descripción
`CHATRAIL_API_KEY`	Sí, para llamar herramientas	Clave de API del espacio de trabajo con `mcp:read` (y opcionalmente `mcp:write`).
`CHATRAIL_MCP_URL`	No	Anula el endpoint. El valor predeterminado es `https://www.chatrail.dev/v1/mcp`.

Sin una clave, el servidor aún se inicia y lista sus herramientas, para que puedas inspeccionarlo antes de registrarte.

Herramientas

Herramienta	Alcance	Qué hace
`list_connections`	lectura	Cada conexión de WhatsApp en el espacio de trabajo con su estado y salud.
`get_connection`	lectura	Una conexión con su estado, salud e historial de estados reciente.
`list_whatsapp_groups`	lectura	Grupos visibles para un número conectado, con ids y recuentos de participantes.
`get_whatsapp_group`	lectura	Nombre, descripción, configuración y recuentos de miembros de un grupo.
`list_messages`	lectura	Mensajes recientes con su estado de entrega.
`get_message`	lectura	Un mensaje y su línea de tiempo de entrega.
`explain_message_failure`	lectura	Una explicación estructurada de por qué falló un mensaje.
`list_scheduled_messages`	lectura	Mensajes en espera de envío, primero los más próximos.
`list_webhook_deliveries`	lectura	Entregas de webhooks recientes y sus resultados.
`reschedule_message`	escritura	Cambia cuándo se envía un mensaje programado. Muestra vista previa primero.
`cancel_scheduled_message`	escritura	Cancela un mensaje que no se ha enviado. Muestra vista previa primero.
`react_to_message`	escritura	Establece o elimina una reacción de emoji en un mensaje. Muestra vista previa primero.
`replay_webhook`	escritura	Reencola una entrega de webhook muerta u omitida. Muestra vista previa primero.

Planes

El acceso a MCP está incluido en los planes Core + AI y Team de ChatRail. Consulta precios.

Desarrollo

npm install
npm run build
CHATRAIL_API_KEY=cr_test_... node dist/index.js

tools.json es el catálogo de herramientas que se sirve cuando no hay una clave de API configurada. Se exporta desde el servidor alojado y debe actualizarse cuando cambien las herramientas alojadas.

Enlaces

Sitio web: https://www.chatrail.dev
Documentación de MCP: https://www.chatrail.dev/mcp
Referencia de API: https://www.chatrail.dev/api-reference
Autenticación: https://www.chatrail.dev/auth.md

Licencia

MIT