whatsmcp

Сервер без состояния 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) всегда зарегистрированы, поэтому ни одна конечная точка никогда не становится недоступной, даже когда фильтр набора инструментов сужает то, что отображается.

Setup

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

Local run

bun run dev

Wrangler обслуживает 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" }.

Scripts

Перезапустите bun run cf-typegen после изменения привязок или переменных в wrangler.jsonc.

Configuration

ZAPI_TOOLSETS (обычная переменная в wrangler.jsonc, по умолчанию *) выбирает, какие категории Z-API регистрируются как инструменты — например, instance,messages,groups. Мета-инструменты игнорируют этот фильтр.

Deploying

Секреты не хранятся в 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 при первом развертывании.

Connecting a client

{
  "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 является общедоступным и не требует аутентификации для проверок доступности.