Conectarea unui asistent AI cu o cheie API

Nu orice asistent AI se poate autentifica în FitnessSyncer MCP Server în numele tău. Mulți oferă doar o adresă de server și un loc unde să introduci un token, iar unii își citesc întreaga configurație dintr-un fișier de pe disc. Pentru aceștia, FitnessSyncer emite o cheie API, care este un singur token cu durată lungă de viață ce înlocuiește întregul proces de autentificare.

Așa se conectează Mistral Vibe, iar aceasta este și soluția pentru un asistent auto-găzduit, un client de linie de comandă, un cadru de lucru pentru agenți sau un ChatGPT care îți oferă un antet în locul unui ecran OAuth. Claude, ChatGPT, Perplexity și Home Assistant au fiecare propria procedură de autentificare, așa că urmați instrucțiunile specifice fiecăruia, acolo unde este cazul.

Înainte de a începe

• Un cont FitnessSyncer cu sursele tale conectate. MCP Server este inclus în fiecare cont, așa că nu trebuie să cumperi nimic în plus; consultă secțiunea „Noțiuni introductive” dacă ești nou pe site. Un cont gratuit oferă acces la o perioadă mai scurtă de istoric aici, exact la fel ca în restul site-ului.
• Un asistent care poate trimite un antet de autorizare sau care denumește același lucru „token Bearer” sau „token API”. Dacă asistentul tău se poate autentifica folosind OAuth în schimb, aceasta este varianta mai bună, deoarece îți permite să alegi permisiunile de fiecare dată, nu doar o singură dată.

Pasul 1: Creați-vă cheia API pe FitnessSyncer

1. Accesați pagina „Conturi pentru dezvoltatori”.
2. În partea de jos a paginii, selectați „MCP: Cheie API” din listă și faceți clic pe „Creați”.
3. FitnessSyncer întreabă ce permisiuni ar trebui să aibă această cheie. Selectează doar acele acțiuni pe care dorești ca asistentul să le efectueze; pentru a răspunde la întrebări, permisiunile de citire sunt suficiente, iar opțiunile pe care nu le bifezi nu pot fi utilizate ulterior fără a crea o nouă cheie.
4. Selectați „Creați cheia API” și notați cheia API afișată pe pagina următoare. Aceasta este afișată o singură dată; dacă o pierdeți, o puteți regenera, dar va trebui apoi să o introduceți din nou în asistent.

  Step 2: Mistral Vibe

Odată ce ai cheia API la îndemână:

1. Din meniul din stânga, selectați „Context”, apoi „Conectori”.
2. Selectați opțiunea „Adăugare conector” din colțul din dreapta sus al ecranului.
3. Selectați conectorul personalizat MCP.
4. Introduceți „FitnessSyncer” ca nume
5. Introduceți „https://www.fitnesssyncer.com/services/mcp” pentru server
6. Selectați opțiunea „Autentificare cu token API” și introduceți cheia API în câmpul „Token Bearer”.

Pasul 2: Orice alt asistent care dispune de un ecran de setări

Câmpurile au denumiri diferite de la un asistent la altul, dar sunt întotdeauna doar trei:

1. Introduceți „FitnessSyncer” ca nume
2. Introduceți „https://www.fitnesssyncer.com/services/mcp” ca server, pe care unii asistenți îl numesc URL-ul serverului la distanță MCP
3. Introdu cheia API în câmpul „Bearer Token”. Dacă asistentul îți solicită în schimb un antet, numele antetului este „Authorization”, iar valoarea acestuia este cuvântul „Bearer”, urmat de un spațiu și de cheia ta API.

Dacă asistentul vă solicită, de asemenea, să alegeți un protocol de transport, selectați „Streamable HTTP”. FitnessSyncer nu oferă protocolul de transport SSE mai vechi.

Pasul 2: Un asistent configurat pe baza unui fișier

Mulți clienți de linie de comandă și de desktop citesc datele de la serverele lor dintr-un fișier JSON. Structura acestuia variază, așa că consultați documentația propriului asistent, dar, de obicei, arată astfel:

{
 "mcpServers": {
   "FitnessSyncer": {
     "transport": "http",
     "url": "https://www.fitnesssyncer.com/services/mcp",
     "headers": {
       "Authorization": "Bearer YOUR_TOKEN_HERE"
     }
   }
 }
}

Înlocuiți YOUR_TOKEN_HERE cu cheia dvs. API, păstrând cuvântul „Bearer” și spațiul din fața acestuia.

Încearcă-l

Deschide o nouă conversație și lipește oricare dintre acestea pentru a verifica dacă totul funcționează:

• Afișează toate aplicațiile și dispozitivele la care FitnessSyncer este conectat în prezent pentru contul meu și indică data la care s-au sincronizat ultima dată.
• Cum am dormit săptămâna aceasta în comparație cu săptămâna trecută?
• Cum a evoluat ritmul cardiac în repaus în ultima lună?

Pe pagina MCP Server se găsesc multe alte idei.