HealthyApps Help Center

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

Подключитесь к серверу MCP Health Auto Export для AI-клиентов и скриптов в вашей локальной сети.

Last updated: July 14, 2026

На этой странице

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

Сервер MCP на iOS позволяет AI-клиентам и скриптам в вашей локальной сети запрашивать данные о здоровье. HTTP (Streamable MCP) — рекомендуемый транспорт. iOS также поддерживает TCP для настроек с Node-мостом.

Клиенты работают на вашем Mac или других устройствах в той же сети и подключаются к точке доступа, показанной на iPhone.

Обзор

Транспорт Точка доступа
HTTP (рекомендуется) http://{LAN_IP}:9000/mcp (или https://, если включён HTTPS)
TCP {LAN_IP}:9000 (без аутентификации)

Замените {LAN_IP} на адрес, показанный на экране Server, пока сервер запущен.

Варианты использования:

  • Подключите Claude Code, Codex, Cursor или VS Code на вашем Mac к данным о здоровье на iPhone
  • Используйте mcp-remote (iOS / LAN) для клиентов, работающих только через stdio, например Claude Desktop
  • Запрашивайте показатели и тренировки из скриптов в локальной сети (HTTP)
  • Интеграции по TCP через Node-мост health-auto-export-mcp-server

Требования

  • Health Auto Export на iPhone (приложение должно оставаться на переднем плане, пока клиенты подключены)
  • Подписка Premium
  • HTTP: Bearer-токен с экрана Server
  • Разрешение «Локальная сеть» на iPhone
  • Клиентское устройство: та же Wi-Fi или локальная сеть, что и у iPhone; Node.js нужен только при использовании mcp-remote (iOS / LAN)

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

  1. На iPhone откройте раздел Server через боковую навигацию
  2. Выберите HTTP (рекомендуется) или TCP
  3. При необходимости включите Use HTTPS (инструкции ниже)
  4. Нажмите Start Server
  5. Скопируйте URL точки доступа и bearer-токен

Сервер автоматически останавливается, если Health Auto Export переходит в фон (и для HTTP, и для TCP).

Аутентификация (HTTP)

Все HTTP-запросы должны содержать:

Authorization: Bearer <your-token>
  • При необходимости перегенерируйте токен на экране Server
  • По обычному HTTP токен передаётся по незашифрованному соединению — используйте только в доверенных сетях или включите HTTPS
  • Устаревший TCP работает без аутентификации (без изменений)

HTTPS (TLS)

Когда включён Use HTTPS, приложение генерирует приватный локальный удостоверяющий центр (CA) и серверный сертификат, подписанный этим CA. Клиенты должны доверять экспортированному CA, прежде чем подключаться по https://.

Включение HTTPS

  1. Откройте раздел Server через боковую навигацию
  2. Включите Use HTTPS
  3. Нажмите Export CA Certificate и с помощью меню «Поделиться» отправьте файл CA по AirDrop или сохраните его на каждом клиентском устройстве
  4. Запустите сервер — убедитесь, что URL точки доступа переключился на https://

Доверие к CA на клиентах

Установите доверие к экспортированному CA на устройстве, на котором работает AI-клиент (обычно это ваш Mac):

  1. Экспортируйте CA с экрана Server на iPhone
  2. Откройте PEM-файл в Keychain Access на клиентском Mac
  3. Установите Trust → Always Trust

Минимальная версия Node для --use-system-ca

Node-мосты (mcp-remote) могут использовать NODE_OPTIONS=--use-system-ca только если версия Node соответствует требованиям:

Линейка Node Минимальная версия
22.x 22.19.0
23.x 23.8.0
24.x 24.6.0
25+ любая

На более старых версиях Node вместо этого укажите путь к PEM-файлу в переменной NODE_EXTRA_CA_CERTS, доступный процессу моста. Использование --use-system-ca на неподдерживаемой версии Node не даёт процессу запуститься.

Область доверия: --use-system-ca доверяет всей системной связке ключей (Keychain), а не только CA этого приложения. NODE_EXTRA_CA_CERTS ограничивает доверие одним PEM-файлом (запасной вариант для старых версий Node). Флаг документирован для macOS/Windows.

Тип клиента Настройка
Cursor, VS Code, Claude Code, Codex Доверие через Keychain на клиентском Mac — используйте точку доступа https:// с экрана Server
mcp-remote (iOS / LAN) Доверьте CA в Keychain на Mac, на котором запущен mcp-remote. Сниппет использует NODE_OPTIONS=--use-system-ca, если версия Node соответствует минимальным требованиям; на более старых версиях Node укажите доступный PEM-путь в NODE_EXTRA_CA_CERTS
curl / скрипты Передайте --cacert /path/to/mcp-ca.pem или задайте NODE_EXTRA_CA_CERTS

Отпечаток CA отображается на экране Server, чтобы вы могли убедиться, что экспортировали правильный сертификат.

Изменение LAN IP на iOS

Когда LAN IP вашего iPhone меняется, приложение перегенерирует серверный сертификат с обновлёнными Subject Alternative Names и перезапускает HTTPS-слушатель. Скопируйте URL точки доступа заново, если IP изменился. CA-сертификат остаётся тем же, если вы не перегенерируете его, отключив и снова включив HTTPS.

Пример HTTPS-точки доступа

https://192.168.1.42:9000/mcp

Замените хост на значение, показанное на экране Server.

