Server MCP: hubungkan asisten AI

Server MCP WbizTool memungkinkan asisten AI bekerja dengan workspace Anda. Anda dapat menanyakan hal seperti “pesan mana yang gagal hari ini, dan mengapa?”, “jeda pengingat sewa” atau “kirim jam buka baru kami ke lima pelanggan ini”, dan asisten akan memakai akun WbizTool Anda untuk melakukannya.

Server ini menggunakan Model Context Protocol (MCP), yang dipahami oleh Claude Code, Cursor, VS Code, dan alat AI lainnya. Di balik layar, setiap tindakan adalah panggilan ke API v2 yang dibuat dengan kunci API v2 Anda sendiri, sehingga kunci itulah yang menentukan apa yang boleh dilihat dan dilakukan asisten.

Apa yang dapat dilakukan asisten#

Asisten hanya melihat alat yang diizinkan oleh kunci (lihat scope):

Asisten juga menyediakan tiga prompt siap pakai: ringkasan harian, pesan gagal, dan draf pengumuman.

Asisten tidak dapat menghubungkan nomor baru (itu tetap dilakukan di dashboard Anda), mengunggah file, mengelola webhook, atau membaca kotak masuk Unibox Anda.

1. Buat kunci untuk asisten#

1. Buka kartu Kunci API v2

   Di WbizTool, buka Pengaturan → Kunci API dan cari kartu Kunci API v2.

2. Gunakan preset asisten AI

   Klik Buat kunci v2, lalu Untuk asisten AI. Preset ini membuat kunci Hanya baca yang dapat membaca pesan dan nomor serta kedaluwarsa dalam 90 hari – cara aman untuk memulai: asisten dapat melihat, tetapi tidak dapat mengirim atau mengubah apa pun.

3. Izinkan pengiriman hanya jika Anda menginginkannya

   Jika asisten perlu mengirim pesan atau mengelola pengingat, hapus centang Hanya baca lalu centang Kirim pesan (dan Pengingat jika perlu). Anda juga dapat membatasi kunci ke sebagian nomor Anda.

4. Salin kuncinya

   Kunci (wbz_live_…) hanya ditampilkan sekali. Simpan di environment variable di komputer Anda, misalnya WBIZTOOL_API_KEY – jangan pernah menempelkannya ke file yang Anda bagikan atau commit.

export WBIZTOOL_API_KEY=wbz_live_…

2. Tambahkan server ke alat AI Anda#

claude mcp add --transport http wbiztool https://mcp.wbiztool.com/mcp \
  --header "Authorization: Bearer ${WBIZTOOL_API_KEY}"

{
  "mcpServers": {
    "wbiztool": {
      "type": "http",
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${WBIZTOOL_API_KEY}" }
    }
  }
}

{
  "mcpServers": {
    "wbiztool": {
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${env:WBIZTOOL_API_KEY}" }
    }
  }
}

{
  "inputs": [
    { "type": "promptString", "id": "wbiztool-key", "description": "WbizTool API v2 key (wbz_live_…)", "password": true }
  ],
  "servers": {
    "wbiztool": {
      "type": "http",
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${input:wbiztool-key}" }
    }
  }
}

• Claude Code: jalankan perintah ini sekali (tambahkan --scope project untuk membagikannya dengan sebuah proyek melalui .mcp.json; file itu berisi ${WBIZTOOL_API_KEY}, bukan kuncinya).
• Cursor: letakkan di ~/.cursor/mcp.json, atau di .cursor/mcp.json dalam sebuah proyek.
• VS Code: letakkan di .vscode/mcp.json. VS Code meminta kunci sekali dan menyimpannya di penyimpanan rahasianya.

Lalu tanyakan sesuatu kepada asisten, misalnya “Apa akun WbizTool saya?” – asisten seharusnya menjawab dengan nama dan paket workspace Anda.

3. Cara pengiriman tetap aman#

• Setiap pengiriman dipratinjau terlebih dahulu. Saat Anda meminta sebuah pesan, asisten lebih dulu mendapat pratinjau dari WbizTool – dari nomor mana pesan dikirim, kepada siapa, teks persisnya, file jika ada, dan kapan – dan belum ada yang dikirim. Asisten diminta menunjukkan pratinjau itu kepada Anda dan menunggu persetujuan Anda. Baru setelah itu asisten mengirim, persis seperti yang Anda lihat.
• Percobaan ulang tidak pernah mengirim dua kali. Jika asisten mengulangi pengiriman yang sudah dikonfirmasi (misalnya setelah timeout), WbizTool menjawab dengan pesan yang sudah dikirimnya.
• Kunci adalah batas mutlaknya. Kunci hanya baca sama sekali tidak dapat mengirim. Kunci tanpa Kirim pesan bahkan tidak pernah melihat alat pengiriman, dan kunci yang dibatasi ke sebagian nomor tidak dapat memakai nomor lainnya. Batas WbizTool sendiri juga berlaku: 60 request per menit per kunci dan paling banyak 1.000 pesan per hari per nomor.
• Teks dari orang lain ditandai sebagai data. Pesan, nama, dan file yang berasal dari luar sampai ke asisten dengan tanda tidak tepercaya, dan asisten diminta untuk tidak pernah mengikuti instruksi di dalamnya.
• Tidak ada rahasia dalam jawaban. Kode QR dan kode penautan tidak pernah ditampilkan, dan daftar tidak menyertakan tautan file.
• Cabut kapan saja. Mencabut kunci di Pengaturan → Kunci API langsung menghentikan asisten.

Privasi#

Saat Anda menghubungkan asisten, apa yang dibacanya dari WbizTool (pesan, nama, dan nomor yang Anda izinkan untuk dilihat oleh kunci) dikirim ke penyedia asisten tersebut – misalnya Anthropic untuk Claude, atau OpenAI untuk ChatGPT – dan ditangani sesuai ketentuan mereka. Server MCP WbizTool sendiri tidak menyimpan apa pun: server ini meneruskan setiap request ke API v2 dan mencatat alat mana yang digunakan, tidak pernah teks pesan atau kunci Anda. Berikan kunci hanya akses yang dibutuhkan asisten.

Pemecahan masalah#

Terkait#

• Ikhtisar API v2
• Kunci API
• Pesan API v2
• Aplikasi & integrasi