Hubungkan asisten AI

Gunakan klien MCP yang mendukung Streamable HTTP dan OAuth yang telah didaftarkan sebelumnya dengan PKCE atau token pembawa yang dikonfigurasi. Dukungan klien bervariasi; pendaftaran klien otomatis tidak tersedia.

URL server MCP

https://api.remotegymp.com/mcp

Untuk Self-Hosted, gunakan jalur MCP yang sama pada alamat HTTPS publik instalasi Anda. Klien Anda harus dapat menjangkaunya. Alamat Cloud tidak memproksi permintaan instalasi Anda.

Terhubung dengan OAuth

Di Pengaturan, buat kredensial dengan MCP diaktifkan dan hanya izin yang dibutuhkan asisten. Daftarkan URL panggilan balik persis yang diberikan oleh klien Anda. Gunakan nama pengguna kredensial sebagai ID klien OAuth. Alur ini tidak menggunakan rahasia klien.
Callback harus menggunakan HTTPS, atau HTTP pada alamat loopback eksplisit. URL lengkap harus cocok, termasuk portnya. Untuk mengubahnya, buat kredensial baru dan cabut kredensial lama.
Hubungkan dari klien Anda, masuk sebagai Pemilik yang membuat kredensial dan tinjau layar persetujuan. Klien harus menggunakan S256 PKCE dan URL sumber daya MCP. Persetujuan dapat mempersempit izin kredensial; itu tidak dapat menambahkan izin.

Titik akhir Cloud OAuth

Otorisasi: https://app.remotegymp.com/integration/oauth/authorize
Pertukaran token: https://app.remotegymp.com/integration/oauth/token
Metadata server otorisasi: https://app.remotegymp.com/.well-known/oauth-authorization-server
Metadata sumber daya yang dilindungi: https://api.remotegymp.com/.well-known/oauth-protected-resource/mcp

OAuth menggunakan nama bidang token standar dan token penyegaran yang berputar. Klien harus menangani penyegaran secara otomatis. Token akses bertahan paling lama 30 menit. Koneksi akan kedaluwarsa setelah tujuh hari tanpa penyegaran atau total 30 hari. Menggunakan kembali token penyegaran lama akan membatalkan koneksi; sambungkan kembali alih-alih memutar ulang.

Terhubung dengan token pembawa

Jika klien Anda mendukung token pembawa yang dikonfigurasi, tukarkan kredensial yang mendukung MCP di titik akhir token dengan audiens MCP, lalu masukkan token yang dikembalikan ke pengaturan token pembawa aman klien. Masa berlakunya habis setelah 30 menit. Jangan menaruh token di URL server. Gunakan OAuth untuk klien yang memerlukan penyegaran otomatis.

{
  "username": "<your-credential-username>",
  "password": "<your-credential-secret>",
  "audience": "mcp"
}

Autentikasi →

Periksa akses sebelum melakukan pekerjaan

Minta klien untuk membuat daftar alat yang tersedia dan kemampuan membaca terlebih dahulu. Mulailah dengan permintaan hanya-baca, seperti mencantumkan perangkat. Alat yang tidak ada mungkin mencerminkan izin, cakupan, atau ketersediaan. Mengaktifkan MCP saja tidak memberikan kendali jarak jauh.

tools/list · get_capabilities

Tampilan layar mengikuti persetujuan perangkat. Input layar memerlukan tangkapan layar baru. Tinjau target, pratinjau penghapusan, dan kuotasi biaya AI sebelum menyetujui pekerjaan. Penghentian darurat menghalangi otomatisasi lebih lanjut; pekerjaan yang sudah berjalan mungkin selesai.

Putuskan atau cabut akses

Putuskan sambungan di klien Anda dan cabut kredensial di Pengaturan jika tidak lagi diperlukan. Pencabutan menghentikan token terkait dan koneksi OAuth pada permintaan berikutnya. Jangan pernah berbagi kredensial di antara integrasi yang tidak terkait.