FitnessSyncer e Home Assistant
Home Assistant può utilizzare FitnessSyncer MCP Server grazie alla sua integrazione con Model Context Protocol. Una volta connesso, il AI integrato in Assist può rispondere alle domande relative ai tuoi dati di salute e forma fisica, tramite voce o chat: come hai dormito questa settimana, se la tua frequenza cardiaca a riposo sta diminuendo o quando hai registrato l’ultima pesata.
Questa operazione collega Assist a FitnessSyncer, in modo che possa rispondere alle tue domande. Non aggiunge sensori FitnessSyncer alle tue dashboard o alle tue automazioni.
Prima di iniziare
- Un account FitnessSyncer con le tue fonti collegate. Il MCP Server è incluso in ogni account; consulta la sezione "Guida introduttiva" se sei un nuovo utente.
- Home Assistant con Assist configurato per utilizzare un agente di conversazione AI, come Open AI, Anthropic, Google Gemini o un modello locale tramite Ollama. Il FitnessSyncer MCP Server offre numerosi strumenti e un modello più grande è in grado di scegliere tra questi in modo più affidabile rispetto a un modello locale di piccole dimensioni.
- L'integrazione My Home Assistant, che fa parte della configurazione predefinita. Effettuando l'accesso a FitnessSyncer si torna al proprio Home Assistant tramite essa.
Passaggio 1: Crea le tue chiavi su FitnessSyncer
- Vai alla pagina "Account sviluppatori".
- In fondo alla pagina, seleziona Home Assistant dall'elenco e clicca su “Crea”.
- Prendi nota dell'ID cliente e del segreto cliente. Il segreto cliente viene visualizzato solo una volta; se lo perdi, puoi rigenerarlo, ma dovrai poi inserirlo nuovamente in Home Assistant.
Fase 2: Aggiungere FitnessSyncer a Home Assistant
- In Home Assistant, vai su Impostazioni, quindi su Dispositivi e servizi.
- Seleziona “Aggiungi integrazione” e scegli “Model Context Protocol”.
- Inserisci https://www.fitnesssyncer.com/services/mcp come URL del server e invia.
- Home Assistant richiede le credenziali dell'applicazione. Inserisci FitnessSyncer come nome e incolla l'ID cliente e la chiave segreta del cliente riportati al Passo 1.
- Verrai reindirizzato a FitnessSyncer per effettuare l'accesso e approvare le autorizzazioni richieste da Home Assistant. Deseleziona tutte le opzioni che non desideri che Assist esegua; per rispondere alle domande, sono sufficienti le autorizzazioni di lettura.
- Si torna a Home Assistant, che completa l'aggiunta dell'integrazione.
Passaggio 3: Consenti ad Assist di utilizzare FitnessSyncer
- In Home Assistant, vai su Impostazioni, poi su Dispositivi e servizi, apri la tua integrazione AI (ad esempio Open AI Conversation) e seleziona l'icona a forma di ingranaggio accanto al relativo agente di conversazione.
- Seleziona "Under Control" Home Assistant, seleziona anche FitnessSyncer e invia.
- Nella sezione Impostazioni, poi Assistenti vocali, apri l'assistente con cui parli e imposta il suo agente di conversazione su quell'agente.
- Il tuo provider AI addebita i costi relativi alla propria API separatamente dall'abbonamento alla chat. Se Assist ti comunica che i fondi non sono sufficienti, ricarica il credito presso il tuo provider; Google Gemini offre anche un piano gratuito.
Provalo
Chiedi ad Assist di eseguire una delle seguenti operazioni per verificare che tutto funzioni correttamente:
- A quali app e dispositivi è collegato FitnessSyncer e quando è avvenuta l'ultima sincronizzazione per ciascuno di essi?
- Come ho dormito questa settimana rispetto alla settimana scorsa?
- Come si è comportata la mia frequenza cardiaca a riposo nell'ultimo mese?
- Quanti passi ho fatto ieri e come si colloca questo dato rispetto al mio obiettivo?
Nella pagina MCP Server ci sono molte altre idee.
Il tuo assistente AI ti spiega i risultati delle analisi sulla base delle linee guida pubbliche; non si tratta di un parere medico.
I dati FitnessSyncer possono essere visualizzati come sensori sulla mia dashboard Home Assistant?
Non tramite questa integrazione. Risponde alle domande quando le poni ad Assist e non crea sensori né cronologie in Home Assistant. Se ti fossero utili dei sensori per i passi, il sonno o il peso, faccelo sapere.
Home Assistant Non riesco a collegarmi al server. Cosa dovrei controllare?
- L'URL deve essere esattamente https://www.fitnesssyncer.com/services/mcp. FitnessSyncer utilizza il trasporto HTTP Streamable, non quello più vecchio SSE.
- Home Assistant deve essere abbastanza recente affinché la sua integrazione con Model Context Protocol consenta l'accesso. Se non ti vengono richieste le credenziali dell'applicazione, aggiorna Home Assistant.
Dopo aver effettuato l'accesso a FitnessSyncer, non riesco a tornare a Home Assistant. Perché?
L'accesso avviene tramite My Home Assistant, che a sua volta apre il tuo Home Assistant. Assicurati che l'integrazione con My Home Assistant sia abilitata e che tu stia effettuando l'accesso da un browser in grado di raggiungere il tuo Home Assistant.
Se la pagina "Collega account" rimane in attesa e non si chiude mai, controlla l'URL dell'istanza visualizzato sotto di essa. Inizia con http://homeassistant.local:8123, , che funziona solo per un Home Assistant presente con quel nome sulla tua rete. Seleziona l'icona a forma di matita, inserisci l'indirizzo che utilizzi per aprire il tuo Home Assistant e riprova a collegarlo. Se Home Assistant visualizza un errore, significa che l'accesso ha richiesto troppo tempo: rimuovi la voce non completata e aggiungi nuovamente l'integrazione.
Come si scollega Home Assistant?
Rimuovi l'integrazione in Home Assistant, quindi revoca le relative autorizzazioni nel tuo profilo oppure elimina le chiavi Home Assistant nella configurazione sviluppatore.
