# Cursor push-уведомления: сигнал на телефон, когда агент закончил

> Получайте push-уведомление на телефон, когда агент Cursor завершит работу, упадёт с ошибкой или захочет что-то сообщить. Stop-хук для каждого запуска и MCP-сервер Pocket Alert для сообщений, которые агент пишет сам.

*12.10.2026*

<!-- source: https://pocketalert.app/ru/blog/cursor-push-notifications -->

Агент Cursor может отрефакторить модуль, пока вы варите кофе, но при обычном локальном запуске Cursor сообщает о завершении только на компьютере: звуком или системным уведомлением, если вы их включили. Приложение Cursor для iOS отправляет push, когда агент заканчивает ход, но только для облачных агентов и сессий, которые вы передаёте через Remote Control, при платном тарифе и на iPhone. Для Android поддержка пока не запланирована.

Если вы хотите получать push-уведомление на телефон, когда локальный запуск агента завершился, Cursor предлагает два способа его отправить:

- **Хук `stop`.** Cursor запускает ваш скрипт каждый раз, когда цикл агента завершается: успешно, прерванно или с ошибкой. Надёжно и всегда одинаково.
- **Инструмент MCP.** Добавьте MCP-сервер Pocket Alert, и агент сможет отправить вам push, когда вы его попросите, с сообщением, которое он сам напишет.

Это руководство настраивает оба способа. Каждый займёт несколько минут.

## Что понадобится

- Cursor 1.7 или новее: хуки появились в версии 1.7.
- `jq` и `curl` для хука.
- Аккаунт Pocket Alert, API-ключ из раздела [API Keys](/account/apikeys) и [приложение](/get-app) на телефоне. Бесплатного тарифа достаточно.

Cursor, запущенный из Dock, не читает ваш `.zshrc`, поэтому переменные окружения, которые вы экспортируете там, он не видит. Храните ключ в файле:

```bash
mkdir -p ~/.config/pocketalert
printf '%s' 'YOUR_API_KEY' > ~/.config/pocketalert/key
chmod 600 ~/.config/pocketalert/key
```

## Вариант 1. Хук stop для каждого запуска

### Скрипт

Cursor передаёт хуку JSON-объект через stdin. Для `stop` в нём есть `status` (`completed`, `aborted` или `error`) и `workspace_roots`, то есть папки, открытые в окне. Сохраните скрипт как `~/.cursor/hooks/pocketalert.sh`:

```bash
#!/usr/bin/env bash
payload=$(cat)
project=$(basename "$(jq -r '.workspace_roots[0] // "cursor"' <<<"$payload")")
status=$(jq -r '.status // "completed"' <<<"$payload")

case "$status" in
  completed) title="Cursor finished · $project"; level=default ;;
  error)     title="Cursor hit an error · $project"; level=high ;;
  *)         echo '{}'; exit 0 ;;
esac

jq -n --arg t "$title" --arg m "Agent run $status" --arg l "$level" \
  '{title: $t, message: $m, level: $l}' |
  curl -sS --max-time 5 https://api.pocketalert.app/v1/messages \
    -H "Token: $(cat ~/.config/pocketalert/key)" \
    -H 'Content-Type: application/json' \
    --data-binary @- >/dev/null 2>&1 || true

echo '{}'
```

```bash
chmod +x ~/.cursor/hooks/pocketalert.sh
```

Прерванные запуски намеренно пропускаются: если вы нажали «стоп», вы и так это знаете. Скрипт выводит `{}`, потому что хук `stop` может вернуть `followup_message`, который Cursor отправляет агенту как ваш следующий промпт. Пустой объект означает «ничего не добавлять».

### Или через Pocket Alert CLI

Если установлен [Pocket Alert CLI](/tools/cli) версии 2.0 или новее, блок с curl сводится к одной команде. CLI сам экранирует текст и берёт ключ из `pocketalert auth`:

```bash
pocketalert send -t "$title" -m "Agent run $status" -l "$level" -q >/dev/null 2>&1 || true
```

Используйте `-t` и `-m`, а не позиционные аргументы: ответ, который начинается с дефиса, например с Markdown-списка, иначе будет прочитан как опция.

### Регистрация

Создайте `~/.cursor/hooks.json`:

```json
{
  "version": 1,
  "hooks": {
    "stop": [
      { "command": "/Users/you/.cursor/hooks/pocketalert.sh", "timeout": 10 }
    ]
  }
}
```

Укажите абсолютный путь к скрипту и замените `/Users/you` на свою домашнюю папку. Файл в домашней папке действует для всех проектов. Если нужен только один проект, положите его в `.cursor/hooks.json` внутри репозитория.

Cursor сам перечитывает `hooks.json` при изменении файла. Дайте агенту небольшую задачу, и по завершении на телефоне появится **Cursor finished · your-project**.

### Хотите в push ответ агента?

