El servidor MCP

MCP es la forma en que una app de IA usa herramientas externas. Conecta Claude, ChatGPT, Codex o cualquier cliente MCP a whatsapi, y podrá enviar mensajes, leer chats y gestionar tus números. Cada herramienta sale de la misma definición que su versión REST, así que tienes la misma validación, la misma cuota y los mismos errores.

Claude Code y Codex: instala el plugin

El plugin de whatsapi conecta tu agente a whatsapi. No hay ninguna clave que copiar.

Claude Code

claude plugin marketplace add owe-br/plugins
claude plugin install whatsapi@owe-br

Luego escribe /mcp, elige whatsapi y pulsa Authenticate.

Codex

codex plugin marketplace add owe-br/plugins
codex plugin add whatsapi@owe-br
codex mcp login whatsapi

La última línea inicia tu sesión. Necesita Codex 0.147 o posterior: las versiones anteriores fallan con "missing required issuer". Para actualizar, ejecuta npm install -g @openai/codex@latest.

En los dos casos, tu navegador abre whatsapi. Inicia sesión y pulsa Conectar. Eso crea una clave de API con el nombre de la app, que aparece en Claves de API en el panel. Para desconectar la app, revoca esa clave.

Ver el plugin en GitHub

claude.ai y ChatGPT: agrega un conector

En las apps que inician sesión desde el navegador, agrega un conector personalizado con esta dirección y sin clave:

MCP URL

https://api.whatsapi.sh/mcp

La app abre whatsapi, inicias sesión y pulsas Conectar. Recibe su propia clave de API, y sus mensajes cuentan para tu cuota mensual como los de cualquier otra clave.

Un agente sin navegador

Un script en un servidor o en un contenedor puede iniciar sesión con un código corto en vez de pegar una clave. Empieza el inicio de sesión:

curl https://api.whatsapi.sh/oauth/device_authorization -d client_id=whatsapi-agent

Muéstrale a la persona el enlace verification_uri_complete. Lo abre, revisa el código y pulsa Conectar. Mientras tanto, pide la clave cada 5 segundos:

# device_code comes from the first answer
curl https://api.whatsapi.sh/oauth/token \
  -d client_id=whatsapi-agent \
  -d grant_type=urn:ietf:params:oauth:grant-type:device_code \
  -d device_code=DEVICE_CODE

Hasta que pulse Conectar, la respuesta es authorization_pending. Después, access_token es una clave wa_, que se envía una sola vez. El código caduca a los 10 minutos.

Cualquier otro cliente: usa una clave

Crea una clave en Claves de API en el panel y envíala en el header Authorization. La mayoría de los clientes aceptan un bloque como este:

mcp.json

{
  "mcpServers": {
    "whatsapi": {
      "type": "streamable-http",
      "url": "https://api.whatsapi.sh/mcp",
      "headers": { "Authorization": "Bearer wa_your_key" }
    }
  }
}

Qué puede ver una app y qué guardamos sobre ella: Privacidad al conectar una app de IA.

Cargando la lista de herramientas…