WhatsApp в любом MCP-клиенте: Gemini CLI, VS Code, Cursor, Devin Desktop (Windsurf) и другие
Любой MCP-клиент, который поддерживает удалённые серверы по Streamable HTTP с OAuth, может работать с номером WhatsApp Business: добавьте URL сервера, один раз войдите через браузер, и инструменты WhatsApp появятся. Отличается только конфигурация. Cursor и Zed принимают url, Gemini CLI принимает httpUrl, Antigravity принимает serverUrl, а VS Code и Cline требуют указать транспорт HTTP.
easyCoexistence запускает один удалённый MCP-сервер, https://easycoexistence.com/api/mcp, со входом через OAuth и более чем 30 инструментами для номеров WhatsApp Business, которые вы подключаете через Coexistence: состояние, сообщения, шаблоны, маршрутизация и автоматизации из любого клиента, который работает по Streamable HTTP.
Ключ настроек Gemini CLI для сервера Streamable HTTP; url там означает эндпоинт SSE.
Ключ Antigravity для удалённого сервера; url тоже работает, а httpUrl и устаревший транспорт SSE не поддерживаются.
Когда Gemini CLI был заменён Antigravity CLI для пользователей бесплатного тарифа и Google One.
Тип, который нужно указать для удалённого сервера в Cline; если его не указать, Cline использует устаревший транспорт SSE.
Новое название Windsurf; в FAQ говорится, что меняются только название и брендинг.
MCP-сервер easyCoexistence работает по Streamable HTTP в режиме без сохранения состояния и не открывает поток SSE.
Что нужно клиенту, чтобы подключиться к удалённому MCP-серверу WhatsApp?
Три вещи, и они есть у большинства современных клиентов. Streamable HTTP, транспорт MCP, при котором клиент отправляет POST на один URL; сервер здесь работает в режиме без сохранения состояния и не открывает поток SSE, поэтому клиент, настроенный на SSE, не сможет подключиться. Обнаружение OAuth: при первом запросе сервер отвечает 401 с указанием на свои метаданные, клиент регистрируется через динамическую регистрацию клиента и открывает браузер, а вход выполняется с PKCE. И браузер на той машине, где работает клиент.
В конфигурации не нужны заголовки, ключи API или токены. Сервер принимает версии протокола 2025-06-18, 2025-03-26 и 2024-11-05, а клиент, который поддерживает только локальные серверы, запущенные на вашем компьютере, не сможет к нему подключиться.
Какая конфигурация нужна каждому клиенту?
Каждый из этих вариантов проверен по документации клиента 11 ноября 2026 года. Схема одна и та же: имя и URL https://easycoexistence.com/api/mcp. Но ключ, в котором хранится URL, и место, где находится запись, у клиентов различаются, а неверный ключ в некоторых клиентах приводит к тихому сбою. Каждой записи нужны только имя и URL, без заголовков и токенов:
Как выглядят файлы конфигурации?
Здесь записи для клиентов, которые хранят серверы в файле, так, как это показано в их документации. Вставьте запись для вашего клиента в файл, указанный выше, объединив её с уже имеющимися серверами, затем перезагрузите клиент и завершите вход, который он откроет. Если клиент также предлагает команду или форму, этот путь запишет ту же запись за вас:
// Cursor: ~/.cursor/mcp.json
{ "mcpServers": { "easycoexistence": { "url": "https://easycoexistence.com/api/mcp" } } }
// VS Code with Copilot: ~/.copilot/mcp-config.json
{ "mcpServers": { "easycoexistence": { "type": "http", "url": "https://easycoexistence.com/api/mcp" } } }
// Gemini CLI: ~/.gemini/settings.json
{ "mcpServers": { "easycoexistence": { "httpUrl": "https://easycoexistence.com/api/mcp" } } }
// Antigravity: ~/.gemini/config/mcp_config.json
{ "mcpServers": { "easycoexistence": { "serverUrl": "https://easycoexistence.com/api/mcp" } } }
// Zed: settings.json
{ "context_servers": { "easycoexistence": { "url": "https://easycoexistence.com/api/mcp" } } }
// Cline: cline_mcp_settings.json
{ "mcpServers": { "easycoexistence": { "type": "streamableHttp", "url": "https://easycoexistence.com/api/mcp" } } }Как добавить сервер в VS Code?
При выбранном Copilot выполните команду `Chat: Open Customizations`, выберите раздел MCP-серверы и нажмите «Добавить сервер» (+) в группе User, либо выполните `MCP: Add Server` в командной палитре, чтобы пройти тот же пошаговый сценарий. Выберите HTTP (HTTP или Server-Sent Events), вставьте URL, введите easycoexistence как ID сервера, затем выберите Global и Copilot Global для личной настройки, общей для ваших рабочих областей на этом компьютере. Завершите авторизацию, когда VS Code её запросит.
Справочник Microsoft называет старый файл .vscode/mcp.json с ключом servers устаревшим форматом, которым управляет редактор, и рекомендует для новых настроек файлы Copilot. Файл .mcp.json в корне рабочей области делится сервером с коллегами; поскольку запись не содержит секретов, его безопасно коммитить.
Как добавить сервер в Gemini CLI и Antigravity?
В Gemini CLI выполните: gemini mcp add --transport http easycoexistence https://easycoexistence.com/api/mcp -s user. Без -s user сервер сохраняется в проекте, в файле .gemini/settings.json. Затем выполните /mcp auth easycoexistence, чтобы войти; та же команда выполняет повторный вход, когда токены истекают. Google сообщает, что Gemini CLI заменён Antigravity CLI 18 июня 2026 года для пользователей бесплатного тарифа и Google One.
В Antigravity добавьте запись с serverUrl в ~/.gemini/config/mcp_config.json для всех проектов или в .agents/mcp_config.json для одной рабочей области. В CLI команда /mcp открывает менеджер MCP со статусом каждого сервера; в IDE выберите … на панели агента, затем MCP-серверы, «Управление MCP-серверами» и «Просмотреть исходную конфигурацию». Поскольку сервер поддерживает динамическую регистрацию клиента, ID клиента не нужен.
Как добавить сервер в Zed, Cline и Devin?
В Zed откройте «Настройки» > AI > MCP-серверы, нажмите «Добавить сервер» и выберите «Добавить удалённый сервер»; если в записи нет заголовка Authorization, Zed запускает стандартный поток авторизации MCP OAuth. В Cline откройте значок MCP-серверов, затем вкладку «Удалённые серверы», введите имя и URL, выберите Streamable HTTP и нажмите «Добавить сервер». В Cline CLI выполните cline mcp add easycoexistence с URL и --transport http, затем действие «Авторизовать OAuth» в мастере.
Devin Desktop, новое название Windsurf, управляет серверами в разделе «Настроить» > MCP в окне агентов и хранит их в ~/.config/devin/mcp_config.json или в папке .devin проекта; когда сохранённые учётные данные истекают, сервер показывает «требуется аутентификация», и «Пройти аутентификацию» выполняет вход снова. В Devin CLI выполните devin mcp add easycoexistence с URL и -s user, поскольку по умолчанию действует локальная область, затем devin mcp login easycoexistence.
Что работает одинаково во всех клиентах?
Всё, что стоит за URL. Каждый клиент входит в один и тот же аккаунт easyCoexistence, видит одни и те же номера через list_numbers и получает одни и те же более 30 инструментов. Вместе с ними приходят правила Meta: свободный текст можно отправить только тому, кто писал в последние 24 часа; шаблоны отправляются только через API; номер Coexistence отправляет не более 20 сообщений в секунду. Инструменты отправки требуют активного тарифа во всех клиентах, а инструменты чтения продолжают работать.
Различается контроль самого клиента над вызовами инструментов, например, Cursor по умолчанию запрашивает подтверждение перед использованием инструмента MCP. Сервер передаёт список инструментов при подключении клиента и не сообщает об изменениях, поэтому перезагрузите или переподключите клиент, когда в вашем аккаунте появится новая функция.
Как настроить
- Connect your numberSign up at easycoexistence.com and connect the number through Meta's Embedded Signup; the WhatsApp Business app keeps working on the phone.
- Add the serverUse your client's command or form, or paste its entry into the right file, with https://easycoexistence.com/api/mcp as the URL.
- Reload and sign inReload the client, then approve the browser sign-in it opens with your easyCoexistence account.
- Try a requestAsk "Which WhatsApp numbers do I have, and are they healthy?" and check that the client calls list_numbers.
Распространённые ошибки
- Указание url в settings.json Gemini CLI. Там это означает эндпоинт SSE, который этот сервер не открывает; используйте httpUrl или gemini mcp add --transport http.
- Пропуск type в записи Cline. Тогда Cline использует устаревший транспорт SSE и подключение не работает; укажите type как streamableHttp.
- Добавление сервера в Gemini CLI или Devin CLI без области, и тогда его не видно в другой папке. Gemini по умолчанию использует область проекта, а Devin локальную; передайте -s user.
- Вход с сервера без графического интерфейса или через сессию SSH. Gemini CLI документирует, что его вход по OAuth требует локального браузера и обратного вызова на localhost, поэтому выполняйте вход на собственном компьютере.
Приложение остаётся на вашем телефоне, а каждый номер находится под мониторингом 24/7 с оповещениями. От US$ 9 до US$ 0,75 за подключённый номер в месяц, по мере добавления номеров. Первые 3 дня бесплатно.
Часто задаваемые вопросы
Есть ли локальная версия для установки?
Нет. Сервер работает только удалённо, поэтому нет ни пакета, ни команды npx, ни процесса, который нужно держать запущенным. Закрытие клиента ничего не меняет на подключённом номере.
Можно ли передать ключ API в заголовке вместо входа?
Нет. MCP-сервер принимает только токены OAuth из собственного входа easyCoexistence. Ключ ec_live_ из create_api_key относится к Partner API, REST API для программ, которые подключают номера своих клиентов, и не открывает MCP-сервер.
Как долго действует вход?
Токены доступа действуют 1 час, и клиент продлевает их сам с помощью токена обновления; каждое продление выдаёт новый токен обновления, а токен обновления истекает через 60 дней без использования. После такого перерыва клиент попросит вас войти снова.
Могут ли несколько клиентов одновременно использовать один аккаунт?
Да. Каждый клиент входит самостоятельно, поэтому Cursor, VS Code и агент в терминале могут работать бок о бок с одними и теми же номерами, а удаление одного оставляет остальные подключёнными.
Читайте дальше
Готовы начать?
Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный периодПроверено по состоянию на