`stop` не передаёт ответ агента, а `afterAgentResponse` передаёт его в поле `text`. Чтобы отправлять в push первые строки ответа, а не только статус, зарегистрируйте такой же скрипт на `afterAgentResponse` и читайте `.text` из stdin. Он срабатывает после каждого ответа, поэтому шумнее, и большинство людей оставляют `stop`.

## Вариант 2. MCP-сервер

Хук сообщает, что запуск завершился. MCP-сервер позволяет агенту рассказать, что произошло. Добавьте Pocket Alert в `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "pocketalert": {
      "url": "https://mcp.pocketalert.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
```

Ключ записывается прямо в файл из-за проблемы с Dock, описанной выше. Этот файл лежит в домашней папке, а не в репозитории. Если вы запускаете Cursor из терминала, где ключ экспортирован, вместо него работает `"Bearer ${env:POCKETALERT_API_KEY}"`.

Откройте раздел MCP в настройках Cursor, убедитесь, что у `pocketalert` видны инструменты, и попросите:

```text
> Run the test suite. When it's done, push me the number of failures with Pocket Alert.
```

Агент вызывает `create_message` с написанным им самим кратким описанием. Он также может задать `level`, поэтому упавший набор тестов придёт с `high`, а на платном тарифе можно прикрепить кнопки действий.

Чтобы это стало привычкой, а не инструкцией в каждом промпте, добавьте правило для проекта:

```text
When a task takes more than a few minutes, finish by calling the pocketalert
create_message tool with a one-line summary. Use level "high" if anything failed.
```

## Что выбрать

<div class="cmp-table-wrap">
<table class="cmp-table">
<thead><tr><th></th><th>Хук stop</th><th>Инструмент MCP</th></tr></thead>
<tbody>
<tr><th>Срабатывает</th><td>Каждый запуск, всегда</td><td>Когда агент решит</td></tr>
<tr><th>Сообщение</th><td>Статус: completed или error</td><td>Всё, что напишет агент</td></tr>
<tr><th>Нужно</th><td>Скрипт и <code>hooks.json</code></td><td>Один блок в <code>mcp.json</code></td></tr>
<tr><th>Может молча не сработать</th><td>Только если нет сети</td><td>Если модель забудет</td></tr>
</tbody>
</table>
</div>

Лучший вариант по умолчанию — использовать оба: хук гарантирует, что вы узнаете о каждом запуске, а инструмент MCP даёт содержание там, где оно важно.

## Подтверждения

У Cursor нет хука для ситуации «агент ждёт подтверждения». `beforeShellExecution` и `preToolUse` срабатывают перед каждой командой, включая те, которые Cursor выполняет без запроса, поэтому они не могут сообщить, когда вы действительно нужны. Этот случай сейчас покрывают системные уведомления настольной версии Cursor и его приложение для iOS.

Если вы хотите, чтобы агент остановился и спросил перед рискованным шагом, дайте ему инструмент MCP и правило отправлять push с кнопками «Подтвердить» и «Отклонить». [Уведомления с участием человека](/blog/human-in-the-loop-notifications) показывают, как сделать из этого настоящий барьер, а не вежливую просьбу.

## Если ничего не приходит

- **Запустите скрипт вручную:** `echo '{"status":"completed","workspace_roots":["/tmp/demo"]}' | ~/.cursor/hooks/pocketalert.sh`. Если push не пришёл, уберите `>/dev/null 2>&1`, чтобы увидеть ошибку curl.
- **Перезапустите Cursor**, если хук всё равно не срабатывает. Обычно Cursor сам перечитывает `hooks.json` при изменении файла.
- **Проверьте путь** в `hooks.json`: он должен быть абсолютным, а скрипт — исполняемым.
- **Для MCP проверьте список инструментов.** Ошибка рядом с сервером в настройках MCP Cursor обычно значит, что ключ неверный или пустой.

## FAQ

### Есть ли в Cursor push-уведомления из коробки?

На компьютере есть: звук завершения и системные уведомления. На телефоне приложение Cursor для iOS отправляет push, когда облачный агент или сессия, переданная через Remote Control, завершает ход. Нужен платный тариф и iPhone. Обычные локальные запуски остаются на компьютере, и именно их покрывает эта настройка.

### Будет ли это работать для фоновых и облачных агентов?

Хук в `~/.cursor/hooks.json` работает только на вашей машине, поэтому он охватывает агентов, запущенных локально. Облачные агенты работают на серверах Cursor: они выполняют проектные хуки из `.cursor/hooks.json` репозитория, но не пользовательские, и файла с ключом там нет. Для них подойдёт MCP, если сервер настроен у агента, или интеграция приложения Cursor для iOS или Slack.

### Видит ли агент мой API-ключ?

В настройке с хуком — нет: ключ хранится в файле, который читает только скрипт. В настройке с MCP ключ лежит в конфигурации Cursor и отправляется MCP-серверу, а не модели.

### Это бесплатно?

Да. Хуки и MCP входят в Cursor, а бесплатный тариф Pocket Alert покрывает 50 сообщений в день на одном устройстве.

[Получите API-ключ](/signup), добавьте хук и пусть Cursor сообщит, когда работа завершена.
