Apple Health 데이터를 AI 도구에 연결하기
Health Auto Export MCP 서버로 호환 AI 도구에서 HTTP를 통해 건강 지표와 운동을 조회하세요. HTTPS는 선택 사항입니다.
Health Auto Export는 내장 MCP 서버를 통해 Apple Health 데이터를 호환 AI 도구에 연결합니다. 일일 걸음 수 합계를 요청하고, 기록된 운동을 살펴보거나, 분석을 위해 선택한 지표를 가져오세요. 내보내기 파일을 미리 준비하고 업로드할 필요가 없습니다.
데이터를 대화에 가져오기
Model Context Protocol(MCP)은 AI 애플리케이션이 연결된 도구에서 정보를 요청하는 표준 방식을 제공합니다. Health Auto Export는 이를 사용해 연결한 클라이언트에 지원되는 건강 데이터를 제공합니다.
예를 들어 호환 클라이언트에 “지난 7일간의 일일 걸음 수 합계를 보여줘” 또는 “지난주 운동을 나열해줘”라고 요청할 수 있습니다. 클라이언트는 Health Auto Export를 통해 관련 기록을 요청하고 응답에 결과를 사용할 수 있습니다. 제시할 수 있는 내용은 클라이언트와 사용 가능한 데이터에 따라 달라집니다.
Claude Code, Codex, Cursor, VS Code 같은 도구는 앱에서 제공하는 설정 옵션으로 연결할 수 있습니다.
HTTP를 통한 직접 연결
Health Auto Export v9.0.11에서 도입된 Streamable HTTP 지원으로 호환 클라이언트가 서버에 직접 연결할 수 있습니다. 이 연결을 지원하는 클라이언트는 레거시 TCP 설정에서 사용하던 별도의 Node.js 브리지가 필요하지 않습니다.
일부 클라이언트는 대신 브리지를 사용합니다. 서버 화면은 클라이언트별 구성을 제공하며, 설정 가이드에서 어떤 방식을 사용할지 설명합니다.
HTTP 연결에는 앱에 표시된 Bearer 토큰이 필요합니다. 선택적 HTTPS는 연결을 암호화합니다. HTTPS 사용을 켠 다음, 클라이언트가 실행되는 기기에서 앱 인증서를 내보내고 신뢰하세요. 일반 HTTP는 암호화되지 않으며 신뢰할 수 있는 네트워크에서만 사용해야 합니다.
iPhone 또는 Mac에서 연결
iPhone에서 서버는 앱의 건강 데이터 액세스에 따라 지원 데이터를 로컬 네트워크에서 사용할 수 있게 합니다. 클라이언트를 같은 네트워크에 두고 Health Auto Export를 포그라운드에서 열어 두세요. 앱을 백그라운드로 보내면 서버가 중지됩니다.
Mac에서 서버는 같은 Mac에서 실행되는 클라이언트에 동기화된 건강 지표와 운동을 제공합니다. Mac에 동기화를 통해 제공된 데이터를 사용하므로, 사용 가능한 기록은 iPhone에서 동기화된 내용에 따라 달라집니다.
서버는 연결한 클라이언트에 요청된 건강 데이터를 반환합니다. 해당 클라이언트가 클라우드 AI 서비스를 사용하는 경우, 데이터 처리는 서비스의 설정과 정책에 따라 달라집니다.
시작하기
MCP 서버는 Health Auto Export Premium에 포함됩니다. iPhone에서 내보내기 → 서버를 열고 HTTP를 선택한 다음 서버 시작을 탭하세요. 앱에 표시된 엔드포인트와 Bearer 토큰으로 클라이언트를 구성하세요. HTTPS를 켜면 연결하기 전에 인증서 설정을 완료하세요.