Руководство по подключению к серверу

Сервер TCP/MCP позволяет запрашивать данные о здоровье с других устройств в локальной сети — для приложений, скриптов и интеграций по протоколу MCP.

Обзор

На устройстве поднимается сервер в LAN: можно запрашивать данные, запускать автоматизации и управлять приложением программно.

Примеры использования

• запросы с ПК и других устройств в сети;
• локальные приложения и скрипты;
• командная строка;
• интеграции по MCP.

Возможности

• TCP для устойчивых соединений;
• MCP;
• только локальная сеть;
• запросы к данным;
• программное управление автоматизациями.

Ограничения

• приложение должно быть на переднем плане;
• трафик не шифруется — только доверенные сети;
• нужно разрешение «Локальная сеть»;
• подключения только пока сервер запущен.

Требования

• Health Auto Export на iPhone или iPad;
• клиенты в той же LAN;
• разрешение «Локальная сеть»;
• подписка Premium;
• доверенная сеть.

IP и порт

• на экране отображается IP устройства;
• порт по умолчанию 9000.

Версия сервера

• v0.0.1: устаревший режим совместимости (рекомендуется для существующих установок).
• v1.0.0: обновлённое поведение в соответствии с актуальным контрактом MCP-сервера.

Выбранная версия влияет на значения по умолчанию инструментов и совместимость ответов. После смены версии перезапустите сервер, чтобы изменение вступило в силу.

Подключение

IP-адрес

Адрес показывается автоматически — его используют другие устройства.

Пример: 192.168.1.100:9000

Использование

Протокол MCP

Связь по Model Context Protocol (MCP).

Журнал подключений

На экране сервера отображаются:

• попытки подключения;
• детали запросов;
• ответы;
• ошибки.

Просмотр

• записи появляются в списке на экране сервера;
• прокрутите для недавней активности;
• журнал помогает отладке.

Советы

1. Автоматическая синхронизация:

   • Заряжайте устройство и используйте Зеркалирование iPhone
     • При зарядке iOS накладывает меньше ограничений на производительность, поэтому данные могут синхронизироваться чаще
     • При зеркалировании iPhone устройство ведёт себя как разблокированное. Health Auto Export может получать доступ к данным о здоровье для автоматических действий

2. Фон (при использовании автоматизаций):

   • зарядка и iPhone Mirroring;
     • при зарядке iOS меньше ограничивает работу, синхронизация может идти чаще;
     • при зеркалировании устройство ведёт себя как разблокированное, данные «Здоровья» доступны для автоматизаций.

Для углублённой диагностики экспортируйте полные журналы событий приложения из Настройки → Дополнительно → Экспорт журналов событий или через Журналы активности → Поделиться в любой автоматизации (тот же ZIP). См. Руководство по журналам событий приложения.