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

  1. 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.

  2. 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.

  3. Você cria uma chave e coloca no seu agente. Pronto: ele passa a ver as ferramentas do Felku.

Primeiros 5 minutos

  1. 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.

  2. 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.

  3. Conecte o WhatsApp ou o Telegram no painel. Leia e aceite o aviso de risco antes de parear.

  4. Adicione à sua lista de contatos quem o agente pode atender (no teste, até 2).

  5. Em Agentes e chaves, crie uma chave e copie o comando do seu agente (veja todos).

  6. 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/mcp

  • Transporte: 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 (sem initialize) e as anteriores (com initialize). O seu cliente escolhe; você não precisa configurar nada.

O que o agente consegue fazer

Ele podeFerramenta
Ver se as conexões estão de péfelku_get_connection_status
Ler mensagens novas do WhatsApp ou do Telegramfelku_read_new_messages, felku_telegram_read_updates
Enviar texto no WhatsApp ou no Telegramfelku_send_text, felku_telegram_send_message
Marcar como lido, reagir, mostrar "digitando", editar ou apagar a própria mensagemfelku_mark_read, felku_react, felku_set_typing, felku_edit_message, felku_delete_message
Verificar se um número da sua lista tem WhatsAppfelku_check_number
Ver quanto já usou dos limites e quando pode enviar de novofelku_get_policy_status
Pausar uma conexão em emergênciafelku_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.

Idioma e tema