Подключение к серверу

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

Обзор

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

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

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

Возможности

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

Ограничения

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

Требования

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

Запуск сервера

1. На экране сервера нажмите Запустить сервер
2. Дождитесь статуса «Работает»
3. Запишите IP-адрес и порт, показанные на экране
4. Сервер принимает подключения

IP и порт

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

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

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

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

Подключение

IP-адрес

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

Пример: 192.168.1.100:9000

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

Протокол MCP

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

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

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

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

Просмотр

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

Советы

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

Для более глубокой диагностики можно также экспортировать журналы событий приложения из раздела «Дополнительно/отладка». См. Руководство по журналам событий приложения.