Panel Conectar ahora

Conecta tu agente

Todos los agentes usan las mismas dos cosas:

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

  • Encabezado: Authorization: Bearer <tu clave>

Crea la clave en el panel, en Agentes y claves (cómo funcionan las claves). La clave aparece una sola vez: cópiala en el momento.

En los ejemplos, la clave va en una variable de entorno, FELKU_CONNECT_KEY, para que no aparezca en tu historial de comandos ni en archivos del proyecto:

export FELKU_CONNECT_KEY="pega-aqui-tu-clave"

No publiques la clave. No la pongas en un archivo que vaya a Git (como un .mcp.json del proyecto) ni en una conversación con el agente. Quien tiene la clave envía mensajes desde tu número.

Después de configurar, pídele al agente: "lista las herramientas de felku-connect". Si lista felku_get_connection_status, felku_send_text y las demás, está conectado. Si la respuesta es connection_required, falta conectar WhatsApp o Telegram en el panel.

Claude Code

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

Sin --scope, Claude Code guarda la configuración solo para ti, en este proyecto (alcance local). Atención: la shell cambia $FELKU_CONNECT_KEY por su valor, y la clave queda guardada en el archivo de configuración de Claude Code en tu computadora (~/.claude.json, en la entrada de este proyecto). No va al proyecto ni a Git, pero quien lea ese archivo lee la clave.

Nunca uses --scope user. Con él, todos los agentes, en todos los proyectos de tu computadora, obtienen acceso a tu WhatsApp. Evita también --scope project: escribe en el .mcp.json del proyecto, que suele ir a Git.

Codex

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

Codex guarda solo el nombre de la variable y lee la clave de ella al conectarse: la clave no queda en el archivo de configuración. Mantén FELKU_CONNECT_KEY definida en el entorno donde corre Codex.

Cursor

En .cursor/mcp.json (solo este proyecto; en ese caso, no lo envíes a Git) o ~/.cursor/mcp.json (todos los proyectos):

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

Cursor cambia ${env:FELKU_CONNECT_KEY} por el valor de la variable de entorno (defínela en el perfil de tu shell o en el sistema). Luego abre Customize en la barra lateral y comprueba que felku-connect aparece activado.

Hermes

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

Hermes pregunta si el servidor requiere autenticación (responde que sí) y pide el token: pega solo la clave (fkc_...). Guarda la clave en el archivo .env de Hermes, como MCP_FELKU_CONNECT_API_KEY, y el config.yaml queda solo con la plantilla Authorization: Bearer ${MCP_FELKU_CONNECT_API_KEY}. Para comprobar: hermes mcp test felku-connect.

Otro cliente MCP

Cualquier cliente que hable MCP por HTTP funciona:

  • Transporte: Streamable HTTP, solo POST, respuesta en JSON (sin streaming de eventos).

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

  • Encabezado: Authorization: Bearer <tu clave>.

  • Sin sesión: el servidor no usa Mcp-Session-Id. Los clientes de la revisión 2026-07-28 envían la versión en cada pedido; los anteriores hacen initialize antes y después envían la versión acordada en el encabezado MCP-Protocol-Version.

Prueba rápida en la terminal (como el servidor no tiene sesión, puedes listar las herramientas directamente, sin 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"}'

Un agente que responde por conexión

Cada clave lee los mensajes nuevos con su propio cursor. Si dos agentes, con dos claves, leen la misma conexión, los dos reciben los mismos mensajes y los dos pueden responder. Para no responder dos veces, deja solo un agente con clave de envío en cada conexión y dales a los demás claves solo de lectura.

WhatsApp, Telegram, Claude, OpenAI, Codex, Cursor, Hermes y OpenBot son marcas de sus respectivos dueños. Felku no está afiliado, patrocinado ni respaldado por ellos. La conexión con WhatsApp no es oficial.

Idioma y tema