Menghubungkan Ringhum ke Claude dan alat AI lainnya (MCP)

Ringhum memiliki server MCP. MCP (Model Context Protocol) adalah cara standar bagi aplikasi AI untuk menggunakan alat dari luar. Setelah Anda menghubungkan Ringhum ke aplikasi AI seperti Claude atau ChatGPT, Anda dapat menanyakan hal-hal tentang workspace Anda dalam bahasa sehari-hari. Misalnya: "Ringkas panggilan yang terlewat kemarin", "Penelepon mana yang meminta panggilan balik minggu ini?" atau "Tambahkan jam operasional baru kami ke FAQ". Aplikasi AI bekerja lewat aturan dan izin yang sama seperti API Ringhum.

Apa yang Anda butuhkan

• URL server: https://ringhum.com/mcp. Juga ditampilkan di kartu Server MCP pada halaman Developer, dengan tombol Salin.
• Aplikasi AI yang mendukung server MCP jarak jauh, seperti Claude, ChatGPT, Claude Code, Cursor, Windsurf, atau VS Code.
• Peran Pemilik atau Admin di workspace. Hanya pemilik dan admin yang dapat menghubungkan aplikasi atau membuat kunci API.

Ada dua cara menghubungkan. Masuk (sign in) adalah cara termudah dan cocok untuk aplikasi chat seperti Claude dan ChatGPT. Kunci API cocok untuk alat developer yang menerima URL dan header.

Akses hanya-baca atau baca-dan-ubah

Anda menentukan seberapa banyak yang boleh dilakukan aplikasi AI tersebut.

Dengan akses hanya-baca, alat yang mengubah sesuatu sama sekali tidak ditawarkan kepada aplikasi tersebut.

Penting: Dengan akses ubah, aplikasi AI dapat mengirim pesan sungguhan dan melakukan panggilan sungguhan kepada pelanggan Anda. Ringhum menandai alat-alat ini sebagai menjangkau ke luar workspace Anda, dan penghapusan sebagai destruktif, sehingga sebagian besar aplikasi AI meminta persetujuan Anda sebelum menjalankannya. Baca apa yang akan dilakukan aplikasi tersebut sebelum Anda menyetujuinya.

Menghubungkan Claude dengan masuk (sign in)

1. Di Claude (di web, desktop, atau seluler), buka Settings → Connectors dan pilih Add custom connector.
2. Tempelkan https://ringhum.com/mcp sebagai URL dan simpan.
3. Klik Connect. Sebuah halaman Ringhum terbuka. Masuk jika diminta.
4. Di halaman Connect, pilih Workspace yang boleh digunakan aplikasi tersebut.
5. Di bagian Apa yang boleh dilakukannya, pilih Mencari informasi atau Mencari informasi dan membuat perubahan.
6. Klik Izinkan. Anda akan dikembalikan ke Claude.

Aplikasi tersebut tidak pernah melihat kata sandi Anda. Nama menu pasti di Claude dapat berubah seiring waktu; cari konektor atau integrasi di pengaturannya.

ChatGPT: tambahkan URL sebagai konektor kustom (server MCP) di Settings → Apps & Connectors, lalu klik Connect dan ikuti langkah 3 sampai 6.

Claude Code: jalankan perintah di bawah, lalu jalankan /mcp dan pilih Authenticate.

claude mcp add --transport http ringhum https://ringhum.com/mcp

Setelah Anda mengizinkan akses, koneksi memperbarui dirinya sendiri selama Anda terus menggunakannya. Jika aplikasi tersebut tidak digunakan selama 90 hari, Anda perlu menghubungkannya lagi.

Menghubungkan dengan kunci API

Gunakan ini untuk alat yang memungkinkan Anda mengatur header permintaan, atau saat Anda tidak ingin masuk.

1. Di Developer, buat kunci API. Centang hanya read untuk koneksi hanya-baca, atau read dan write untuk mengizinkan perubahan. Lihat Kunci API dan cakupan akses.
2. Tambahkan server tersebut ke aplikasi Anda dengan kunci di header Authorization.

Claude Code:

claude mcp add --transport http ringhum https://ringhum.com/mcp \
  --header "Authorization: Bearer ck_live_…"

Cursor (~/.cursor/mcp.json), Windsurf, dan Claude Desktop:

{
  "mcpServers": {
    "ringhum": {
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "ringhum": {
      "type": "http",
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

Aplikasi yang hanya dapat menjalankan server lokal dapat terhubung lewat npx mcp-remote https://ringhum.com/mcp --header "Authorization: Bearer ck_live_…".

Apa yang dicakup alat-alat ini

Setiap operasi dalam API Ringhum tersedia sebagai alat: akun dan penggunaan Anda, asisten, nomor telepon, panggilan dan transkrip, kontak, janji temu dan ketersediaan, pesanan dan produk, reservasi kamar, kotak masuk, pesan teks dan WhatsApp, kampanye, webhook, profil perusahaan, layanan, FAQ dan basis pengetahuan, pertanyaan yang tidak terjawab, tautan pembayaran, permintaan ulasan, pendapatan, dan perlindungan spam. Rekaman panggilan adalah satu-satunya pengecualian: tidak tersedia sebagai alat.

Setiap alat menjalankan permintaan API yang cocok, sehingga batas paket, validasi, dan batas laju permintaan yang sama berlaku. Panggilan alat dihitung dalam batas API sebesar 120 permintaan per menit. Daftar lengkap alat ada di bagian MCP pada referensi API di /docs.

Melihat dan memutuskan koneksi aplikasi

Aplikasi yang Anda hubungkan dengan masuk tercantum di Developer di bawah Aplikasi AI Terhubung, beserta siapa yang menghubungkannya, Akses-nya (Hanya baca atau Baca dan ubah), dan kapan terakhir digunakan.

Untuk menghapus sebuah aplikasi, klik Putuskan koneksi dan konfirmasi. Aplikasi tersebut langsung kehilangan akses dan harus disetujui lagi. Untuk mengubah akses sebuah aplikasi, putuskan koneksinya dan hubungkan lagi dengan pilihan yang lain.

Untuk koneksi yang dibuat dengan kunci API, cabut kuncinya di Kunci API.

Pemecahan masalah

"Only owners and admins of a workspace can connect apps." Minta pemilik workspace untuk menghubungkan aplikasi tersebut, atau untuk menjadikan Anda Admin. Lihat Mengundang tim Anda.

"The sign-in request expired. Start connecting again from your AI app." Halaman persetujuan terbuka terlalu lama. Mulai lagi dari aplikasi AI Anda.

Aplikasi tersebut mengatakan tidak diotorisasi, atau meminta Anda masuk lagi. Aplikasi tersebut terputus, kuncinya dicabut, atau Anda bukan lagi anggota workspace tersebut. Hubungkan lagi.

Aplikasi tersebut tidak dapat membuat perubahan. Aplikasi tersebut terhubung dengan akses hanya-baca, atau kunci API-nya tidak memiliki cakupan write.

Aplikasi tersebut melihat workspace yang salah. Minta aplikasi tersebut memanggil who_am_i untuk memeriksa. Setiap koneksi menggunakan satu workspace. Putuskan koneksinya dan hubungkan lagi untuk memilih yang lain.