Как подключить Zalo Official Account к Claude через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Zalo Official Account, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Zalo Official Account + Claude

Zalo Official Account (Вьетнам): профиль OA и квота сообщений, подписчики и пользователи с их данными и метками, последние чаты и переписка, консультационные сообщения с текстом или изображением и статьи OA. Использует вставленный вручную токен доступа OA, который действует около 25 часов.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

ZALO_OA_ACCESS_TOKEN

Шаг 1 — Получите учётные данные

Настройка занимает около 5 минут, а токен нужно обновлять каждый день (см. ниже). Нужен Zalo Official Account и администратор OA, который одобряет разрешения.

1. На https://developers.zalo.me создайте приложение или откройте своё, привяжите его к своему Official Account и в разделе Official Account > OA permissions запросите группы разрешений, которые использует коннектор: управление информацией OA, управление информацией о пользователях, управление сообщениями пользователей, отправка сообщений и уведомлений через OA и управление статьями. Администратор OA их одобряет.
2. Откройте Tools > API Explorer (https://developers.zalo.me/tools/explorer), выберите своё приложение, тип токена доступа OA Access Token и OA, разрешите запрошенные права и скопируйте access token.
3. Вставьте его в ZALO_OA_ACCESS_TOKEN. Он передаётся в заголовке access_token, которого требует Zalo.
4. Установите коннектор и запустите zalo_oa_get_oa_info, чтобы проверить его.

Токен действует около 25 часов. Zalo обновляет токены доступа OA только через собственный процесс OAuth v4, который AnythingMCP не может выполнить для этого коннектора, поэтому токен вставляется вручную. Когда вызовы отвечают ошибкой -216 или -220, создайте новый токен в API Explorer и сохраните его в настройках коннектора. Если вы обновляете токены в своей системе, можно записывать каждый новый токен в ZALO_OA_ACCESS_TOKEN через API AnythingMCP.

Что он читает: профиль OA (название, id, верификация, подписчики, пакет услуг) и его квоту сообщений; пользователей, которые подписаны на OA или писали ему, по 50 на страницу, с фильтрами по метке, последнему взаимодействию или статусу подписчика; имя, псевдоним, статус подписчика, дату последнего взаимодействия, метки, заметки и переданную информацию одного пользователя; метки OA; последние сообщения во всех чатах и сообщения с одним пользователем, по 10 за вызов; а также статьи и видео OA с их текстом.

Что он записывает: данные пользователя (псевдоним, ваш собственный id клиента и переданную информацию) и метки: ИИ ставит пользователю метку, создавая её, если её нет, или снимает её. zalo_oa_send_text отправляет консультационный текст, при желании с цитатой сообщения пользователя, а zalo_oa_send_image отправляет консультационное сообщение с одним изображением. Оба доходят до реального человека, поэтому ИИ показывает текст и ждёт вашего «да».

Когда можно отправить консультационное сообщение: только пользователю, который взаимодействовал с OA в последние 7 дней. С 1 января 2026 года консультационные сообщения в течение 48 часов после последнего взаимодействия пользователя бесплатны и не ограничены; более поздние расходуют квоту пакета OA или оплачиваются. zalo_oa_get_user_quota сообщает ИИ, что ещё можно отправить пользователю. Ошибка -230 или -232 означает, что пользователь взаимодействовал слишком давно, а -213 означает, что пользователь не подписан на OA.

Отключено при установке: zalo_oa_delete_tag, который удаляет метку из OA и у всех пользователей, у которых она есть; отменить это нельзя.

Форматы: в каждом ответе есть error (0 = успех) и message, а полезные данные лежат в data; ошибки приходят с HTTP 200 и отрицательным error. Id пользователей, OA и сообщений представляют собой длинные строки из цифр. В сообщении src равен 1, если его отправил пользователь, и 0, если OA. Время сообщений в Unix-миллисекундах, а user_last_interaction_date в формате dd/MM/yyyy.

Лимиты: 4 000 запросов в минуту на приложение плюс лимит на OA, который зависит от пакета OA; ошибка -32 означает, что нужно дождаться следующей минуты. Список пользователей охватывает первые 10 000 пользователей.

Частые ошибки: -216 или -220 означает неверный или истёкший токен (вставьте новый), -223 разрешение, которое OA не выдал приложению, -224 функцию, которая не входит в пакет OA, -201 неверный параметр, а -211 исчерпанную квоту.

Коннектор не отправляет транзакционные, рекламные и шаблонные сообщения ZNS, файлы или стикеры и не охватывает групповые чаты, звонки, создание статей и магазин OA. Webhooks настраиваются в настройках приложения Zalo.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Claude

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Рекомендуемый путь: работает в claude.ai web без редактирования конфигурационных файлов.

1. Открой в Claude Customize → Connectors.
2. Нажми +, затем Add custom connector.
3. Введи название, например Zalo Official Account, и URL удалённого MCP-сервера https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, затем нажми Add.
4. Нажми Connect и войди в AnythingMCP (OAuth), чтобы разрешить доступ.

Все инструменты ниже появятся в чате: начинайте писать промпты.

Доступные инструменты

Примеры запросов

• «Какие пользователи писали OA за последние 24 часа и о чём они спрашивали?»
• «Покажи мою переписку с этим пользователем и подготовь черновик ответа на его последний вопрос.»
• «Поставь метку delivery-question всем, кто на этой неделе спрашивал о доставке.»
• «Сколько квоты консультационных сообщений осталось у OA?»
• «Выведи пять самых просматриваемых статей OA.»

FAQ

Работает ли с Claude Code так же как с Claude Desktop? Да, оба указывайте на https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Следующие шаги

• Страница коннектора
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Gemini
• Подключить к Meta Muse
• Подключить к Microsoft Copilot