Сервер без состояния MCP на Cloudflare Workers, который предоставляет Z-API WhatsApp REST API в виде инструментов, обслуживаемых через Streamable HTTP по адресу https://whatsmcp.unfld.dev/mcp.
Инструменты генерируются во время сборки из postman.json, поэтому поверхность инструментов отслеживает коллекцию, а не поддерживается вручную. Три мета-инструмента (zapi_list_endpoints, zapi_describe_endpoint, zapi_request) всегда зарегистрированы, поэтому ни одна конечная точка никогда не становится недоступной, даже когда фильтр набора инструментов сужает то, что отображается.
bun installСоздайте .dev.vars в корне репозитория (игнорируется git) с вашими учетными данными Z-API:
MCP_AUTH_TOKEN=...
ZAPI_INSTANCE_ID=...
ZAPI_INSTANCE_TOKEN=...
ZAPI_CLIENT_TOKEN=...ZAPI_INSTANCE_ID и ZAPI_INSTANCE_TOKEN формируют базовый URL экземпляра; ZAPI_CLIENT_TOKEN отправляется как заголовок Client-Token. MCP_AUTH_TOKEN — это статический токен Bearer, который должны предоставлять клиенты.
Related MCP server: WA MCP
bun run devWrangler обслуживает Worker по адресу http://localhost:8787. Конечная точка MCP — http://127.0.0.1:8787/mcp. Клиенты должны отправлять один из:
Authorization: Bearer <MCP_AUTH_TOKEN>
Authorization: <MCP_AUTH_TOKEN>GET /health является общедоступным и возвращает { "ok": true, "name": "whatsmcp" }.
Скрипт | Что делает |
| Перегенерировать |
| Запустить Worker локально с помощью |
| Развернуть на Cloudflare |
|
|
| Запустить набор тестов |
| Перегенерировать |
Перезапустите bun run cf-typegen после изменения привязок или переменных в wrangler.jsonc.
ZAPI_TOOLSETS (обычная переменная в wrangler.jsonc, по умолчанию *) выбирает, какие категории Z-API регистрируются как инструменты — например, instance,messages,groups. Мета-инструменты игнорируют этот фильтр.
Секреты не хранятся в wrangler.jsonc. Установите их один раз для каждого окружения:
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Пользовательский домен whatsmcp.unfld.dev объявлен в wrangler.jsonc и предоставляется Cloudflare при первом развертывании.
{
"mcpServers": {
"whatsmcp": {
"url": "https://whatsmcp.unfld.dev/mcp",
"headers": { "Authorization": "Bearer <MCP_AUTH_TOKEN>" }
}
}
}Принимаются как форма Authorization: Bearer <MCP_AUTH_TOKEN>, так и простая форма Authorization: <MCP_AUTH_TOKEN>. GET /health является общедоступным и не требует аутентификации для проверок доступности.
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.