Версия контракта

Версия Имена TCP-инструментов Примечания
v1.1.0 (по умолчанию) get_* Рекомендуется для новых настроек
v1.0.0 Устаревшие (health_metrics, …) Обновление совместимости с Claude Desktop v1.0.0
v0.0.1 Устаревшие Самая старая версия совместимости

HTTP всегда использует имена инструментов get_*; версия контракта влияет только на схемы по умолчанию.

Настройка клиентов

На экране Server есть сниппеты для копирования под каждую интеграцию. Используйте показанные там точку доступа и токен. Проверяйте формат в соответствии с версией вашего клиента.

Во всех примерах ниже используется placeholder-адрес в локальной сети — замените его адресом вашего iPhone с экрана Server.

Claude Code (CLI)

Выполните на вашем Mac (требуется CLI Claude Code):

HTTP:

claude mcp add --transport http health-auto-export \
  http://192.168.1.42:9000/mcp \
  --header "Authorization: Bearer <token>"

HTTPS (после экспорта и установки доверия к CA на вашем Mac):

claude mcp add --transport http health-auto-export \
  https://192.168.1.42:9000/mcp \
  --header "Authorization: Bearer <token>"

Claude Code / файл проекта (.mcp.json)

{
  "mcpServers": {
    "health-auto-export": {
      "type": "http",
      "url": "http://192.168.1.42:9000/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "health-auto-export": {
      "url": "http://192.168.1.42:9000/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "health-auto-export": {
      "type": "http",
      "url": "http://192.168.1.42:9000/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

Codex CLI (~/.codex/config.toml)

Codex подключается по Streamable HTTP напрямую — без моста на Node.js. Конфигурация находится в ~/.codex/config.toml (глобально) или в .codex/config.toml в доверенном каталоге проекта.

CLI (рекомендуется):

export HAE_MCP_TOKEN="<token>"
codex mcp add health-auto-export \
  --url http://192.168.1.42:9000/mcp \
  --bearer-token-env-var HAE_MCP_TOKEN

Ручная настройка config.toml:

[mcp_servers.health-auto-export]
url = "http://192.168.1.42:9000/mcp"
bearer_token_env_var = "HAE_MCP_TOKEN"
enabled = true

Задайте переменную HAE_MCP_TOKEN со значением вашего bearer-токена перед запуском Codex. После настройки выполните /mcp в сессии Codex, чтобы убедиться, что сервер подключён.

Если вы перегенерируете bearer-токен в Health Auto Export, обновите HAE_MCP_TOKEN и повторно выполните codex mcp add, либо удалите и заново добавьте запись сервера.

mcp-remote (iOS / LAN)

Для клиентов, работающих только через stdio (например, Claude Desktop), которые не могут подключаться по HTTP напрямую. Требуется Node.js на Mac, на котором работает клиент.

  1. Запустите сервер на iPhone и скопируйте точку доступа и токен
  2. На вашем Mac выберите mcp-remote (iOS / LAN) на экране Server и скопируйте JSON-сниппет, либо вставьте его в конфигурацию MCP клиента (Claude Desktop → Settings → Developer → Edit Config):
{
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote@0.1.16",
    "http://192.168.1.42:9000/mcp",
    "--transport",
    "http-only",
    "--header",
    "Authorization: Bearer <token>"
  ]
}

Когда включён HTTPS:

  1. Экспортируйте CA с iPhone и установите доверие к нему в Keychain Access (Always Trust) на вашем Mac
  2. Используйте https://192.168.1.42:9000/mcp в args
  3. Если версия Node соответствует минимальным требованиям для --use-system-ca (22.19.0 на 22.x, 23.8.0 на 23.x, 24.6.0 на 24.x или любой релиз 25+), добавьте:
"env": {
  "NODE_OPTIONS": "--use-system-ca"
}

На более старых версиях Node вместо этого укажите доступный PEM-путь в NODE_EXTRA_CA_CERTS. После обновления конфигурации перезапустите stdio-клиент.

Снижение задержки запуска: npx -y загружает mcp-remote при первом использовании и перепроверяет его после истечения кэша, что может вызывать задержки в несколько секунд. Глобальная предустановка устраняет это:

npm install -g mcp-remote@0.1.16

Аргументы инструментов

Форматы даты

Параметры start и end принимают два формата:

Формат Пример Примечания
yyyy-MM-dd 2026-06-13 Начальная дата: полночь; конечная дата: 23:59:59
yyyy-MM-dd HH:mm:ss Z 2026-06-13 00:00:00 +0000 Явное время и смещение часового пояса

TCP

  • Незашифрованный JSON-RPC без аутентификации на порту 9000
  • Используйте контракт v1.0.0 с Node-мостом health-auto-export-mcp-server для устаревших имён инструментов
  • Используйте контракт v1.1.0 для имён TCP-инструментов get_* (обновите Node-мост отдельно)

Советы

  1. Держите Health Auto Export на переднем плане на iPhone, пока клиенты подключены
  2. Перегенерируйте токен, если подозреваете, что он был скомпрометирован
  3. Скопируйте URL точки доступа заново после изменения LAN IP вашего iPhone

Поддержка в чате

Собирайте диагностику из журналов событий приложения: Settings → Advanced → Export Event Logs. См. Руководство по журналам событий приложения. Поделитесь созданным zip-файлом через чат поддержки или по email.