whatsmcp

Un servidor MCP sin estado en Cloudflare Workers que expone la Z-API WhatsApp REST API como herramientas, servido a través de Streamable HTTP en https://whatsmcp.unfld.dev/mcp.

Las herramientas se generan en tiempo de compilación a partir de postman.json, por lo que la superficie de herramientas sigue la colección en lugar de mantenerse manualmente. Tres meta-herramientas (zapi_list_endpoints, zapi_describe_endpoint, zapi_request) están siempre registradas, por lo que ningún endpoint queda inalcanzable incluso cuando el filtro del conjunto de herramientas reduce lo que se expone.

Configuración inicial

bun install

Crea .dev.vars en la raíz del repositorio (ignorado por git) con tus credenciales de Z-API:

MCP_AUTH_TOKEN=...
ZAPI_INSTANCE_ID=...
ZAPI_INSTANCE_TOKEN=...
ZAPI_CLIENT_TOKEN=...

ZAPI_INSTANCE_ID y ZAPI_INSTANCE_TOKEN construyen la URL base de la instancia; ZAPI_CLIENT_TOKEN se envía como encabezado Client-Token. MCP_AUTH_TOKEN es el token de portador estático que los clientes deben presentar.

Related MCP server: WA MCP

Ejecución local

bun run dev

Wrangler sirve el Worker en http://localhost:8787. El endpoint de MCP es http://127.0.0.1:8787/mcp. Los clientes deben enviar uno de:

Authorization: Bearer <MCP_AUTH_TOKEN>
Authorization: <MCP_AUTH_TOKEN>

GET /health es público y devuelve { "ok": true, "name": "whatsmcp" }.

Scripts

Vuelve a ejecutar bun run cf-typegen después de cambiar los bindings o las variables en wrangler.jsonc.

Configuración

ZAPI_TOOLSETS (una variable simple en wrangler.jsonc, valor predeterminado *) selecciona qué categorías de Z-API se registran como herramientas, por ejemplo instance,messages,groups. Las meta-herramientas ignoran este filtro.

Despliegue

Los secretos no se almacenan en wrangler.jsonc. Configúralos una vez por entorno:

wrangler secret put MCP_AUTH_TOKEN
wrangler secret put ZAPI_INSTANCE_ID
wrangler secret put ZAPI_INSTANCE_TOKEN
wrangler secret put ZAPI_CLIENT_TOKEN
wrangler deploy

El dominio personalizado whatsmcp.unfld.dev está declarado en wrangler.jsonc y Cloudflare lo aprovisiona en el primer despliegue.

Conexión de un cliente

{
  "mcpServers": {
    "whatsmcp": {
      "url": "https://whatsmcp.unfld.dev/mcp",
      "headers": { "Authorization": "Bearer <MCP_AUTH_TOKEN>" }
    }
  }
}

Se aceptan tanto Authorization: Bearer <MCP_AUTH_TOKEN> como la forma sin prefijo Authorization: <MCP_AUTH_TOKEN>. GET /health es público y no requiere autenticación para comprobaciones de disponibilidad.