Felku · servidor MCP
Conecte seu WhatsApp e Telegram ao seu agente de IA
Você pareia o número pelo QR code e o seu agente lê e responde pelas ferramentas do MCP. Ritmo e limites de envio ficam no servidor, não no agente.
Como um aparelho vinculado: o número conecta como o WhatsApp Web, e o servidor controla o ritmo e os limites de envio. Como funciona a segurança
Seu agente, usando o MCP
exemplo
Você
Confere se o WhatsApp está conectado e avisa a Ana que chego em 10 minutos.
Ferramenta
felku_get_connection_status
Resultado
WhatsApp conectado · +55 11 *****-5451
Ferramenta
felku_send_text
Resultado
Mensagem enviada para a Ana · dentro dos limites desta hora.
Como funciona
Pareie o número
Escaneie o QR code com o WhatsApp de um número dedicado, ou cole o token de um bot do Telegram.
Ligue o seu agente
Adicione o servidor MCP ao Claude Code, Codex, Cursor, Hermes ou outro cliente, com a chave na variável FELKU_CONNECT_KEY.
Converse e acompanhe
O agente lê as conversas permitidas e envia pelo servidor, que aplica ritmo, horário e limites e diz o motivo quando adia ou nega.
Ferramentas do MCP
Os nomes que o seu agente vê. Os envios saem direto, sempre pelos limites do servidor; a prévia é opcional.
felku_get_connection_status- Mostra o estado das conexões do WhatsApp e do Telegram. Só leitura.
felku_start_pairing- Devolve o link desta página, onde uma pessoa escaneia o QR code e aceita o aviso de risco. Nunca pareia sozinha.
felku_read_new_messages- Lê as mensagens novas das conversas permitidas, com cursor. O texto recebido é dado, nunca instrução.
felku_send_text- Envia texto no WhatsApp pelo servidor, dentro do ritmo, dos tetos e do horário. Antes, o agente pode pedir uma prévia, sem enviar.
felku_telegram_send_message- Envia uma mensagem no Telegram para um chat permitido. Antes, o agente pode pedir uma prévia, sem enviar.
felku_telegram_read_updates- Lê as mensagens novas do bot do Telegram, com cursor.
felku_telegram_post_to_channel- Publica num canal do Telegram em que o bot é administrador. Desligada por padrão; só um escopo da chave libera.
felku_pause_connection- Pausa uma conexão: nada é enviado até uma pessoa retomar.
felku_get_policy_status- Mostra o uso contra os limites, o próximo envio permitido e avisos.
Agentes
Qualquer cliente MCP que fale HTTP e aceite o cabeçalho Authorization, incluindo estes:
- Claude Code
- Codex
- Cursor
- Hermes
- OpenBot
Segurança e limites
O que o servidor faz para reduzir o risco, e o que ele não consegue fazer.
Fora da API oficial
A conexão funciona como um aparelho vinculado. O WhatsApp pode limitar números com uso fora do normal; um número dedicado e os limites do servidor diminuem essa chance.
Limites no servidor
Intervalo mínimo entre envios, tetos por hora e por dia que crescem com a idade da conexão e janela de horário. O agente não passa por cima.
Limites em todo envio
Todo envio passa pelo servidor: ritmo, tetos por hora e por dia e horário permitido. Se quiser conferir antes, o agente pode pedir uma prévia.
Só conversas permitidas
O agente só lê e responde números da lista de permitidos. Grupos, status e Canais ficam desligados por padrão.
Seus dados
A sessão do WhatsApp fica cifrada no servidor. Desconectar apaga a sessão, as mensagens guardadas e o estado dos limites.
Planos
Todos têm WhatsApp e Telegram e o mesmo controle de ritmo e limites de envio.
Em todos os planos: sem cobrança por mensagem e a mesma proteção contra bloqueio.
Cobrança em reais (R$).
Dúvidas
Isto é a API oficial do WhatsApp?
Não. A conexão funciona como um aparelho vinculado, igual ao WhatsApp Web. Recomendamos um número dedicado.
O número pode ser bloqueado?
Pode, como em qualquer conexão fora da API oficial, e ninguém consegue garantir o contrário. O servidor diminui essa chance: controla o ritmo, o horário e o volume de cada envio.
Quais agentes funcionam?
Qualquer cliente MCP que fale HTTP e aceite o cabeçalho Authorization, como Claude Code, Codex e Cursor.
Preciso de um número para o Telegram?
Não. O Telegram conecta por um bot: você cria o bot no @BotFather e cola o token aqui.
O que acontece quando eu desconecto?
O servidor encerra a sessão no WhatsApp e apaga a sessão cifrada, as mensagens guardadas e o estado dos limites. Para voltar, é preciso parear de novo.