mcp-evolution-api — MCP-сервер для Claude Code: WhatsApp
Сервер даёт агенту 25 инструментов для WhatsApp через ваш собственный инстанс Evolution API: сообщения, группы, контакты, состояние подключения.
claude mcp add mcp-evolution-api -e EVOLUTION_API_KEY=<EVOLUTION_API_KEY> -- npx -y @codespar/mcp-evolution-apiЧто делает mcp-evolution-api
Это обёртка над Evolution API — самостоятельно развёрнутым WhatsApp-шлюзом. Агент вызывает инструменты вида send_text, send_image, get_qrcode, create_group или connection_state, а сервер переводит вызов в запрос к вашему инстансу. Публичного демо нет: Evolution API вы поднимаете сами, проще всего в Docker, и оттуда берёте ключ.
Для запуска нужны две переменные окружения: EVOLUTION_API_URL с адресом инстанса и EVOLUTION_API_KEY. Ключ уходит в заголовке apikey — без него сервер не авторизуется, так что сначала разверните инстанс и достаньте ключ из его конфигурации. Подключение делается через npx в конфиге MCP-клиента или командой для Claude и Codex.
Инструменты покрывают переписку и администрирование инстансов: список инстансов, перезапуск, выход из сессии, удаление, пометка сообщений прочитанными, архивация чатов, работа с участниками групп. Массовую рассылку и шаблонные сообщения WhatsApp Business в этой версии не ждите — они значатся в планах на v0.3.
Какие задачи решает
- отправить текст или картинку в WhatsApp из агента
- показать QR-код для привязки нового инстанса
- проверить, зарегистрирован ли номер в WhatsApp
- добавить и исключить участников группы
- выгрузить историю чата с постраничной навигацией
Примеры запросов агенту
- Проверь через
check_number, есть ли WhatsApp у этого номера - Отправь в
send_textкороткое сообщение клиенту и покажи статус доставки - Запроси
get_qrcodeдля инстанса и выведи код, чтобы я его отсканировал
Как установить mcp-evolution-api
Командой платформы
claude mcp add mcp-evolution-api -e EVOLUTION_API_KEY=<EVOLUTION_API_KEY> -- npx -y @codespar/mcp-evolution-apiВместо <…> подставьте свои значения
Командой платформы
codex mcp add evolution-api --env EVOLUTION_API_KEY=<EVOLUTION_API_KEY> -- npx -y @codespar/mcp-evolution-apiВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"evolution-api": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-evolution-api"
],
"env": {
"EVOLUTION_API_KEY": "<EVOLUTION_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"evolution-api": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-evolution-api"
],
"env": {
"EVOLUTION_API_KEY": "<EVOLUTION_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e EVOLUTION_API_KEY=<EVOLUTION_API_KEY> evolution-api npx -y @codespar/mcp-evolution-apiВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-evolution-api
Как установить mcp-evolution-api в Claude Code?
Одной командой: claude mcp add mcp-evolution-api -e EVOLUTION_API_KEY=<EVOLUTION_API_KEY> -- npx -y @codespar/mcp-evolution-api. Ключ подставьте свой, адрес инстанса задайте в конфигурации.
Что делает mcp-evolution-api?
Превращает методы Evolution API в инструменты MCP: отправка сообщений и файлов, управление инстансами и группами, чтение чатов.
Что нужно, чтобы сервер заработал?
Свой развёрнутый инстанс Evolution API и его API-ключ — сервер ходит только к нему, готового облачного варианта нет.
