Langkau ke kandungan
WbizTool

Integrasi

Pelayan MCP: sambungkan pembantu AI

Pelayan MCP WbizTool membolehkan pembantu AI bekerja dengan ruang kerja anda. Anda boleh bertanya perkara seperti “mesej mana yang gagal hari ini, dan mengapa?”, “jeda peringatan sewa” atau “hantar waktu buka baharu kami kepada lima pelanggan ini”, dan ia menggunakan akaun WbizTool anda untuk melakukannya.

Pelayan ini menggunakan Model Context Protocol (MCP), yang difahami oleh Claude Code, Cursor, VS Code dan alat AI lain. Di sebalik tabir, setiap tindakan ialah panggilan ke API v2 yang dibuat dengan kunci API v2 anda sendiri, jadi kunci itulah yang menentukan apa yang boleh dilihat dan dilakukan oleh pembantu.

POSThttps://wbiztool.comhttps://mcp.wbiztool.com/mcp

Body: MCP over Streamable HTTP

Apa yang boleh dilakukan oleh pembantu#

Pembantu hanya melihat alat yang dibenarkan oleh kunci (lihat skop):

AlatSkop yang diperlukanApa yang dilakukannya
get_accountmana-manaRuang kerja anda, akses kunci, pelan anda dan baki mesej
list_numbers, get_numbernumbersNombor WhatsApp dan akaun Telegram anda, dan sama ada ia disambungkan
list_messages, get_messagemessages:readMesej yang telah anda hantar dan statusnya (dihantar, diterima, dibaca, gagal …)
send_message, send_message_batchmessages:sendHantar sekarang atau pada masa tertentu, kepada nombor telefon, kumpulan, kenalan atau @username Telegram – sentiasa selepas pratonton
cancel_messagemessages:sendBatalkan mesej yang masih menunggu
list_reminders, get_reminder, create_reminder, update_reminder, delete_reminderremindersPeringatan berulang; mencipta peringatan, menyambungnya semula atau mengubah siapa menerima apa memerlukan pratonton
list_media, get_mediamediaFail dalam Direktori media anda, untuk dihantar mengikut id
list_number_checks, get_number_check, list_number_check_results, start_number_checkcontactsSemak nombor mana yang ada di WhatsApp (sehingga 500 sekali gus)

Ia juga menawarkan tiga prompt sedia guna: ringkasan harian, mesej gagal dan draf pengumuman.

Ia tidak boleh menyambungkan nombor baharu (itu kekal dalam papan pemuka anda), memuat naik fail, mengurus webhook atau membaca peti masuk Unibox anda.

1. Cipta kunci untuk pembantu#

  1. Buka kad Kunci API v2

    Dalam WbizTool, pergi ke Tetapan → Kunci API dan cari kad Kunci API v2.

  2. Gunakan pratetap pembantu AI

    Klik Cipta kunci v2, kemudian Untuk pembantu AI. Ia mencipta kunci Baca sahaja yang boleh membaca mesej dan nombor serta tamat tempoh dalam 90 hari – cara yang selamat untuk bermula: pembantu boleh melihat, tetapi tidak boleh menghantar atau mengubah apa-apa.

  3. Benarkan penghantaran hanya jika anda mahu

    Jika pembantu perlu menghantar mesej atau mengurus peringatan, nyahtanda Baca sahaja dan tandakan Hantar mesej (dan Peringatan jika perlu). Anda juga boleh mengehadkan kunci kepada sebahagian nombor anda.

  4. Salin kunci

    Kunci (wbz_live_…) dipaparkan sekali sahaja. Simpan dalam pemboleh ubah persekitaran pada komputer anda, seperti WBIZTOOL_API_KEY – jangan sekali-kali tampalkannya ke dalam fail yang anda kongsi atau commit.

export WBIZTOOL_API_KEY=wbz_live_…

2. Tambah pelayan pada alat AI anda#

