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.
bun installErstellen 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
bun run devWrangler 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.
Skript | Was es tut |
| Generiert |
| Führt den Worker lokal mit |
| Stellt auf Cloudflare bereit |
|
|
| Führt die Testsuite aus |
| Generiert |
Führen Sie bun run cf-typegen erneut aus, nachdem Sie Bindungen oder Variablen in wrangler.jsonc geändert haben.
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.
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 deployDie benutzerdefinierte Domain whatsmcp.unfld.dev ist in wrangler.jsonc deklariert und wird von Cloudflare
bei der ersten Bereitstellung bereitgestellt.
{
"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.
This server cannot be deployed
Hosted MCP server connecting AI assistants to 9,000+ apps and 40,000+ actions via Zapier.
WhatsMCP connects Claude and other MCP-compatible AI agents directly to WhatsApp. Send and receive text, images, documents, and voice notes; manage groups (create, add/remove members, promote admins); look up contacts and profiles; follow channels; and read call and message history — all through a standard MCP interface. For voice use cases, WhatsMCP offers SIP-based calling plans (inbound-only, or full inbound/outbound) so AI voice agents can answer and place WhatsApp calls, plus low-latency WebSocket integrations with voice agent providers like ElevenLabs. Multiple WhatsApp accounts can be paired and managed per workspace, with webhook support for real-time inbound message delivery to your own infrastructure.
Hosted MCP server for your own WhatsApp accounts: messages, contacts, groups, channels, calls.
Your own WhatsApp as an MCP server: read, search and send from any MCP client.
