MCP
Подключите Claude, Cursor или любой MCP-клиент к удалённому серверу WASync. Шесть инструментов, без кода с вашей стороны.
WASync предоставляет удалённый сервер MCP по протоколу Streamable HTTP. Добавьте его в MCP-клиент, и агент получит инструменты WhatsApp без единой строки кода с вашей стороны.
https://cloudapi.wasync.app/api/mcpЭтот хост выбран намеренно. Базовый URL REST и все ссылки для людей используют
developers.wasync.app, но URL сервера MCP, эндпоинты OAuth и документы
/.well-known/… — это идентификаторы протокола, которые клиенты уже
зарегистрировали. Они остаются на cloudapi.wasync.app и должны совпадать
побайтно. Не «нормализуйте» их.
Подключение клиента
Для клиентов, которые читают файл конфигурации (Claude Desktop, Cursor, …):
{
"mcpServers": {
"wasync": {
"url": "https://cloudapi.wasync.app/api/mcp"
}
}
}Аутентификация — OAuth 2.0 с PKCE, её выполняет сам клиент: при первом вызове открывается браузер, вы подтверждаете доступ, и клиент сохраняет токены. Вставлять ключ не нужно.
Клиент без встроенной поддержки удалённого MCP может подключиться через stdio:
npx mcp-remote https://cloudapi.wasync.app/api/mcpПоиск в реестре
WASync есть в официальном реестре MCP (MCP Registry) под именем:
app.wasync/whatsappКлиенты и каталоги, которые читают реестр, найдут сервер по имени, и вставлять URL не придётся.
Инструменты
| Tool | What it does | Needs |
|---|---|---|
list_whatsapp_connections | Показывает подключения, которые разрешено использовать, со статусом и состоянием лицензии. Все остальные инструменты принимают отсюда идентификатор подключения. | read |
get_whatsapp_connection | Текущее состояние одного подключения: в сети или нет, статус лицензии и срок её действия. Только чтение. | read |
read_whatsapp_messages | Сохранённые сообщения, сначала новые, по всем доступным подключениям или по одному; постраничная выдача через nextCursor. Ничего не отправляется, отметка о прочтении не показывается. | read |
send_whatsapp_message | Отправляет текстовое сообщение с одного подключения одному получателю. Описание инструмента требует от модели сначала подтвердить получателя и формулировку: сообщение WhatsApp нельзя отозвать. | send |
send_whatsapp_file | Отправляет файл (документ, изображение, аудио или видео, до 5 МБ) с необязательной подписью. Укажите прямую ссылку https в url (предпочтительно) или base64 в data. То же правило подтверждения: отозвать нельзя. | send |
mark_whatsapp_messages_read | Отмечает входящие сообщения одного клиента как прочитанные (синие галочки) по номеру телефона или по идентификатору сообщения. | send |
Они соответствуют GET /connections, GET /connections/{id}, GET /messages,
POST /messages (текст и медиа) и POST /messages/read и подчиняются тем же
областям доступа: агент может делать только то, что
разрешает выданный доступ.
Отправка файла
send_whatsapp_file принимает ровно одно из полей: url или data:
{
"connectionId": "conn_123",
"to": "40700000000",
"url": "https://files.example.com/offers/offer-2026.pdf",
"filename": "offer-2026.pdf",
"caption": "Here is the offer we discussed."
}urlдолжен быть прямой ссылкойhttps://на файл, который любой пользователь интернета может открыть без входа в систему. WASync скачивает его (до 5 МБ, 20 секунд) и берётmimetypeиз ответа файлового сервера, если вы не передали его сами. Ссылки на частные сети, на сам WASync или на веб-страницу вместо файла отклоняются.data— файл в виде обычной строки base64 (без префиксаdata:), не более 5 МБ после декодирования; в этом случаеmimetypeобязателен. Предпочитайтеurl: передавать байты файла через диалог с моделью медленно и дорого.filename— имя, которое увидит получатель (без слэшей);captionнеобязателен, до 1024 символов.
Ошибки возвращаются как ошибки инструмента со стабильным кодом в начале
сообщения: invalid_url, url_not_allowed, download_failed, file_too_large,
invalid_media или send_failed: <reason>, если WASync отклонил отправку.
MCP или REST API?
Используйте MCP, когда агент под контролем человека должен получить доступ к WhatsApp: отвечать из чат-клиента, готовить черновики ответов, искать информацию. Используйте REST API, когда поведением управляет ваше собственное ПО и нужны webhooks, ключи идемпотентности, файлы больше 5 МБ или подготовка ресурсов — ничего из этого MCP не предоставляет.
Доступ OAuth выдаётся только для подключений, которые уже существуют, поэтому через MCP нельзя создать первое подключение рабочего пространства. Сначала создайте его с помощью API key: Быстрый старт.