서버에 연결

고급 기능을 위해 Health Auto Export 서버에 연결합니다.

Last updated: February 5, 2026

On this page

TCP/MCP 서버를 사용하면 로컬 네트워크를 통해 다른 기기에서 직접 건강 데이터를 쿼리할 수 있습니다. 이를 통해 같은 네트워크에서 실행 중인 다른 애플리케이션, 스크립트 또는 서비스와 통합할 수 있습니다.

개요

TCP/MCP 서버는 다른 기기 및 애플리케이션의 연결을 수락하는 로컬 네트워크 서버를 생성합니다. 건강 데이터를 쿼리하고, 자동화를 실행하며, 프로그래밍 방식으로 Health Auto Export와 상호 작용할 수 있습니다.

사용 사례:

  • 네트워크의 다른 기기에서 건강 데이터 쿼리
  • 로컬 애플리케이션 및 스크립트와 통합
  • 명령줄 도구에서 건강 데이터 액세스
  • MCP 프로토콜을 사용하여 사용자 정의 통합 구축

주요 기능:

  • 안정적인 연결을 위한 TCP 기반 서버
  • MCP(Model Context Protocol) 지원
  • 로컬 네트워크 액세스
  • 실시간 건강 데이터 쿼리
  • 프로그래밍 방식 자동화 제어

제한 사항:

  • 앱이 포그라운드에서 실행되어야 합니다
  • 현재 암호화되지 않음 (신뢰할 수 있는 네트워크에서만 사용)
  • 로컬 네트워크 권한 필요
  • 서버가 실행 중일 때만 연결이 작동합니다

사전 요구 사항

  • iPhone/iPad에서 실행 중인 Health Auto Export
  • 같은 로컬 네트워크의 기기
  • 로컬 네트워크 권한 부여됨
  • 프리미엄 구독
  • 신뢰할 수 있는 네트워크

서버 시작

  1. 서버 화면에서 "서버 시작"을 탭합니다
  2. 서버가 시작될 때까지 대기합니다(상태가 "실행 중"으로 변경됨)
  3. 화면에 표시된 IP 주소와 포트를 기록합니다
  4. 서버가 이제 연결을 수락합니다

IP 주소/포트 표시:

  • 서버는 기기의 IP 주소를 표시합니다
  • 기본 포트는 9000입니다

서버에 연결

IP 주소 찾기

서버 화면은 기기의 IP 주소를 자동으로 표시합니다. 이것이 다른 기기가 연결에 사용해야 하는 주소입니다.

예: 192.168.1.100:9000

서버 사용

MCP 프로토콜

서버는 통신을 위해 Model Context Protocol(MCP)을 사용합니다.

연결 로그

서버 화면에는 다음을 보여주는 연결 로그가 표시됩니다:

  • 들어오는 연결 시도
  • 요청 세부 정보
  • 응답 정보
  • 오류 메시지

로그 보기:

  • 로그는 서버 화면의 목록에 자동으로 나타납니다
  • 최근 활동을 보려면 스크롤하세요
  • 로그는 연결 문제 디버깅에 도움이 됩니다