Collegamento di un assistente AI con una chiave API
Non tutti gli assistenti AI possono effettuare l'accesso a FitnessSyncer MCP Server per conto tuo. Molti offrono solo un indirizzo server e uno spazio in cui inserire un token, mentre altri leggono l'intera configurazione da un file su disco. Per questi ultimi, FitnessSyncer emette una chiave API, ovvero un unico token a lunga durata che sostituisce l'intero processo di accesso.
Ecco come si collega Mistral Vibe, ed è anche la soluzione ideale per un assistente self-hosted, un client da riga di comando, un framework per agenti o un ChatGPT che offre un’intestazione anziché una schermata OAuth. Claude, ChatGPT, Perplexity e Home Assistant dispongono ciascuno di una propria procedura di accesso, pertanto si consiglia di seguire le relative istruzioni ove applicabili.
Prima di iniziare
- Un account FitnessSyncer con le tue fonti collegate. Il MCP Server è incluso in ogni account, quindi non c'è nulla da acquistare in più; consulta la sezione "Guida introduttiva" se sei un nuovo utente. Un account gratuito offre un accesso a una cronologia meno estesa, esattamente come in ogni altra sezione del sito.
- Un assistente in grado di inviare un'intestazione "Authorization", oppure che definisce lo stesso concetto come "Bearer Token" o "token API". Se il tuo assistente consente invece di effettuare l'accesso con OAuth, questa è la soluzione migliore, poiché ti permette di scegliere le autorizzazioni ogni volta anziché una sola volta.
Una chiave API è una password che consente l'accesso alle autorizzazioni che le concedi e non scade automaticamente. Utilizzala solo con un assistente di cui ti fidi per i tuoi dati sanitari e concedigli solo le autorizzazioni strettamente necessarie.
Passaggio 1: Crea la tua chiave API su FitnessSyncer
- Vai alla pagina "Account sviluppatori".
- In fondo alla pagina, seleziona “MCP: Chiave API” dall’elenco e clicca su “Crea”.
- FitnessSyncer chiede quali autorizzazioni debba avere questa chiave. Seleziona solo ciò che desideri che l'assistente faccia; per rispondere alle domande, sono sufficienti le autorizzazioni di lettura, e nessuna delle opzioni che lasci deselezionate potrà essere utilizzata in seguito senza creare una nuova chiave.
- Seleziona "Crea chiave API" e prendi nota della chiave API nella pagina successiva. Viene visualizzata solo una volta; se la perdi, puoi rigenerarla, ma dovrai poi inserirla nuovamente nel tuo assistente.
Step 2: Mistral Vibe
Una volta ottenuta la chiave API:
- Dal menu a sinistra, seleziona “Contesto” e poi “Connettori”.
- Seleziona "Aggiungi connettore" nell'angolo in alto a destra dello schermo.
- Selezionare il connettore personalizzato MCP.
- Inserisci "FitnessSyncer" come nome
- Inserisci "https://www.fitnesssyncer.com/services/mcp" come nome del server
- Seleziona "Autenticazione tramite token API" e incolla la tua chiave API nel campo "Token Bearer".
Fase 2: Qualsiasi altro assistente dotato di una schermata delle impostazioni
I campi hanno nomi diversi a seconda dell'assistente, ma sono sempre e solo tre:
- Inserisci "FitnessSyncer" come nome
- Inserisci https://www.fitnesssyncer.com/services/mcp come Server, che alcuni assistenti chiamano URL del server remoto MCP
- Inserisci la tua chiave API nel campo "Bearer Token". Se l'assistente richiede invece un'intestazione, il nome dell'intestazione è "Authorization" e il suo valore è la parola "Bearer", seguita da uno spazio e dalla tua chiave API.
Se l'assistente ti chiede anche di scegliere un protocollo di trasporto, seleziona "Streamable HTTP". FitnessSyncer non supporta il vecchio protocollo SSE.
Fase 2: Un assistente configurato a partire da un file
Molti client da riga di comando e desktop leggono le impostazioni dei propri server da un file JSON. Il formato varia, quindi è necessario fare riferimento alla documentazione del proprio assistente, ma solitamente si presenta così:
{
"mcpServers": {
"FitnessSyncer": {
"transport": "http",
"url": "https://www.fitnesssyncer.com/services/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
Sostituisci YOUR_TOKEN_HERE con la tua chiave API, mantenendo la parola "Bearer" e lo spazio che la precede.
Provalo
Apri una nuova chat e incolla uno qualsiasi di questi messaggi per verificare che tutto funzioni correttamente:
- Elenca tutte le app e i dispositivi a cui FitnessSyncer è attualmente connesso per il mio account e mostra quando è avvenuta l'ultima sincronizzazione.
- Come ho dormito questa settimana rispetto alla settimana scorsa?
- Come si è comportata la mia frequenza cardiaca a riposo nell'ultimo mese?
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.
Devo usare una chiave API o effettuare l'accesso?
Effettua l'accesso dove il tuo assistente lo supporta. Un accesso OAuth ti chiede quali autorizzazioni concedere al momento della connessione e può essere revocato per quella singola connessione; una chiave API mantiene le impostazioni che hai scelto al momento della creazione, per tutto il tempo in cui rimane attiva.
Utilizza una chiave API quando l'assistente non riesce ad accedere, come nel caso di Mistral Vibe e della maggior parte dei client configurati tramite file.
Posso modificare le operazioni consentite a una chiave API?
Non a posteriori. I permessi vengono definiti al momento della creazione della chiave; pertanto, per ampliarli o restringerli, è necessario eliminare la chiave in “Configurazione sviluppatore” e crearne una nuova con i permessi desiderati. L’assistente dovrà quindi utilizzare la nuova chiave.
Ho perso la mia chiave API. E adesso?
La chiave viene visualizzata solo al momento della creazione, quindi non c'è nulla da cercare. Rigenerala nella sezione “Configurazione sviluppatore” e inserisci quella nuova nel tuo assistente. La vecchia chiave smette di funzionare non appena la rigeneri; questo è anche il modo per bloccare un assistente di cui non ti fidi più.
Come si disattiva un assistente?
Rimuovi il connettore dall'assistente, quindi elimina la chiave nella configurazione dello sviluppatore. L'eliminazione della chiave è la parte fondamentale, perché altrimenti qualsiasi elemento che la contenga continuerebbe a funzionare.
