Как подключить OneSignal к Gemini через MCP

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

OneSignal + Gemini

Дайте ИИ работать с OneSignal: просматривать отправленные push-, email- и SMS-сообщения с результатами доставки и outcomes, находить сегменты, пользователей и шаблоны, а после вашего подтверждения отправлять или планировать сообщения, отменять их, создавать сегменты и обновлять теги пользователей.

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

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

ONESIGNAL_APP_ID, ONESIGNAL_APP_API_KEY

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

1. В OneSignal откройте приложение, затем Settings → Keys & IDs. Скопируйте App ID (UUID) в ONESIGNAL_APP_ID.
2. На той же странице в разделе App API keys нажмите Add Key, дайте ключу имя и создайте его. Значение начинается с os_v2_app_ и показывается только один раз: сразу вставьте его в ONESIGNAL_APP_API_KEY, без префикса Key.
3. Установите коннектор и запустите onesignal_view_app: он показывает название приложения и число подписок и проверяет, что App ID и ключ относятся к одному приложению. Ключ работает только для этого приложения; для другого приложения установите коннектор ещё раз с его ID и ключом.

Кто что может: ключ действует от имени всего приложения, а не одного человека. Тот, кто пользуется коннектором, видит пользователей приложения и, пока инструменты отправки включены, может отправлять сообщения его аудитории. Делитесь MCP-сервером только с теми, кому это разрешено.

Что он читает: приложение с числом подписок, отправленные push-, email- и SMS-сообщения с числом доставок и статистикой по платформам, outcomes (клики, подтверждённые доставки, сессии и ваши собственные outcomes, хранятся около 30 дней), сегменты, пользователей по алиасу (обычно external_id) с их тегами и подписками, а также шаблоны сообщений. С onesignal_export_message_history OneSignal формирует CSV-файл с теми, кто получил сообщение или кликнул по нему; события отправки есть только у сообщений для 1 000 и более получателей.

Сначала подтверждение: onesignal_send_push, onesignal_send_email и onesignal_send_sms отправляют настоящие сообщения настоящим людям, сразу или в запланированное время. ИИ сначала показывает вам содержимое, аудиторию и время и отправляет только после вашего подтверждения; для сегмента или больше чем одного получателя он ждёт явного «да, отправляй». onesignal_cancel_message останавливает запланированное сообщение, а onesignal_create_segment и onesignal_update_user (теги, язык, часовой пояс, страна) тоже выполняются только после вашего подтверждения. onesignal_delete_user при установке отключён.

Никто не подошёл: отправка возвращает id сообщения. Пустой id означает, что под таргетинг никто не подошёл, а список ошибок объясняет почему, например "All included players are not subscribed".

Частые ошибки: 401 "Access denied": ключ неверный, удалён или заменён, либо относится не к тому приложению, что App ID. 400 "Failed to parse app_id": App ID не является корректным UUID; скопируйте его заново из Keys & IDs. 400 при отправке: содержимое или таргетинг недействительны, например нет текста на английском или сегменты совмещены с алиасами. 403: ключ ограничен списком разрешённых IP, или ваш план не включает эту функцию. 429: достигнут лимит запросов OneSignal; подождите и повторите.

Коннектор не охватывает задачи уровня организации (все приложения, создание приложений, управление ключами API, журналы аудита), управление подписками и алиасами, Live Activities, сообщения во входящих, journeys и CSV-выгрузки всех подписок и пользовательских событий.

Шаг 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 — Добавьте коннектор в Gemini

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

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты OneSignal.

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

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

• «Какие push-уведомления мы отправили на прошлой неделе, сколько из них доставлено и по скольким кликнули?»
• «Покажи клики и подтверждённые доставки по всему приложению за последний день с разбивкой по платформам.»
• «Найди пользователя с external_id 4821 и покажи его теги и подписки.»
• «Запланируй push для сегмента Subscribed Users на пятницу в 9:00 с заголовком Распродажа выходных и покажи текст, аудиторию и время перед отправкой.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

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

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT