Lewati ke konten
mofcloud

MCP dan OAuth

Terakhir diperbaharui:

MOF adalah server MCP. Setelah diaktifkan, klien AI seperti Claude Desktop, Cursor, dan Dify dapat mengkueri data biaya yang boleh dilihat setiap pengguna. Aksesnya hanya-baca.

Aktifkan MCP

Administrator

  1. Buka Admin → Pengaturan → Akses MCP.
  2. Aktifkan “Izinkan koneksi MCP”.
  3. Klik “Periksa koneksi”. Layanan MCP seharusnya menampilkan “Terhubung”.

Container MCP sudah termasuk dalam template deployment; tidak ada lagi yang perlu diinstal. Jika pemeriksaan gagal, pastikan container mof-mcp berjalan dan versinya sama dengan MOF.

Siapkan OAuth

Administrator · diperlukan untuk Claude Desktop

Dengan OAuth, pengguna menempelkan satu alamat ke klien AI mereka dan masuk dengan akun MOF. Tanpa OAuth, mereka harus membuat token secara manual, dan Claude Desktop tidak dapat memakai token.

  1. Sajikan MOF melalui HTTPS publik. Claude terhubung dari servernya sendiri, jadi alamatnya harus dapat dijangkau dari internet.
  2. Tambahkan dua variabel ke service mof lalu buat ulang:
compose.yaml · mof.environment
MOF_PUBLIC_URL: "https://mof.example.com"
MOF_MCP_OAUTH_SECRET: "REPLACE_WITH_A_RANDOM_SECRET_AT_LEAST_32_CHARACTERS"
  1. Di Admin → Pengaturan → Akses MCP, klik “Periksa koneksi” lagi. Masuk OAuth seharusnya menampilkan “Dikonfigurasi”.

MOF_PUBLIC_URL adalah alamat yang dibuka pengguna, tanpa path. Secret minimal 32 karakter dan harus sama di setiap server MOF. “Dikonfigurasi” hanya berarti keduanya sudah diatur; proses masuk sungguhan pertama dari Claude yang memastikan callback publik berfungsi. Variabel lingkungan

Hubungkan Claude Desktop

Setiap pengguna

  1. Di MOF, buka Pengaturan → Koneksi MCP dan salin URL Server.
  2. Di Claude Desktop, buka Settings → Connectors → Add custom connector. Masukkan nama seperti MOF dan tempelkan alamatnya.
  3. Klik Connect, masuk dengan akun MOF Anda di browser, lalu setujui.
  4. Ajukan pertanyaan ke Claude, misalnya “Berapa pengeluaran kita bulan lalu, per cloud?”
Klien tanpa OAuth: gunakan token

Di Pengaturan → Koneksi MCP → Token manual, masukkan nama dan klik “Buat token”. Segera salin; token hanya ditampilkan sekali dan berlaku 90 hari. Kirim sebagai header permintaan:

Header
Authorization: Bearer YOUR_TOKEN

Cabut akses

Pengguna mencabut aplikasi dan token mereka sendiri di Pengaturan → Koneksi MCP, di bagian “Aplikasi terhubung” dan “Token saya”. Menonaktifkan “Izinkan koneksi MCP” di Admin memutus semua koneksi sekaligus.