Собственное реле

Собственное relay нужно, когда вы хотите сами управлять транспортным сервером, его доступностью, обновлениями и хранением. Оно передаёт зашифрованные пакеты между подключёнными устройствами. Оно не заменяет MCP helper на компьютере, не запускает вместо него coding provider и не превращает недоступный Mac в работающего агента.

Managed, Direct и собственное relay#

Direct не означает прямую радиосвязь телефона с laptop и не создаёт NAT forwarding. В Direct directory получает запечатанную запись маршрута, а не становится proxy всего чата. В полностью self-hosted режиме публикация адреса в managed directory не выполняется.

Проверенные условия доступа зависят от выбранного режима и Apple entitlement. Не воспринимайте эту главу как объявление текущей цены или доступности покупки. Подходящие условия показывает текущий экран лицензии/StoreKit; ссылки на Terms и Privacy доступны в разделе безопасности.

Что приготовить#

Нужны установленный GrantTap MCP, работающий компьютер, поддерживаемый Node, подходящий relay и адрес, достижимый с телефона. Для обычного внешнего маршрута нужен защищённый TLS endpoint; альтернативой может быть корректно настроенный VPN. Важно, чтобы адрес работал из той сети, где будет телефон, а не только с самого Mac.

localhost на iPhone означает сам iPhone. Домашний частный IP без VPN или другой явной сетевой настройки обычно не становится доступным из мобильной сети. Публикация такого адреса не исправляет маршрутизацию. Не помещайте relay secrets, pairing payload или credentials в скриншоты инструкции.

Настройка через Mac#

В существующем Mac-интерфейсе маршрут находится в Devices → Device network. Названия могут частично оставаться английскими.

1. Проверьте, что локальный MCP доступен и авторизован приложению Mac.
2. Выберите нужный режим сети осознанно: Direct и Fully self-hosted различаются.
3. При локальном размещении используйте имеющиеся действия Install, Start и Stop для отдельного relay.
4. Укажите свой достижимый TLS endpoint либо подготовленный VPN-маршрут.
5. Подключите iPhone/iPad штатным одноразовым QR и проверьте конкретный компьютер в Devices.
6. На учебной Task проверьте получение компьютером, затем ответ. Зелёного Live недостаточно.

Эти действия управляют отдельным процессом. Apple app не встраивает в свой sandbox второй runtime. Все компьютеры одной комнаты используют согласованный relay endpoint. Локальный relay после перезагрузки требуется запустить снова: этот интерфейс не устанавливает автоматически общесистемный relay daemon.

Для сервера вне Mac используйте официальный репозиторий GrantTap relay и его инструкции для выбранного релиза. Не переносите наугад Docker-команды из старого сообщения или инструкции другого сервиса. Описание действующего режима также есть в документации Apple-клиента.

Push, фон и ответственность#

Пользовательский URL не настраивает APNs автоматически. Для push собственного relay отдельно требуются необходимые Apple server credentials, рабочий push service и разрешения iPhone. Без них foreground connection и доступная история могут работать, а ожидаемое пробуждение приложения — отсутствовать. iOS самостоятельно определяет фоновое время.

Владелец сервера отвечает за TLS, доступность, обновления, мониторинг и резервные копии серверного состояния. Шифрование не отменяет важность credentials и метаданных маршрутизации. Не делайте публичным административный интерфейс только ради проверки с телефона.

Если соединение не появляется#

Проверьте адрес из нужной сети, сертификат, работу relay, endpoint в комнате и запущенный helper. Затем разделите состояние соединения и доставку исходного сообщения. Если реле сохранило запрос, а компьютер не подтвердил приём, смена подписи в UI не решит проблему самого компьютера.

Для теста используйте учебный проект. Не пересылайте старый production prompt, пока не выяснен его статус. Сохранённые сообщения, read cache и резервная копия кода — разные вещи; подробности в офлайн-хранении.