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 є сніппети для копіювання під кожну інтеграцію. Використовуйте показані там точку доступу та токен. Перевіряйте формати відповідно до версії вашого клієнта.

У всіх прикладах нижче використовується адреса-заповнювач у локальній мережі — замініть її адресою вашого 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-файлом через чат підтримки або електронною поштою.