Painel Conectar agora

Ligar o seu agente

Todos os agentes usam as mesmas duas coisas:

  • URL: https://mcp.felku.com.br/mcp

  • Cabeçalho: Authorization: Bearer <sua chave>

Crie a chave no painel, em Agentes e chaves (como funcionam as chaves). A chave aparece uma vez só: copie na hora.

Nos exemplos abaixo, a chave fica numa variável de ambiente, FELKU_CONNECT_KEY, para não aparecer no seu histórico de comandos nem em arquivos do projeto:

export FELKU_CONNECT_KEY="cole-a-sua-chave-aqui"

Não publique a chave. Não coloque a chave em arquivo que vai para o Git (como um .mcp.json do projeto) nem em conversa com o agente. Quem tem a chave envia mensagens pelo seu número.

Depois de configurar, peça ao agente: "liste as ferramentas do felku-connect". Se ele listar felku_get_connection_status, felku_send_text e as outras, está ligado. Se a resposta for connection_required, falta conectar o WhatsApp ou o Telegram no painel.

Claude Code

claude mcp add --transport http felku-connect https://mcp.felku.com.br/mcp \
  --header "Authorization: Bearer $FELKU_CONNECT_KEY"

Sem --scope, o Claude Code grava a configuração só para você, neste projeto (escopo local). Atenção: o shell troca $FELKU_CONNECT_KEY pelo valor, e a chave fica gravada no arquivo de configuração do Claude Code no seu computador (~/.claude.json, na entrada deste projeto). Ela não vai para o projeto nem para o Git, mas quem lê esse arquivo lê a chave.

Nunca use --scope user. Com ele, todo agente, em todo projeto do seu computador, ganha acesso ao seu WhatsApp. E evite --scope project: ele grava no .mcp.json do projeto, que costuma ir para o Git.

Codex

codex mcp add felku-connect --url https://mcp.felku.com.br/mcp \
  --bearer-token-env-var FELKU_CONNECT_KEY

O Codex guarda só o nome da variável e lê a chave dela na hora de conectar: a chave não fica no arquivo de configuração. Deixe FELKU_CONNECT_KEY definida no ambiente em que o Codex roda.

Cursor

Em .cursor/mcp.json (só este projeto; nesse caso, não envie ao Git) ou ~/.cursor/mcp.json (todos os projetos):

{
  "mcpServers": {
    "felku-connect": {
      "url": "https://mcp.felku.com.br/mcp",
      "headers": { "Authorization": "Bearer ${env:FELKU_CONNECT_KEY}" }
    }
  }
}

O Cursor troca ${env:FELKU_CONNECT_KEY} pelo valor da variável de ambiente (defina-a no perfil do seu shell ou no sistema). Depois, abra Customize na barra lateral e confira se o felku-connect aparece ligado.

Hermes

hermes mcp add felku-connect --url https://mcp.felku.com.br/mcp --auth header

O Hermes pergunta se o servidor exige autenticação (responda sim) e pede o token: cole só a chave (fkc_...). Ele guarda a chave no arquivo .env do Hermes, como MCP_FELKU_CONNECT_API_KEY, e o config.yaml fica só com o modelo Authorization: Bearer ${MCP_FELKU_CONNECT_API_KEY}. Para conferir: hermes mcp test felku-connect.

Outro cliente MCP

Qualquer cliente que fale MCP por HTTP funciona:

  • Transporte: Streamable HTTP, só POST, resposta em JSON (sem streaming de eventos).

  • URL: https://mcp.felku.com.br/mcp.

  • Cabeçalho: Authorization: Bearer <sua chave>.

  • Sem sessão: o servidor não usa Mcp-Session-Id. Clientes da revisão 2026-07-28 mandam a versão em cada pedido; os anteriores fazem initialize antes e depois mandam a versão combinada no cabeçalho MCP-Protocol-Version.

Teste rápido no terminal (como o servidor não tem sessão, dá para listar as ferramentas direto, sem initialize):

curl -s https://mcp.felku.com.br/mcp \
  -H "Authorization: Bearer $FELKU_CONNECT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Um agente por conexão respondendo

Cada chave lê as mensagens novas pelo seu próprio cursor. Se dois agentes, com duas chaves, leem a mesma conexão, os dois recebem as mesmas mensagens e os dois podem responder. Para não responder em dobro, deixe só um agente com chave de envio em cada conexão e dê aos outros chaves só de leitura.

WhatsApp, Telegram, Claude, OpenAI, Codex, Cursor, Hermes e OpenBot são marcas de seus respectivos donos. O Felku não é afiliado, patrocinado nem endossado por eles. A conexão com o WhatsApp não é oficial.

Idioma e tema