Підключення до сервера

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

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

Огляд

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

Замініть {LAN_IP} на адресу, показану на екрані Сервер, поки сервер працює.

Варіанти використання:

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

Передумови

• Health Auto Export на iPhone (застосунок має залишатися на передньому плані, поки клієнти підключені)
• Підписка Premium
• HTTP: Bearer-маркер з екрана Сервер
• Дозвіл Локальна мережа на iPhone
• Клієнтський пристрій: той самий Wi‑Fi або LAN, що й iPhone; Node.js лише якщо використовуєте mcp-remote (iOS / LAN)

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

1. На iPhone відкрийте Сервер на вкладці Експорт. На iPad використовуйте бічну панель.
2. Виберіть HTTP (рекомендовано) або TCP
3. За бажанням увімкніть Використовувати HTTPS (інструкції нижче)
4. Торкніться Запустити сервер
5. Скопіюйте URL кінцевої точки та bearer-маркер

Активний сервер зупиняється автоматично, якщо Health Auto Export переходить у фон, незалежно від того, чи використовуєте HTTP або TCP.

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

Усі HTTP-запити потребують:

Authorization: Bearer <your-token>

• За потреби повторно згенеруйте маркер на екрані Сервер
• На звичайному HTTP маркер надсилається незашифрованим з’єднанням — використовуйте лише в довірених мережах або увімкніть HTTPS
• Застарілий TCP не має автентифікації (без змін)

HTTPS (TLS)

HTTPS використовує локально згенерований Certificate Authority (CA). Експортуйте та довірте його сертифікат на кожному клієнтському пристрої перед підключенням через https://.

Увімкнення HTTPS

1. Відкрийте подання Сервер (iPhone: вкладка Експорт; iPad: бічна панель)
2. Увімкніть Використовувати HTTPS
3. Торкніться Експортувати сертифікат CA і використайте аркуш спільного доступу, щоб надіслати через AirDrop або зберегти файл CA на кожному клієнтському пристрої
4. Запустіть сервер — переконайтеся, що URL кінцевої точки перемикається на https://

Довіра до CA на клієнтах

Довірте експортований CA на пристрої, де працює AI-клієнт (зазвичай ваш Mac):

1. Експортуйте CA з екрана Сервер на iPhone
2. Відкрийте PEM у Связці ключів на клієнтському Mac
3. Встановіть Довіра → Завжди довіряти

Версії Node для згенерованого налаштування

Згенероване застосунком налаштування Node-bridge використовує NODE_OPTIONS=--use-system-ca для цих версій Node:

Лінія Node	Мінімальна версія
22.x	22.19.0
23.x	23.8.0
24.x	24.6.0
25+	будь-яка

На старішому Node встановіть NODE_EXTRA_CA_CERTS на шлях PEM, який процес bridge може читати. Вивід --use-system-ca на непідтримуваному Node перешкоджає запуску процесу.

Обсяг довіри: --use-system-ca довіряє всій системній Связці ключів, не лише CA цього застосунку. NODE_EXTRA_CA_CERTS додає експортований CA до довірених сертифікатів Node. Див. параметри сертифікатів Node.

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

Відбиток CA показано на екрані Сервер, щоб ви могли перевірити, що експортували правильний сертифікат.

Зміни LAN IP на iOS

Повторно скопіюйте URL кінцевої точки, якщо мережева адреса iPhone змінюється. Якщо надано замінений сертифікат CA, експортуйте його та оновіть довіру на кожному клієнтському пристрої.

Приклад кінцевої точки HTTPS

https://192.168.1.42:9000/mcp

Замініть хост значенням, показаним на екрані Сервер.

Версія контракту

Версія	Імена інструментів TCP	Примітки
v1.1.0 (за замовчуванням)	get_*	Рекомендовано для нових налаштувань
v1.0.0	Застарілі (health_metrics, …)	Оновлення сумісності Claude Desktop v1.0.0
v0.0.1	Застарілі	Найстаріша сумісність

HTTP завжди використовує імена інструментів get_*; версія контракту впливає лише на значення схеми за замовчуванням.

Конфігурація клієнта

Екран Сервер містить фрагменти для копіювання для кожної інтеграції. Використовуйте кінцеву точку та маркер, показані там. Перевіряйте формати відносно версії клієнта.

Усі приклади нижче використовують заповнювач LAN-адреси — підставте адресу iPhone з екрана Сервер.

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-bridge не потрібен. Конфігурація зберігається в ~/.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) на екрані Сервер і скопіюйте 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 та довірте його в Связці ключів (Завжди довіряти) на Mac
2. Використовуйте https://192.168.1.42:9000/mcp у args
3. Для версій Node, підтримуваних згенерованим налаштуванням вище, додайте цей об’єкт env до того самого об’єкта конфігурації сервера:

{
  "env": {
    "NODE_OPTIONS": "--use-system-ca"
  }
}

На старішому Node встановіть NODE_EXTRA_CA_CERTS на читабельний шлях PEM. Перезапустіть stdio-клієнт після оновлення конфігурації.

Аргументи інструментів

Формати дат

Параметри 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-bridge health-auto-export-mcp-server для застарілих імен інструментів
• Використовуйте контракт v1.1.0 для імен інструментів TCP get_* (оновіть Node-bridge окремо)

Поради

1. Тримайте Health Auto Export на передньому плані на iPhone, поки клієнти підключені
2. Повторно згенеруйте маркер, якщо підозрюєте, що його розкрито
3. Повторно скопіюйте URL кінцевої точки після зміни LAN IP iPhone

Отримання допомоги

Див. Отримання допомоги для подання звернень до підтримки та Журнали подій застосунку для діагностичних експортів.