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

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

Последнее обновление: 31 октября 2026 г.

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

Обзор Предварительные требования Запуск сервера Аутентификация (HTTP)

HTTPS (TLS)

HTTPS (TLS) Включение HTTPS Доверие к CA на клиентах Изменения LAN IP iOS Пример конечной точки HTTPS

Конфигурация клиента

Конфигурация клиента Claude Code (CLI)Claude Code / файл проекта (<code>.mcp.json</code>)Cursor (<code>~/.cursor/mcp.json</code>)VS Code (<code>.vscode/mcp.json</code>)Codex CLI (<code>~/.codex/config.toml</code>)mcp-remote (iOS / LAN)

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

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

TCP Советы Получение помощи

Сервер 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-токен с экрана Сервер
Разрешение Local Network на iPhone
Клиентское устройство: тот же Wi‑Fi или LAN, что и iPhone; Node.js только если используете mcp-remote (iOS / LAN)

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

На iPhone откройте Сервер с вкладки Экспорт. На iPad используйте боковую панель.
Выберите HTTP (рекомендуется) или TCP
Необязательно включите Использовать HTTPS (инструкции ниже)
Нажмите Запустить сервер
Скопируйте URL конечной точки и bearer-токен

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

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

Все HTTP-запросы требуют:

Authorization: Bearer <your-token>

При необходимости перегенерируйте токен с экрана Сервер
На обычном HTTP токен отправляется по незашифрованному соединению — используйте только в доверенных сетях или включите HTTPS
У TCP legacy нет аутентификации (без изменений)

HTTPS (TLS)

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

Включение HTTPS

Откройте вид Сервер (iPhone: вкладка Экспорт; iPad: боковая панель)
Включите Использовать HTTPS
Нажмите Экспортировать сертификат CA и используйте лист обмена, чтобы отправить через AirDrop или сохранить файл CA на каждом клиентском устройстве
Запустите сервер — убедитесь, что URL конечной точки переключается на https://

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

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

Экспортируйте CA с экрана Сервер на iPhone
Откройте PEM в Keychain Access на клиентском Mac
Задайте Trust → Always Trust

Версии 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+	any

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

Область доверия: --use-system-ca доверяет полной системной Keychain, а не только CA этого приложения. NODE_EXTRA_CA_CERTS добавляет экспортированный CA к доверенным сертификатам Node. См. параметры сертификатов Node.

Тип клиента	Настройка
Cursor, VS Code, Claude Code, Codex	Доверие Keychain на клиентском Mac — используйте конечную точку `https://` с экрана Сервер
mcp-remote (iOS / LAN)	Доверьте CA в Keychain на 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	Legacy (`health_metrics`, …)	Обновление совместимости Claude Desktop v1.0.0
v0.0.1	Legacy	Самая старая совместимость

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

Конфигурация клиента

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

Все примеры ниже используют placeholder LAN-адрес — подставьте адрес iPhone с экрана Сервер.

Claude Code (CLI)

Запустите на Mac (требуется Claude Code CLI):

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 — bridge 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, где работает клиент.

Запустите сервер на iPhone и скопируйте конечную точку и токен
На 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 включён:

Экспортируйте CA с iPhone и доверьте его в Keychain Access (Always Trust) на Mac
Используйте https://192.168.1.42:9000/mcp в args
Для версий 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 для legacy-имён инструментов
Используйте контракт v1.1.0 для имён инструментов TCP get_* (обновите Node bridge отдельно)

Советы

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

Получение помощи

См. Получение помощи для отправки запросов в поддержку и Журналы событий приложения для диагностических экспортов.

Обзор

Предварительные требования

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

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

HTTPS (TLS)

Включение HTTPS

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

Версии Node для сгенерированной настройки

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

Пример конечной точки HTTPS

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

Конфигурация клиента

Claude Code (CLI)

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

Cursor (~/.cursor/mcp.json)

VS Code (.vscode/mcp.json)

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

mcp-remote (iOS / LAN)

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

Форматы дат

TCP

Советы

Получение помощи

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

Cursor (`~/.cursor/mcp.json`)

VS Code (`.vscode/mcp.json`)

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