- URL:
http://<host>:3000<APP_BASE_PATH>/mcp(по умолчаниюhttp://localhost:3000/mcp) - Включено по умолчанию. Отключите при помощи
MCP_ENABLED=falseили--mcp-enabled=false. - Stateless: нет сессионной рукопожатия для поддержания живых между звонками.
Обновление с старого релиза? Автономная команда
./whatsapp mcp и её конечная точка SSE по порту 8080 (/sse) пропали. Запустите ./whatsapp rest и указывает на клиентов /mcp. Старый одноинструмента-для операции был заменен консолидированными инструментами ниже.Подключить клиента
/mcp сидит за Базовым Авторизом, как REST API. Отправьте заголовок Authorization плюс X-Device-Id, если у вас несколько устройств:
YWRtaW46Y2hhbmdlbWU= это base64("admin:changeme"); генерируйте ваш с помощью echo -n 'user:pass' | base64. Если установлено только одно устройство, поместите Authorization и X-Device-Id.
Точный формат конфигурации зависит от клиента. Если клиент может запускать только stdio серверы, используйте мост, такой как mcp-remote.
Инструменты
GOWA раскрывает семь инструментов. Каждый принимает аргументtype (send) или action (все остальные), который выбирает операцию.
Примечания к аргументам:
whatsapp_sendвсегда нуженtypeиphone. Медиа отправляется только по URL (image_url,video_url,audio_url,file_url,sticker_url); MCP не может загружать локальные файлы.linkнуженlinkиcaption;forwardнуженmessage_id.whatsapp_sendпринимает поля расписания (scheduled_at,timezone,recurrence,weekdays,day_of_month,end_at,occurrence_limit). Управление результатами с помощьюwhatsapp_schedule(get,pause,resumeиcancelнужноschedule_id).whatsapp_messageнуженphone(чат) иmessage_id;editтакже нуженmessage.- В GOWA
mainпосле v9.9.0,whatsapp_messageс помощьюaction: "edit"принимаетmedia_type: "image"илиmedia_type: "document"для замены заголовка. Сопоставьте исходный тип файла и пропуститеlink. Смотрите Изменить субтитры. whatsapp_chat:get_messagesнуженchat_jid;archiveнуженchat_jidиarchived.whatsapp_app:login_codeнуженphone.
HTTP_PROXY или HTTPS_PROXY. Загрузка локальных файлов требует REST API.
Ваш клиент MCP показывает полную схему ввода каждого инструмента. Конечная точка HTTP принимает POST и DELETE. GET SSE стриминг отключен.
Выбор устройства
Каждый вызов решает свое устройство в указанном порядке:- Аргумент
device_idпри вызове инструментов. - Заголовок
X-Device-Idна MCP соединении. - Единственное зарегистрированное устройство, когда оно существует.
device identification required: set the X-Device-Id header or pass device_id. См. Multi-device.
Удаленные клиенты с OAuth
Hosted clients such as Claude custom connectors cannot add a Basic Auth header. Для них GOWA может запустить сервер авторизации OAuth 2.1 для/mcp. По умолчанию он отключен.
APP_BASIC_AUTHдолжен быть установлен: страница авторизации подписывает пользователей с этими же учетными записями. Без нее запуск не выполняется.- Эмитент и ресурс должны быть публичными HTTPS URL, видимыми клиентами, а не внутренними адресами типа
http://gowa:3000. - С OAuth
/mcpпринимает токен Марера или Базовая Авто. Жетоны не принимаются на маршрутах REST или UI. - Клиенты регистрируются (динамическая регистрация клиентов) с использованием RFC 7591, регистрационные органы ограничены 16 киБ и перенаправляют URI на 2 киБ. Регистрация ограничена 40 в час и 1000 неиспользованных клиентов после 24 часов.
- Использование PKCE
S256обязательно. Срок действия кодов — 5 минут, токенов доступа — 1 час; токены обновления ротируются, а повторное использование старого токена отзывает всё семейство токенов. ВMCP_OAUTH_DB_URI(по умолчаниюfile:storages/oauth.db) хранятся только SHA-256-хеши токенов.
localhost требуют явно указанного порта и точного совпадения. Для остальных перенаправлений требуется HTTPS. Параметр OAuth resource привязан к каноническому URL MCP; в запросах токенов его можно опустить, но указанное значение должно совпадать. Успешные ответы авторизации содержат iss.
Устаревшие коды и токены обрабатываются во время записи OAuth. Повернутые хэши refresh-token сохраняются и необходимы для обнаружения перебоев с живой семьей, в течение почти одного последующего времени жизни до 30 дней. Удаление или замена базы данных OAuth лишает права существующих клиентов и грантов.
Конечные точки, относительно издателя: /oauth/authorize, /oauth/token, /oauth/register. Обнаруженные метаданные используют известные URL в корне домена, поэтому с APP_BASE_PATH=/gowa ваш прокси должен маршрутизировать:
https://gowa.example.com/mcp в качестве пользовательского коннектора и войдите в аккаунт APP_BASIC_AUTH.
