Menghubungkan AI Assistant dengan Kunci API
Tidak semua asisten AI dapat masuk ke FitnessSyncer MCP Server atas nama Anda. Banyak di antaranya hanya menyediakan alamat server dan tempat untuk memasukkan token, sementara beberapa lainnya membaca seluruh konfigurasinya dari berkas di disk. Untuk kasus tersebut, FitnessSyncer menerbitkan Kunci API, yaitu satu token yang berlaku lama yang berfungsi sebagai pengganti seluruh proses masuk.
Beginilah cara Mistral Vibe terhubung, dan ini juga merupakan solusi untuk asisten yang dihosting sendiri, klien baris perintah, kerangka kerja agen, atau ChatGPT yang menampilkan header alih-alih layar OAuth. Claude, ChatGPT, Perplexity, dan Home Assistant masing-masing memiliki proses masuk tersendiri, jadi ikuti petunjuk masing-masing jika berlaku.
Sebelum Anda mulai
- Akun FitnessSyncer dengan sumber-sumber Anda yang sudah terhubung. Fitur MCP Server sudah termasuk dalam setiap akun, jadi tidak perlu membeli apa pun secara terpisah; lihat bagian Memulai jika Anda baru pertama kali menggunakan layanan ini. Akun gratis di sini mencakup riwayat yang lebih singkat, sama seperti di bagian lain situs ini.
- Sebuah asisten yang dapat mengirimkan header Otorisasi, atau yang menyebutnya sebagai Bearer Token atau token API. Jika asisten Anda dapat masuk menggunakan OAuth sebagai gantinya, itu adalah pilihan yang lebih baik, karena Anda dapat memilih izin yang diperlukan setiap kali, bukan hanya sekali saja.
Kunci API adalah kata sandi untuk izin yang Anda berikan, dan tidak akan kedaluwarsa dengan sendirinya. Gunakanlah hanya pada asisten yang Anda percayai untuk mengelola data kesehatan Anda, dan berikan izin seminimal mungkin yang diperlukan.
Langkah 1: Buat Kunci API Anda di FitnessSyncer
- Buka halaman Akun Pengembang.
- Di bagian bawah halaman, pilih “MCP: Kunci API” dari daftar, lalu klik “Buat”.
- FitnessSyncer menanyakan izin apa saja yang harus dimiliki kunci ini. Pilih hanya tindakan yang ingin Anda lakukan melalui asisten; untuk menjawab pertanyaan, izin baca saja sudah cukup, dan opsi yang tidak Anda centang tidak dapat digunakan nanti tanpa membuat kunci baru.
- Pilih "Buat Kunci API", lalu catat Kunci API yang tertera di halaman berikutnya. Kunci ini hanya ditampilkan sekali; jika Anda kehilangannya, Anda dapat membuatnya kembali, tetapi Anda harus memasukkannya kembali ke dalam asisten Anda.
Step 2: Mistral Vibe
Setelah Anda memiliki Kunci API:
- Dari menu sebelah kiri, pilih "Context", lalu pilih "Connectors".
- Pilih "Tambahkan Konektor" di sudut kanan atas layar.
- Pilih Konektor Kustom MCP.
- Masukkan "FitnessSyncer" sebagai Nama
- Masukkan https://www.fitnesssyncer.com/services/mcp sebagai Server
- Pilih "Otentikasi Token API" dan tempelkan Kunci API Anda ke kolom "Token Bearer".
Langkah 2: Asisten lain apa pun yang memiliki layar pengaturan
Nama kolom-kolom tersebut berbeda-beda tergantung asistennya, tetapi jumlahnya selalu hanya tiga:
- Masukkan "FitnessSyncer" sebagai Nama
- Masukkan https://www.fitnesssyncer.com/services/mcp sebagai Server, yang oleh beberapa asisten disebut sebagai URL server Jarak Jauh MCP
- Masukkan Kunci API Anda ke dalam kolom Bearer Token. Jika asisten meminta header, nama header yang dimaksud adalah Authorization dan nilainya berupa kata "Bearer", diikuti spasi, lalu Kunci API Anda.
Jika asisten juga meminta Anda untuk memilih jenis transportasi, pilih Streamable HTTP. FitnessSyncer tidak menyediakan jenis transportasi SSE yang lebih lama.
Langkah 2: Asisten yang dikonfigurasi dari sebuah berkas
Banyak klien baris perintah dan desktop membaca konfigurasi servernya dari berkas JSON. Formatnya bervariasi, jadi sesuaikan dengan dokumentasi asisten Anda sendiri, tetapi biasanya terlihat seperti ini:
{
"mcpServers": {
"FitnessSyncer": {
"transport": "http",
"url": "https://www.fitnesssyncer.com/services/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
Ganti YOUR_TOKEN_HERE dengan Kunci API Anda, dengan tetap mempertahankan kata "Bearer" dan spasi di depannya.
Coba saja
Buka obrolan baru dan tempelkan salah satu dari yang berikut ini untuk memastikan semuanya berfungsi dengan baik:
- Tampilkan daftar semua aplikasi dan perangkat yang saat ini terhubung ke akun saya melalui FitnessSyncer serta tunjukkan kapan terakhir kali perangkat-perangkat tersebut melakukan sinkronisasi.
- Bagaimana kualitas tidurku minggu ini dibandingkan dengan minggu lalu?
- Bagaimana perkembangan detak jantung istirahat saya selama sebulan terakhir?
Masih ada banyak ide lainnya di halaman MCP Server.
Asisten AI Anda menjelaskan hasil pemeriksaan Anda berdasarkan pedoman umum; hal ini bukanlah saran medis.
Haruskah saya menggunakan Kunci API atau masuk ke akun?
Masuklah di platform yang didukung oleh asisten Anda. Proses masuk OAuth akan menanyakan izin apa saja yang ingin Anda berikan saat Anda terhubung, dan izin tersebut dapat dicabut untuk koneksi tersebut saja; sedangkan Kunci API akan tetap menggunakan pengaturan yang Anda pilih saat membuatnya, selama kunci tersebut masih berlaku.
Gunakan Kunci API jika asisten tidak dapat masuk, seperti halnya pada Mistral Vibe dan sebagian besar klien yang dikonfigurasi melalui berkas.
Apakah saya bisa mengubah fungsi yang diizinkan untuk dilakukan oleh Kunci API?
Jangan dilakukan setelahnya. Izin-izin tersebut sudah ditetapkan saat kunci dibuat, jadi untuk memperluas atau mempersempitnya, hapus kunci tersebut di Konfigurasi Pengembang dan buat yang baru dengan izin yang Anda inginkan. Asisten Anda kemudian memerlukan kunci yang baru tersebut.
Saya kehilangan Kunci API saya. Apa yang harus saya lakukan sekarang?
Kunci tersebut hanya ditampilkan saat dibuat, jadi tidak ada yang perlu dicari. Buat ulang kunci tersebut di Pengaturan Pengembang, lalu masukkan kunci baru ke dalam asisten Anda. Kunci lama akan langsung tidak berfungsi begitu Anda membuat ulang, dan inilah cara untuk memblokir asisten yang tidak lagi Anda percayai.
Bagaimana cara memutuskan hubungan dengan seorang asisten?
Lepaskan konektor di asisten, lalu hapus kunci tersebut di Konfigurasi Pengembang. Menghapus kunci itulah yang paling penting, karena jika masih ada yang mengaitkannya, maka fungsi tersebut akan tetap berjalan.
