mcp-z-api — MCP-сервер для Claude Code: WhatsApp через Z-API
MCP-сервер, через который агент пишет в WhatsApp от имени вашего инстанса Z-API: тексты, медиа, контакты, группы.
claude mcp add mcp-z-api -e ZAPI_TOKEN=<ZAPI_TOKEN> -- npx -y @codespar/mcp-z-apiЧто делает mcp-z-api
Сервер ставит между агентом и Z-API прослойку с 27 инструментами. Агент может отправить текст, картинку, документ или аудио, получить список контактов, проверить, есть ли у номера WhatsApp, вытащить аватарку и метаданные контакта. Отдельная группа инструментов — чаты и группы: список чатов с постраничной выдачей, отметка прочитанным, создание группы, добавление и удаление участников, метаданные группы.
Есть и интерактивные форматы: список кнопок, нативный список опций и кнопки действий CALL, URL, REPLY. Для разметки служат метки — их можно вешать на чат и перечислять. Авторизация у Z-API построена на паре instance ID и token, которые подставляются в URL запроса.
Перед установкой заведите аккаунт в портале разработчика Z-API и возьмите оттуда instance ID и token — без них сервер к WhatsApp не подключится. В конфигурации платформ, которые перечислены ниже, фигурирует только ZAPI_TOKEN, так что сверьтесь с документацией Z-API насчёт второго значения. Лицензия MIT, распространяется как пакет @codespar/mcp-z-api в npm.
Какие задачи решает
- отправить текст или файл в WhatsApp прямо из сессии агента
- проверить, зарегистрирован ли номер в WhatsApp, перед рассылкой
- собрать список чатов и групп с постраничной выдачей
- создать группу и добавить в неё участников
- пометить сообщения прочитанными или удалить их
Примеры запросов агенту
- Отправь в WhatsApp на номер из
contacts.jsonсообщение с текстом приветствия - Проверь, есть ли WhatsApp у номера, и покажи аватарку
- Создай группу «Проект» и добавь туда двух участников
Как установить mcp-z-api
Командой платформы
claude mcp add mcp-z-api -e ZAPI_TOKEN=<ZAPI_TOKEN> -- npx -y @codespar/mcp-z-apiВместо <…> подставьте свои значения
Командой платформы
codex mcp add z-api --env ZAPI_TOKEN=<ZAPI_TOKEN> -- npx -y @codespar/mcp-z-apiВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"z-api": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-z-api"
],
"env": {
"ZAPI_TOKEN": "<ZAPI_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"z-api": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-z-api"
],
"env": {
"ZAPI_TOKEN": "<ZAPI_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e ZAPI_TOKEN=<ZAPI_TOKEN> z-api npx -y @codespar/mcp-z-apiВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-z-api
Как установить mcp-z-api в Claude Code?
Выполните claude mcp add mcp-z-api -e ZAPI_TOKEN=<ZAPI_TOKEN> -- npx -y @codespar/mcp-z-api. Есть второй вариант: claude mcp add --env ZAPI_TOKEN=<ZAPI_TOKEN> --transport stdio z-api -- npx -y @codespar/mcp-z-api.
Что делает mcp-z-api?
Даёт агенту инструменты Z-API для WhatsApp: отправка сообщений и медиа, работа с контактами, чатами, метками и группами, интерактивные списки и кнопки.
Что нужно для работы сервера?
Инстанс Z-API: аккаунт в портале разработчика, instance ID и token. Без действующего инстанса инструменты не достучатся до WhatsApp.
