서버에 연결
로컬 네트워크의 AI 클라이언트와 스크립트를 위해 Health Auto Export MCP 서버에 연결합니다.
최근 업데이트: 2026년 10월 31일
이 페이지에서
iOS의 MCP 서버를 통해 로컬 네트워크의 AI 클라이언트와 스크립트가 건강 데이터를 조회할 수 있습니다. HTTP(Streamable MCP)가 권장 전송입니다. iOS는 Node 브리지용으로 TCP도 지원합니다.
클라이언트는 같은 네트워크의 Mac이나 다른 기기에서 실행되며 iPhone에 표시된 엔드포인트에 연결합니다.
개요
| 전송 | 엔드포인트 |
|---|---|
| HTTP(권장) | http://{LAN_IP}:9000/mcp(HTTPS 사용 시 https://) |
| TCP | {LAN_IP}:9000(인증 없음) |
서버 실행 중 서버 화면에 표시된 주소로 {LAN_IP}를 바꿉니다.
사용 사례:
- Mac의 Claude Code, Codex, Cursor 또는 VS Code를 iPhone의 건강 데이터에 연결
- Claude Desktop 같은 stdio 전용 클라이언트에 mcp-remote (iOS / LAN) 사용
- 로컬 네트워크의 스크립트에서 지표와 운동 조회(HTTP)
- health-auto-export-mcp-server Node 브리지를 통한 TCP 연동
사전 요구사항
- iPhone의 Health Auto Export(클라이언트 연결 중 앱을 포그라운드로 유지)
- Premium 구독
- HTTP: 서버 화면의 Bearer 토큰
- iPhone의 로컬 네트워크 권한
- 클라이언트 기기: iPhone과 같은 Wi‑Fi 또는 LAN. **mcp-remote (iOS / LAN)**를 사용할 때만 Node.js
서버 시작
- iPhone에서는 보내기 탭에서 서버를 엽니다. iPad에서는 사이드바를 사용합니다.
- HTTP(권장) 또는 TCP를 선택합니다
- 선택적으로 HTTPS 사용을 켭니다(아래 지침)
- 서버 시작을 탭합니다
- 엔드포인트 URL과 Bearer 토큰을 복사합니다
HTTP든 TCP든 Health Auto Export가 백그라운드로 가면 실행 중인 서버는 자동으로 중지됩니다.
인증(HTTP)
모든 HTTP 요청에는 다음이 필요합니다:
Authorization: Bearer <your-token>
- 필요하면 서버 화면에서 토큰을 다시 생성하세요
- 평문 HTTP에서는 토큰이 암호화되지 않은 연결로 전송됩니다. 신뢰할 수 있는 네트워크에서만 사용하거나 HTTPS를 켜세요
- 기존 TCP에는 인증이 없습니다(변경 없음)
HTTPS (TLS)
HTTPS는 로컬에서 생성한 인증 기관(CA)을 사용합니다. https://로 연결하기 전에 각 클라이언트 기기에서 인증서를 내보내고 신뢰하세요.
HTTPS 사용
- 서버 화면을 엽니다(iPhone: 보내기 탭, iPad: 사이드바)
- HTTPS 사용을 켭니다
- CA 인증서 내보내기를 탭하고 공유 시트로 각 클라이언트 기기에 AirDrop하거나 CA 파일을 저장합니다
- 서버를 시작하고 엔드포인트 URL이
https://로 바뀌는지 확인합니다
클라이언트에서 CA 신뢰
내보낸 CA를 AI 클라이언트를 실행하는 기기(보통 Mac)에서 신뢰합니다:
- iPhone 서버 화면에서 CA를 내보냅니다
- 클라이언트 Mac의 키체인 접근에서 PEM을 엽니다
- 신뢰 → 항상 신뢰로 설정합니다
생성 설정용 Node 버전
앱이 생성하는 Node 브리지 설정은 다음 Node 버전에서 NODE_OPTIONS=--use-system-ca를 사용합니다:
| Node 계열 | 최소 버전 |
|---|---|
| 22.x | 22.19.0 |
| 23.x | 23.8.0 |
| 24.x | 24.6.0 |
| 25+ | any |
이전 Node에서는 대신 브리지 프로세스가 읽을 수 있는 PEM 경로를 NODE_EXTRA_CA_CERTS에 설정합니다. 지원되지 않는 Node에서 --use-system-ca를 내면 프로세스가 시작되지 않습니다.
신뢰 범위:
--use-system-ca는 이 앱의 CA뿐 아니라 시스템 키체인 전체를 신뢰합니다.NODE_EXTRA_CA_CERTS는 내보낸 CA를 Node의 신뢰할 수 있는 인증서에 추가합니다. Node 인증서 옵션을 참조하세요.
| 클라이언트 유형 | 설정 |
|---|---|
| Cursor, VS Code, Claude Code, Codex | 클라이언트 Mac의 키체인 신뢰 — 서버 화면의 https:// 엔드포인트 사용 |
| mcp-remote (iOS / LAN) | mcp-remote를 실행하는 Mac의 키체인에서 CA를 신뢰. Node가 최소 버전을 충족하면 스니펫은 NODE_OPTIONS=--use-system-ca를 사용. 이전 Node에서는 읽을 수 있는 PEM 경로를 NODE_EXTRA_CA_CERTS에 설정 |
| curl / 스크립트 | --cacert /path/to/mcp-ca.pem을 전달하거나 NODE_EXTRA_CA_CERTS를 설정 |
올바른 인증서를 내보냈는지 확인할 수 있도록 CA 지문은 서버 화면에 표시됩니다.
iOS LAN IP 변경
iPhone 네트워크 주소가 바뀌면 엔드포인트 URL을 다시 복사하세요. 교체 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에서 실행합니다(Claude Code CLI 필요):
HTTP:
claude mcp add --transport http health-auto-export \
http://192.168.1.42:9000/mcp \
--header "Authorization: Bearer <token>"
HTTPS(Mac에서 CA를 내보내고 신뢰한 후):
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
Codex를 시작하기 전에 Bearer 토큰으로 HAE_MCP_TOKEN을 내보냅니다. 설정 후 Codex 세션에서 /mcp를 실행해 서버 연결을 확인합니다.
Health Auto Export에서 Bearer 토큰을 다시 생성한 경우 HAE_MCP_TOKEN을 업데이트하고 codex mcp add를 다시 실행하거나 서버 항목을 삭제한 뒤 다시 추가하세요.
mcp-remote (iOS / LAN)
HTTP로 직접 연결할 수 없는 stdio 전용 클라이언트(Claude Desktop 등)용입니다. 클라이언트를 실행하는 Mac에 Node.js가 필요합니다.
- 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가 켜진 경우:
- iPhone에서 CA를 내보내고 Mac의 키체인 접근에서 신뢰합니다(항상 신뢰)
https://192.168.1.42:9000/mcp를args에서 사용합니다- 위 생성 설정이 지원하는 Node 버전에서는 같은 서버 구성 객체에 다음
env객체를 추가합니다:
{
"env": {
"NODE_OPTIONS": "--use-system-ca"
}
}
이전 Node에서는 대신 읽을 수 있는 PEM 경로를 NODE_EXTRA_CA_CERTS에 설정합니다. 구성 업데이트 후 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
- 포트 9000의 암호화·인증 없는 JSON-RPC
- 레거시 도구 이름에는 Node의
health-auto-export-mcp-server브리지와 계약 v1.0.0을 사용 get_* TCP 도구 이름에는 계약 v1.1.0을 사용(Node 브리지는 별도 업데이트)
팁
- 클라이언트 연결 중 iPhone에서 Health Auto Export를 포그라운드로 유지
- 토큰이 노출된 것으로 의심되면 다시 생성
- iPhone LAN IP가 바뀌면 엔드포인트 URL을 다시 복사