ChatRail

ChatRail é uma API de WhatsApp para desenvolvedores: envie e receba mensagens do WhatsApp via HTTP a partir de um número que você já possui. Consulte a documentação do MCP para a referência completa.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor MCP ChatRail

Opere um workspace do ChatRail a partir do Claude, Cursor, VS Code e qualquer outro cliente Model Context Protocol. Verifique a saúde das suas conexões WhatsApp, consulte grupos, rastreie por que uma mensagem falhou, gerencie mensagens agendadas e reproduza entregas de webhook sem sair do seu editor.

ChatRail é uma API WhatsApp para desenvolvedores: envie e receba mensagens WhatsApp via HTTP a partir de um número que você já possui. Consulte a documentação do MCP para a referência completa.

Privacidade por design

Corpos de mensagens, números de telefone dos destinatários e credenciais nunca são retornados por nenhuma ferramenta.
Ferramentas que alteram estado retornam uma prévia primeiro e só aplicam quando chamadas novamente com confirm: true.
Cada chamada é limitada a um workspace e registrada no seu log de auditoria.

Duas formas de conectar

1. Servidor hospedado com OAuth (recomendado)

Aponte qualquer cliente que suporte servidores MCP remotos para:

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

Seu cliente abre uma janela do navegador onde um proprietário, administrador ou desenvolvedor do workspace aprova o acesso. Nada para instalar e nenhuma chave para 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 com chave de API

Para clientes que só executam servidores locais, ou quando você prefere usar uma chave de API. Este pacote roda na sua máquina e encaminha solicitações para o servidor hospedado.

No painel do ChatRail, crie uma chave de API do workspace com o escopo mcp:read. Adicione mcp:write se o assistente puder reagendar, cancelar, reagir ou reproduzir.
Adicione o servidor ao seu 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

Variável	Obrigatória	Descrição
`CHATRAIL_API_KEY`	Sim, para chamar ferramentas	Chave de API do workspace com `mcp:read` (e opcionalmente `mcp:write`).
`CHATRAIL_MCP_URL`	Não	Substitui o endpoint. O padrão é `https://www.chatrail.dev/v1/mcp`.

Sem uma chave, o servidor ainda inicia e lista suas ferramentas, para que você possa inspecioná-lo antes de se cadastrar.

Ferramentas

Ferramenta	Escopo	O que faz
`list_connections`	leitura	Cada conexão WhatsApp no workspace com seu estado e saúde.
`get_connection`	leitura	Uma conexão com seu estado, saúde e histórico de estado recente.
`list_whatsapp_groups`	leitura	Grupos visíveis para um número conectado, com ids e contagens de participantes.
`get_whatsapp_group`	leitura	Nome, descrição, configurações e contagens de membros de um grupo.
`list_messages`	leitura	Mensagens recentes com seu estado de entrega.
`get_message`	leitura	Uma mensagem e sua linha do tempo de entrega.
`explain_message_failure`	leitura	Uma explicação estruturada de por que uma mensagem falhou.
`list_scheduled_messages`	leitura	Mensagens aguardando envio, das mais próximas primeiro.
`list_webhook_deliveries`	leitura	Entregas de webhook recentes e seus resultados.
`reschedule_message`	escrita	Altera quando uma mensagem agendada é enviada. Mostra prévia primeiro.
`cancel_scheduled_message`	escrita	Cancela uma mensagem que ainda não foi enviada. Mostra prévia primeiro.
`react_to_message`	escrita	Define ou remove uma reação de emoji em uma mensagem. Mostra prévia primeiro.
`replay_webhook`	escrita	Recoloca na fila uma entrega de webhook morta ou ignorada. Mostra prévia primeiro.

Planos

O acesso ao MCP está incluído nos planos Core + AI e Team do ChatRail. Consulte preços.

Desenvolvimento

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

tools.json é o catálogo de ferramentas servido quando nenhuma chave de API está configurada. Ele é exportado do servidor hospedado e deve ser atualizado quando as ferramentas hospedadas mudarem.

Licença

MIT