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.
https://wbiztool.comhttps://mcp.wbiztool.com/mcpBody: MCP over Streamable HTTP
Apa yang boleh dilakukan oleh pembantu#
Pembantu hanya melihat alat yang dibenarkan oleh kunci (lihat skop):
| Alat | Skop yang diperlukan | Apa yang dilakukannya |
|---|---|---|
get_account | mana-mana | Ruang kerja anda, akses kunci, pelan anda dan baki mesej |
list_numbers, get_number | numbers | Nombor WhatsApp dan akaun Telegram anda, dan sama ada ia disambungkan |
list_messages, get_message | messages:read | Mesej yang telah anda hantar dan statusnya (dihantar, diterima, dibaca, gagal …) |
send_message, send_message_batch | messages:send | Hantar sekarang atau pada masa tertentu, kepada nombor telefon, kumpulan, kenalan atau @username Telegram – sentiasa selepas pratonton |
cancel_message | messages:send | Batalkan mesej yang masih menunggu |
list_reminders, get_reminder, create_reminder, update_reminder, delete_reminder | reminders | Peringatan berulang; mencipta peringatan, menyambungnya semula atau mengubah siapa menerima apa memerlukan pratonton |
list_media, get_media | media | Fail dalam Direktori media anda, untuk dihantar mengikut id |
list_number_checks, get_number_check, list_number_check_results, start_number_check | contacts | Semak 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#
Buka kad Kunci API v2
Dalam WbizTool, pergi ke Tetapan → Kunci API dan cari kad Kunci API v2.
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.
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.
Salin kunci
Kunci (
wbz_live_…) dipaparkan sekali sahaja. Simpan dalam pemboleh ubah persekitaran pada komputer anda, sepertiWBIZTOOL_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}"{
"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 arahan ini sekali (tambah
--scope projectuntuk berkongsinya dengan projek melalui.mcp.json; fail itu mengandungi${WBIZTOOL_API_KEY}, bukan kunci). - Cursor: letakkannya dalam
~/.cursor/mcp.json, atau.cursor/mcp.jsondalam 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 lihat | Sebabnya | Apa yang perlu dilakukan |
|---|---|---|
401 atau “missing API key” | Tiada kunci, kunci yang salah, atau kunci API v1 | Gunakan kunci API v2 (wbz_live_…) dalam pengepala Authorization: Bearer |
| “plan_required” | Ruang kerja tidak mempunyai pelan berbayar | Pilih pelan |
| “This API key is read-only” | Kunci itu baca sahaja | Cipta kunci tanpa Baca sahaja jika pembantu perlu menghantar |
| “missing_scope” | Kunci tidak mempunyai skop untuk alat itu | Tambah skop itu, atau cipta kunci baharu dengannya |
| Penghantaran sentiasa kembali sebagai pratonton | Pembantu tidak menghantar pengesahan | Setuju dengan pratonton, atau minta ia “hantar sekarang dengan token pengesahan” |
429 | Terlalu banyak permintaan untuk kunci ini | Tunggu tempoh yang dinyatakan dan cuba lagi |
