Intégrations
Serveur MCP : connecter un assistant IA
Le serveur MCP de WbizTool permet à un assistant IA de travailler avec votre espace de travail. Vous pouvez lui demander par exemple « quels messages ont échoué aujourd'hui, et pourquoi ? », « mets en pause le rappel du loyer » ou « envoie nos nouveaux horaires d'ouverture à ces cinq clients », et il utilise votre compte WbizTool pour le faire.
Il parle le Model Context Protocol (MCP), que comprennent Claude Code, Cursor, VS Code et d'autres outils d'IA. En coulisses, chaque action est un appel à l'API v2 fait avec votre propre clé API v2 : c'est donc la clé qui décide de ce que l'assistant peut voir et faire.
https://wbiztool.comhttps://mcp.wbiztool.com/mcpCorps: MCP over Streamable HTTP
Ce qu'un assistant peut faire#
L'assistant ne voit que les outils que la clé autorise (voir les scopes) :
| Outils | Scope requis | Ce qu'ils font |
|---|---|---|
get_account | n'importe lequel | Votre espace de travail, l'accès de la clé, votre forfait et les messages restants |
list_numbers, get_number | numbers | Vos numéros WhatsApp et vos comptes Telegram, et s'ils sont connectés |
list_messages, get_message | messages:read | Les messages que vous avez envoyés et leur statut (envoyé, remis, lu, échec …) |
send_message, send_message_batch | messages:send | Envoyer maintenant ou à une heure donnée, à un téléphone, un groupe, un contact ou un @username Telegram – toujours après un aperçu |
cancel_message | messages:send | Annuler un message encore en attente |
list_reminders, get_reminder, create_reminder, update_reminder, delete_reminder | reminders | Rappels récurrents ; en créer un, en reprendre un ou changer qui reçoit quoi passe par un aperçu |
list_media, get_media | media | Les fichiers de votre Répertoire média, à envoyer par id |
list_number_checks, get_number_check, list_number_check_results, start_number_check | contacts | Vérifier quels numéros sont sur WhatsApp (jusqu'à 500 à la fois) |
Il propose aussi trois prompts prêts à l'emploi : daily summary (résumé du jour), failed messages (messages en échec) et draft an announcement (rédiger une annonce).
Il ne peut pas connecter un nouveau numéro (cela reste dans votre tableau de bord), téléverser des fichiers, gérer des webhooks ni lire votre boîte de réception Unibox.
1. Créer une clé pour l'assistant#
Ouvrez la carte Clés API v2
Dans WbizTool, allez dans Paramètres → Clés API et repérez la carte Clés API v2.
Utilisez le préréglage pour assistant IA
Cliquez sur Créer une clé v2, puis sur Pour un assistant IA. Cela crée une clé en Lecture seule qui peut lire les messages et les numéros et expire dans 90 jours – une façon sûre de commencer : l'assistant peut regarder, mais ne peut rien envoyer ni modifier.
N'autorisez l'envoi que si vous le voulez
Si l'assistant doit envoyer des messages ou gérer des rappels, décochez Lecture seule et cochez Envoyer des messages (et Rappels si besoin). Vous pouvez aussi limiter la clé à certains de vos numéros.
Copiez la clé
La clé (
wbz_live_…) n'est affichée qu'une fois. Conservez-la dans une variable d'environnement sur votre ordinateur, par exempleWBIZTOOL_API_KEY– ne la collez jamais dans un fichier que vous partagez ou que vous commitez.
export WBIZTOOL_API_KEY=wbz_live_…
2. Ajouter le serveur à votre outil d'IA#
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 : exécutez la commande une fois (ajoutez
--scope projectpour la partager avec un projet via.mcp.json; le fichier contient${WBIZTOOL_API_KEY}, pas la clé). - Cursor : placez-la dans
~/.cursor/mcp.json, ou dans.cursor/mcp.jsonau sein d'un projet. - VS Code : placez-la dans
.vscode/mcp.json. VS Code demande la clé une fois et la conserve dans son stockage de secrets.
Demandez ensuite à l'assistant quelque chose comme « Quel est mon compte WbizTool ? » – il devrait répondre avec le nom et le forfait de votre espace de travail.
3. Comment les envois restent sûrs#
- Chaque envoi passe d'abord par un aperçu. Quand vous demandez un message, l'assistant reçoit d'abord un aperçu de WbizTool – depuis quel numéro il part, à qui, le texte exact, le fichier éventuel, à quel moment – et rien n'a encore été envoyé. Il a pour consigne de vous montrer cet aperçu et d'attendre votre accord. Ce n'est qu'ensuite qu'il envoie, exactement ce que vous avez vu.
- Une nouvelle tentative n'envoie jamais deux fois. Si l'assistant répète un envoi confirmé (par exemple après un délai dépassé), WbizTool répond avec le message déjà envoyé.
- La clé est la limite absolue. Une clé en lecture seule ne peut pas envoyer du tout. Une clé sans Envoyer des messages ne voit même pas les outils d'envoi, et une clé limitée à certains numéros ne peut pas utiliser les autres. Les limites de WbizTool s'appliquent aussi : 60 requêtes par minute et par clé, et au plus 1 000 messages par jour et par numéro.
- Le texte venant d'autres personnes est marqué comme des données. Les messages, noms et fichiers venus de l'extérieur parviennent à l'assistant marqués comme non fiables, et il a pour consigne de ne jamais suivre les instructions qu'ils contiennent.
- Aucun secret dans les réponses. Les codes QR et les codes d'association ne sont jamais affichés, et les listes n'incluent pas de liens vers les fichiers.
- Révocable à tout moment. Révoquer la clé dans Paramètres → Clés API arrête l'assistant immédiatement.
Confidentialité#
Quand vous connectez un assistant, ce qu'il lit dans WbizTool (les messages, noms et numéros que vous laissez voir à la clé) est envoyé au fournisseur de cet assistant – par exemple Anthropic pour Claude, ou OpenAI pour ChatGPT – et traité selon ses conditions. Le serveur MCP de WbizTool lui-même ne conserve rien : il transmet chaque requête à l'API v2 et enregistre quel outil a été utilisé, jamais le texte des messages ni votre clé. Ne donnez à la clé que l'accès dont l'assistant a besoin.
Dépannage#
| Ce que vous voyez | Pourquoi | Que faire |
|---|---|---|
401 ou « missing API key » | Pas de clé, une mauvaise clé, ou une clé API v1 | Utilisez une clé API v2 (wbz_live_…) dans l'en-tête Authorization: Bearer |
| « plan_required » | L'espace de travail n'a pas de forfait payant | Choisissez un forfait |
| « This API key is read-only » | La clé est en lecture seule | Créez une clé sans Lecture seule si l'assistant doit envoyer |
| « missing_scope » | La clé n'a pas le scope de cet outil | Ajoutez le scope, ou créez une nouvelle clé qui l'a |
| Les envois reviennent toujours sous forme d'aperçu | L'assistant n'a pas envoyé la confirmation | Dites oui à l'aperçu, ou demandez-lui de « l'envoyer maintenant avec le jeton de confirmation » |
429 | Trop de requêtes pour cette clé | Attendez le temps indiqué et réessayez |
