whatsmcp

Ein zustandsloser MCP-Server auf Cloudflare Workers, der die Z-API WhatsApp REST-API als Tools bereitstellt, ausgeliefert über Streamable HTTP unter https://whatsmcp.unfld.dev/mcp.

Tools werden zur Build-Zeit aus postman.json generiert, sodass die Tool-Oberfläche der Sammlung folgt, anstatt manuell gepflegt zu werden. Drei Meta-Tools (zapi_list_endpoints, zapi_describe_endpoint, zapi_request) sind immer registriert, sodass kein Endpunkt jemals unerreichbar ist, selbst wenn der Toolset-Filter die bereitgestellten Tools einschränkt.

Einrichtung

bun install

Erstellen Sie .dev.vars im Repository-Stammverzeichnis (gitignoriert) mit Ihren Z-API-Anmeldedaten:

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

ZAPI_INSTANCE_ID und ZAPI_INSTANCE_TOKEN bilden die Instanz-Basis-URL; ZAPI_CLIENT_TOKEN wird als Client-Token-Header gesendet. MCP_AUTH_TOKEN ist das statische Bearer-Token, das Clients vorweisen müssen.

Related MCP server: WA MCP

Lokale Ausführung

bun run dev

Wrangler stellt den Worker unter http://localhost:8787 bereit. Der MCP-Endpunkt ist http://127.0.0.1:8787/mcp. Clients müssen eines der folgenden senden:

Authorization: Bearer <MCP_AUTH_TOKEN>
Authorization: <MCP_AUTH_TOKEN>

GET /health ist öffentlich und gibt { "ok": true, "name": "whatsmcp" } zurück.

Skripte

Führen Sie bun run cf-typegen erneut aus, nachdem Sie Bindungen oder Variablen in wrangler.jsonc geändert haben.

Konfiguration

ZAPI_TOOLSETS (eine einfache Variable in wrangler.jsonc, Standardwert *) wählt aus, welche Z-API-Kategorien als Tools registriert werden – zum Beispiel instance,messages,groups. Die Meta-Tools ignorieren diesen Filter.

Bereitstellung

Geheimnisse werden nicht in wrangler.jsonc gespeichert. Setzen Sie sie einmal pro Umgebung:

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

Die benutzerdefinierte Domain whatsmcp.unfld.dev ist in wrangler.jsonc deklariert und wird von Cloudflare bei der ersten Bereitstellung bereitgestellt.

Verbinden eines Clients

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

Sowohl Authorization: Bearer <MCP_AUTH_TOKEN> als auch die reine Authorization: <MCP_AUTH_TOKEN>-Form werden akzeptiert. GET /health ist öffentlich und für Uptime-Checks nicht authentifiziert.