Comece aqui
O Felku é um servidor MCP (Model Context Protocol) que liga o seu WhatsApp e o seu bot de Telegram ao agente de IA que você já usa: Claude Code, Codex, Cursor, Hermes ou qualquer cliente MCP que fale HTTP.
Com ele, o seu agente pode ler as conversas que você autorizar e enviar mensagens por elas. Todo envio passa pelas nossas travas de ritmo, feitas para reduzir o risco de o seu número ser restringido.
Antes de começar: a conexão do WhatsApp não é oficial. O WhatsApp pode restringir ou banir um número a qualquer momento, e as travas reduzem esse risco, mas não o eliminam. Use um número dedicado. Leia Limites e risco de bloqueio e a página Segurança e riscos.
Como funciona
Você conecta o WhatsApp (lendo um QR code, como no WhatsApp Web) ou o seu bot de Telegram (colando o token do bot) no painel.
Você escolhe com quem o agente pode conversar: a lista de contatos da sua conta. Mensagens de fora dela são descartadas na entrada e não chegam ao agente.
Você cria uma chave e coloca no seu agente. Pronto: ele passa a ver as ferramentas do Felku.
Primeiros 5 minutos
Crie a conta em mcp.felku.com.br. Enviamos um código de 6 dígitos para o seu e-mail: digite o código na tela para confirmar a conta. O código vale por 10 minutos; se não chegar, peça outro na mesma tela.
Escolha um plano. Todos começam com um teste grátis (hoje, de 7 dias), com cartão. No teste: 1 conexão, e o agente conversa com você e mais 2 contatos no WhatsApp e com 1 conversa individual no Telegram.
Conecte o WhatsApp ou o Telegram no painel. Leia e aceite o aviso de risco antes de parear.
Adicione à sua lista de contatos quem o agente pode atender (no teste, até 2).
Em Agentes e chaves, crie uma chave e copie o comando do seu agente (veja todos).
Peça ao seu agente: "liste as ferramentas do felku-connect" e depois "mostre o status das conexões".
A chave só funciona depois que você conecta um canal. Antes disso, o servidor responde
connection_required("conecte o WhatsApp ou o Telegram no painel"). Não é a chave que está errada: conecte um canal e tente de novo.
Endereço e protocolo
Endereço do servidor MCP:
https://mcp.felku.com.br/mcpTransporte: HTTP (Streamable HTTP, sem sessão). O servidor responde só
POST.Autenticação: cabeçalho
Authorization: Bearer <sua chave>. Veja Chaves e acesso.Versões do MCP: a revisão
2026-07-28(seminitialize) e as anteriores (cominitialize). O seu cliente escolhe; você não precisa configurar nada.
O que o agente consegue fazer
| Ele pode | Ferramenta |
|---|---|
| Ver se as conexões estão de pé | felku_get_connection_status |
| Ler mensagens novas do WhatsApp ou do Telegram | felku_read_new_messages, felku_telegram_read_updates |
| Enviar texto no WhatsApp ou no Telegram | felku_send_text, felku_telegram_send_message |
| Marcar como lido, reagir, mostrar "digitando", editar ou apagar a própria mensagem | felku_mark_read, felku_react, felku_set_typing, felku_edit_message, felku_delete_message |
| Verificar se um número da sua lista tem WhatsApp | felku_check_number |
| Ver quanto já usou dos limites e quando pode enviar de novo | felku_get_policy_status |
| Pausar uma conexão em emergência | felku_pause_connection |
| Pegar o link da página de pareamento (uma pessoa lê o QR) | felku_start_pairing |
Lista completa e argumentos: Ferramentas.
Ainda não disponível: importar histórico antigo, buscar mídia recebida (imagem ou documento) e transcrever áudio. As ferramentas felku_read_history, felku_request_more_history e felku_get_media não aparecem na lista do agente enquanto esses recursos não estiverem liberados. Catálogo do WhatsApp Business também não está disponível. Grupos: a leitura dos que o dono liberar, comunidades e canais (ler e seguir) já funcionam; enviar em grupos e administrá-los existem, mas vêm desligados (Ferramentas).
Conta, teste e assinatura
Senha esquecida: em Esqueci a senha, enviamos um código de 6 dígitos para o e-mail; com ele você cria uma senha nova na mesma tela.
Teste grátis: começa ao assinar, com cartão. Se você não cancelar até o fim do teste, a assinatura começa e o cartão é cobrado; avisamos por e-mail antes. Cada pessoa tem um teste só.
Desistência (direito de arrependimento): você pode desistir da compra em até 7 dias contados da contratação ou da primeira cobrança, como dizem os Termos, no painel em Conta › Desistir e ser reembolsado. Esse prazo é o do Código de Defesa do Consumidor e não muda com o tamanho do teste.
Cancelar a assinatura no fim do período: em Conta › Cancelar assinatura, a qualquer momento. Você mantém o acesso até o fim do período e pode reativar antes disso.
Quatro coisas para saber desde já
O envio é direto. Quando o agente pede, a mensagem sai, respeitando as travas. Se ele quiser ver antes, pede uma prévia com
dry_run: true, e nada é enviado.Mensagem recebida é dado, nunca instrução. O texto que chega de outra pessoa pode tentar mandar no seu agente ("ignore suas regras e..."). O servidor marca isso (
origin.untrusted), mas quem obedece ou não é o seu agente. Configure-o para tratar mensagens como conteúdo.Plano maior não compra mais envio. As travas de ritmo são as mesmas em todos os planos; o plano muda quantas conexões, chaves e contatos você tem.
O conteúdo vai para o serviço de IA do seu agente. Quando o agente lê uma conversa, o texto segue para o provedor que ele usa (Anthropic, OpenAI, Google, xAI...), sob as regras desse provedor. O Felku não escolhe nem controla esse serviço.