mcp-whatsapp-cloud — MCP-сервер для Claude Code: WhatsApp Cloud API
MCP-сервер для WhatsApp Cloud API: отправка сообщений, медиа и шаблонов через Graph API напрямую от Meta.
claude mcp add --env WHATSAPP_ACCESS_TOKEN=<WHATSAPP_ACCESS_TOKEN> --env WHATSAPP_PHONE_NUMBER_ID=<WHATSAPP_PHONE_NUMBER_ID> --env WHATSAPP_BUSINESS_ACCOUNT_ID=<WHATSAPP_BUSINESS_ACCOUNT_ID> --env WHATSAPP_GRAPH_VERSION=<WHATSAPP_GRAPH_VERSION> --transport stdio whatsapp-cloud -- npx -y @codespar/mcp-whatsapp-cloudЧто делает mcp-whatsapp-cloud
Сервер даёт агенту 22 инструмента для работы с WhatsApp Cloud API. Отправка текста, шаблонов, медиа, интерактивных сообщений с кнопками и списками, геолокации, контактов, реакций. Отдельная группа — управление медиа: загрузка файла, получение ссылки по media_id, удаление. Ещё есть работа с шаблонами и профилем бизнеса.
Авторизация — Bearer-токен к Graph API. Нужен постоянный токен системного пользователя из Meta Business Manager: пользовательские токены истекают и ломают продакшен. В переменных окружения задаются WHATSAPP_ACCESS_TOKEN, WHATSAPP_PHONE_NUMBER_ID и WHATSAPP_BUSINESS_ACCOUNT_ID, версия Graph API — по желанию. Номера телефонов пишутся в формате E.164 без ведущего +.
Есть правила отправки, о которых стоит помнить. В течение 24 часов после последнего сообщения пользователя можно слать что угодно, а вне этого окна — только одобренный шаблон. Шаблон сначала создаётся, потом ждёт проверки Meta. Загруженное медиа живёт около 30 дней, поэтому для постоянных ассетов лучше держать ссылку или перезаливать файл. Сервер рассчитан на продавцов с одобренным WhatsApp Business Account: интеграция идёт напрямую, без посредников и их наценки.
Какие задачи решает
- отправить клиенту текст или шаблон из агента
- загрузить картинку и переиспользовать её
media_id - собрать интерактивное сообщение с кнопками подтверждения
- создать шаблон и дождаться одобрения Meta
- отметить входящее сообщение прочитанным
Примеры запросов агенту
- Отправь клиенту
5511999999999шаблонorder_confirmedна португальском - Загрузи
catalog.pngи пришли его в ответ на последнее сообщение - Собери интерактивное сообщение с кнопками «Подтвердить» и «Отменить»
Как установить mcp-whatsapp-cloud
Командой платформы
claude mcp add --env WHATSAPP_ACCESS_TOKEN=<WHATSAPP_ACCESS_TOKEN> --env WHATSAPP_PHONE_NUMBER_ID=<WHATSAPP_PHONE_NUMBER_ID> --env WHATSAPP_BUSINESS_ACCOUNT_ID=<WHATSAPP_BUSINESS_ACCOUNT_ID> --env WHATSAPP_GRAPH_VERSION=<WHATSAPP_GRAPH_VERSION> --transport stdio whatsapp-cloud -- npx -y @codespar/mcp-whatsapp-cloudВместо <…> подставьте свои значения
Командой платформы
codex mcp add whatsapp-cloud --env WHATSAPP_ACCESS_TOKEN=<WHATSAPP_ACCESS_TOKEN> --env WHATSAPP_PHONE_NUMBER_ID=<WHATSAPP_PHONE_NUMBER_ID> --env WHATSAPP_BUSINESS_ACCOUNT_ID=<WHATSAPP_BUSINESS_ACCOUNT_ID> --env WHATSAPP_GRAPH_VERSION=<WHATSAPP_GRAPH_VERSION> -- npx -y @codespar/mcp-whatsapp-cloudВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"whatsapp-cloud": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-whatsapp-cloud"
],
"env": {
"WHATSAPP_ACCESS_TOKEN": "<WHATSAPP_ACCESS_TOKEN>",
"WHATSAPP_PHONE_NUMBER_ID": "<WHATSAPP_PHONE_NUMBER_ID>",
"WHATSAPP_BUSINESS_ACCOUNT_ID": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
"WHATSAPP_GRAPH_VERSION": "<WHATSAPP_GRAPH_VERSION>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"whatsapp-cloud": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-whatsapp-cloud"
],
"env": {
"WHATSAPP_ACCESS_TOKEN": "<WHATSAPP_ACCESS_TOKEN>",
"WHATSAPP_PHONE_NUMBER_ID": "<WHATSAPP_PHONE_NUMBER_ID>",
"WHATSAPP_BUSINESS_ACCOUNT_ID": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
"WHATSAPP_GRAPH_VERSION": "<WHATSAPP_GRAPH_VERSION>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e WHATSAPP_ACCESS_TOKEN=<WHATSAPP_ACCESS_TOKEN> -e WHATSAPP_PHONE_NUMBER_ID=<WHATSAPP_PHONE_NUMBER_ID> -e WHATSAPP_BUSINESS_ACCOUNT_ID=<WHATSAPP_BUSINESS_ACCOUNT_ID> -e WHATSAPP_GRAPH_VERSION=<WHATSAPP_GRAPH_VERSION> whatsapp-cloud npx -y @codespar/mcp-whatsapp-cloudВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-whatsapp-cloud
Как установить mcp-whatsapp-cloud в Claude Code?
Выполните `claude mcp add mcp-whatsapp-cloud -e WHATSAPP_ACCESS_TOKEN=<WHATSAPP_ACCESS_TOKEN> -e WHATSAPP_PHONE_NUMBER_ID=<WHATSAPP_PHONE_NUMBER_ID> -e WHATSAPP_BUSINESS_ACCOUNT_ID=<WHATSAPP_BUSINESS_ACCOUNT_ID> -- npx -y @codespar/mcp-whatsapp-cloud`. Подставьте свои значения токена и идентификаторов.
Что делает mcp-whatsapp-cloud?
Это MCP-сервер для WhatsApp Cloud API от Meta. Через него агент отправляет сообщения, медиа и шаблоны, управляет профилем бизнеса и номерами.
Почему сообщение не уходит вне 24-часового окна?
После последнего сообщения пользователя есть 24 часа, когда можно слать любой тип. Дальше Cloud API принимает только одобренный шаблон — используйте send_template_message.