claude mcp add --transport http wbiztool https://mcp.wbiztool.com/mcp \
  --header "Authorization: Bearer ${WBIZTOOL_API_KEY}"
  • Claude Code: jalankan arahan ini sekali (tambah --scope project untuk berkongsinya dengan projek melalui .mcp.json; fail itu mengandungi ${WBIZTOOL_API_KEY}, bukan kunci).
  • Cursor: letakkannya dalam ~/.cursor/mcp.json, atau .cursor/mcp.json dalam projek.
  • VS Code: letakkannya dalam .vscode/mcp.json. VS Code meminta kunci sekali dan menyimpannya dalam storan rahsianya.

Kemudian tanya pembantu sesuatu seperti “Apakah akaun WbizTool saya?” – ia sepatutnya menjawab dengan nama dan pelan ruang kerja anda.

3. Cara penghantaran kekal selamat#

  • Setiap penghantaran dipratonton dahulu. Apabila anda meminta mesej, pembantu terlebih dahulu mendapat pratonton daripada WbizTool – dari nombor mana ia dihantar, kepada siapa, teks yang tepat, sebarang fail, dan bila – dan belum ada apa-apa yang dihantar. Ia diarahkan untuk menunjukkan pratonton itu kepada anda dan menunggu persetujuan anda. Hanya selepas itu ia menghantar, tepat seperti yang anda lihat.
  • Cubaan semula tidak pernah menghantar dua kali. Jika pembantu mengulangi penghantaran yang telah disahkan (contohnya selepas tamat masa), WbizTool menjawab dengan mesej yang telah dihantarnya.
  • Kunci ialah had mutlak. Kunci baca sahaja tidak boleh menghantar langsung. Kunci tanpa Hantar mesej tidak pernah melihat alat penghantaran pun, dan kunci yang dihadkan kepada sebahagian nombor tidak boleh menggunakan nombor lain. Had WbizTool sendiri juga terpakai: 60 permintaan seminit bagi setiap kunci dan paling banyak 1,000 mesej sehari bagi setiap nombor.
  • Teks daripada orang lain ditandakan sebagai data. Mesej, nama dan fail yang datang dari luar sampai kepada pembantu dengan tanda tidak dipercayai, dan ia diarahkan supaya tidak sekali-kali mengikut arahan di dalamnya.
  • Tiada rahsia dalam jawapan. Kod QR dan kod pautan tidak pernah dipaparkan, dan senarai tidak menyertakan pautan fail.
  • Tarik balik pada bila-bila masa. Menarik balik kunci di Tetapan → Kunci API menghentikan pembantu serta-merta.

Privasi#

Apabila anda menyambungkan pembantu, apa yang dibacanya daripada WbizTool (mesej, nama dan nombor yang anda benarkan kunci melihatnya) dihantar kepada penyedia pembantu itu – contohnya Anthropic untuk Claude, atau OpenAI untuk ChatGPT – dan dikendalikan di bawah terma mereka. Pelayan MCP WbizTool sendiri tidak menyimpan apa-apa: ia menghantar setiap permintaan ke API v2 dan merekodkan alat mana yang digunakan, tidak pernah teks mesej atau kunci anda. Berikan kunci hanya akses yang diperlukan oleh pembantu.

Penyelesaian masalah#

Apa yang anda lihatSebabnyaApa yang perlu dilakukan
401 atau “missing API key”Tiada kunci, kunci yang salah, atau kunci API v1Gunakan kunci API v2 (wbz_live_…) dalam pengepala Authorization: Bearer
“plan_required”Ruang kerja tidak mempunyai pelan berbayarPilih pelan
“This API key is read-only”Kunci itu baca sahajaCipta kunci tanpa Baca sahaja jika pembantu perlu menghantar
“missing_scope”Kunci tidak mempunyai skop untuk alat ituTambah skop itu, atau cipta kunci baharu dengannya
Penghantaran sentiasa kembali sebagai pratontonPembantu tidak menghantar pengesahanSetuju dengan pratonton, atau minta ia “hantar sekarang dengan token pengesahan”
429Terlalu banyak permintaan untuk kunci iniTunggu tempoh yang dinyatakan dan cuba lagi

Berkaitan#