FitnessSyncer 및 Home Assistant
Home Assistant는 Model Context Protocol 연동 기능을 통해 FitnessSyncer MCP Server를 사용할 수 있습니다. 연결이 완료되면, Assist 뒤에 있는 AI는 음성이나 채팅을 통해 사용자의 건강 및 피트니스 데이터에 대한 질문에 답변할 수 있습니다. 예를 들어, 이번 주 수면 상태, 안정시 심박수가 감소 추세를 보이고 있는지, 마지막으로 체중을 측정한 시기는 언제인지 등에 대한 질문에 답해줍니다.
이 기능은 Assist를 FitnessSyncer에 연결하여 사용자가 질문할 때 답변할 수 있도록 합니다. 대시보드나 자동화 설정에 FitnessSyncer 센서를 추가하지는 않습니다.
시작하기 전에
- 소스가 연결된 FitnessSyncer 계정입니다. MCP Server는 모든 계정에 포함되어 있습니다. 처음 이용하시는 분은 ‘시작하기’를 참고하세요.
- Home Assistant의 Assist는 AI 대화 에이전트(예: Open AI, Anthropic, Google Gemini 또는 Ollama를 통한 로컬 모델)를 사용하도록 설정되어 있습니다. FitnessSyncer MCP Server는 다양한 도구를 제공하며, 대형 모델은 소형 로컬 모델보다 이러한 도구들을 더 안정적으로 선택합니다.
- 기본 구성의 일부인 My Home Assistant 통합 기능입니다. FitnessSyncer에 로그인하면 이 기능을 통해 Home Assistant으로 돌아갑니다.
1단계: FitnessSyncer에서 키를 생성하세요.
- ‘개발자 계정’ 페이지로 이동하세요.
- 페이지 하단에서 목록에서 Home Assistant을 선택한 다음 “생성”을 클릭하세요.
- 클라이언트ID와 클라이언트 시크릿을 기록해 두세요. 클라이언트 시크릿은 이번 한 번만 표시됩니다. 분실할 경우 다시 생성할 수 있지만, 그 경우 Home Assistant에 다시 입력해야 합니다.
2단계: FitnessSyncer을 Home Assistant에 더하기
- Home Assistant에서 ‘설정’으로 이동한 다음, ‘기기 및 서비스’를 선택하세요.
- “통합 추가”를 선택한 다음 “Model Context Protocol”을 선택하세요.
- 서버 URL에 ‘https://www.fitnesssyncer.com/services/mcp’를 입력하고 제출하세요.
- Home Assistant에서 애플리케이션 자격 증명을 입력하라는 메시지가 표시됩니다. 이름 란에 FitnessSyncer을 입력하고, 1단계에서 확인한 클라이언트 ID와 클라이언트 시크릿을 붙여넣으세요.
- FitnessSyncer로 이동하여 로그인하고 Home Assistant에서 요청하는 권한을 승인하게 됩니다. Assist가 수행하지 않기를 원하는 항목은 선택을 해제하세요. 질문에 답변하는 용도라면 읽기 권한만으로도 충분합니다.
- Home Assistant로 돌아가면 적분 추가가 완료됩니다.
3단계: Assist가 FitnessSyncer을 사용하도록 설정하기
- Home Assistant에서 ‘설정’으로 이동한 다음, ‘기기 및 서비스’를 선택하고 AI 연동 기능(예: Open AI 대화)을 연 후, 해당 대화 에이전트 옆에 있는 톱니바퀴 아이콘을 선택하세요.
- “Under Control Home Assistant”을 선택한 후, FitnessSyncer도 선택하고 제출하세요.
- ‘설정’에서 ‘음성 어시스턴트’로 이동한 후, 사용 중인 어시스턴트를 열고 해당 어시스턴트의 ‘대화 에이전트’를 해당 에이전트로 설정하세요.
- AI 서비스 제공업체는 API 요금을 채팅 구독 요금과 별도로 청구합니다. Assist에서 잔액이 부족하다는 응답이 표시되면 해당 서비스 제공업체를 통해 크레딧을 충전하세요. Google Gemini는 무료 요금제도 제공합니다.
한 번 해보세요
모든 기능이 정상적으로 작동하는지 확인하려면 Assist에 다음 중 하나를 문의해 보세요:
- FitnessSyncer은 어떤 앱 및 기기와 연결되어 있으며, 각 기기는 마지막으로 언제 동기화되었나요?
- 지난주와 비교했을 때, 이번 주에는 잠을 어떻게 잤을까?
- 지난 한 달 동안 내 안정시 심박수는 어떻게 변했나요?
- 어제 몇 걸음을 걸었나요? 그리고 그 수치가 목표치와 비교하면 어떤가요?
MCP Server 페이지에는 더 많은 아이디어가 있습니다.
귀하의 AI 조수는 공적 지침을 바탕으로 검사 결과를 설명해 드리며, 이는 의학적 조언이 아닙니다.
FitnessSyncer 데이터가 제 Home Assistant 대시보드에 센서로 표시될 수 있나요?
이 통합 기능을 통해서가 아닙니다. 이 기능은 ‘Assist’에 질문을 하면 답변을 제공하며, Home Assistant에 센서나 기록을 생성하지 않습니다. 걸음 수, 수면, 체중을 측정하는 센서가 유용하다고 생각되시면 저희에게 알려 주시기 바랍니다.
Home Assistant 서버에 연결할 수 없습니다. 무엇을 확인해 봐야 할까요?
- URL은 반드시 https://www.fitnesssyncer.com/services/mcp. 와 정확히 일치해야 합니다. FitnessSyncer은 구형 SSE 전송 방식이 아닌 Streamable HTTP 전송 방식을 사용합니다.
- Home Assistant은 Model Context Protocol 통합 기능을 통해 로그인이 가능할 정도로 최신 버전이어야 합니다. 애플리케이션 인증 정보를 요청하지 않는다면 Home Assistant을 업데이트하십시오.
FitnessSyncer에 로그인한 후 Home Assistant으로 돌아가지 않습니다. 왜 그런가요?
로그인 후 ‘내 Home Assistant’으로 돌아오면, 사용자의 Home Assistant이 열립니다. ‘내 Home Assistant’ 연동 기능이 활성화되어 있는지, 그리고 사용자의 Home Assistant에 접속할 수 있는 브라우저에서 로그인하고 있는지 확인하십시오.
‘계정 연결’ 페이지가 계속 대기 상태로 머물러 완료되지 않는 경우, 페이지 하단에 표시된 인스턴스 URL을 확인하세요. 이 URL은 http://homeassistant.local:8123, 로 시작하며, 네트워크에서 해당 이름으로 검색된 Home Assistant에서만 작동합니다. 연필 아이콘을 선택한 후, Home Assistant을 열 때 사용하는 주소를 입력하고 다시 연결해 보세요. Home Assistant에서 오류가 표시된다면 로그인 과정이 너무 오래 걸린 것입니다. 완료되지 않은 항목을 삭제하고 통합을 다시 추가하세요.
