Sendveo pour les agents IA

Sendveo parle le Model Context Protocol (MCP). Ajoutez-le à Claude, Cursor, ChatGPT ou tout agent compatible MCP, puis demandez en langage naturel : liste mes numéros, connecte celui-ci, réponds à cette conversation. L'agent appelle Sendveo pour vous.

De quoi s'agit-il

Le serveur MCP Sendveo est un petit pont entre votre assistant IA et votre compte Sendveo. Il expose les mêmes actions que l'API et le tableau de bord, sous forme d'outils que l'assistant peut appeler. Tout s'exécute sous votre propre compte : vous vous connectez avec votre e-mail et votre mot de passe Sendveo ou, pour un script ou un outil en ligne de commande, vous utilisez une clé API créée dans votre tableau de bord.

Il y a deux façons de se connecter, et toutes deux exposent les mêmes outils. Hébergée : vous collez une URL dans l'assistant et vous vous connectez, sans rien installer ni copier de clé. Locale : l'assistant lance une petite commande Sendveo sur votre machine avec une clé API, qui ne la quitte jamais.

Ce que vous pouvez faire

Un outil par action, regroupés comme dans le guide : numéros, messages, conversations, contacts, groupes, santé et profil, étiquettes, webhook, facturation. Les fonctions opérateur ne sont pas exposées : le serveur est limité au compte auquel appartient la connexion.

connect_number, refresh_qr et reconnect_number acceptent un paramètre optionnel method. qr (par défaut) renvoie un QR à scanner depuis WhatsApp, dans Appareils connectés, Connecter un appareil. code renvoie un code à 8 caractères à saisir dans Connecter avec un numéro de téléphone : utilisez-le quand vous êtes sur le téléphone qui porte le numéro et ne pouvez pas scanner l'écran. Les deux expirent et tournent, demandez-en un nouveau s'il ne fonctionne plus.

Option A : collez l'URL et connectez-vous (recommandé)

Ajoutez Sendveo à votre assistant comme serveur MCP distant. Une seule valeur suffit : l'URL MCP Sendveo. Rien à installer et aucune clé à coller : votre assistant ouvre une page Sendveo où vous vous connectez et approuvez la connexion.

https://mcp.sendveo.com/mcp

Dans Claude

1. Ouvrez Réglages, puis Connecteurs, et choisissez Ajouter un connecteur personnalisé.
2. Collez l'URL MCP Sendveo ci-dessus et enregistrez. Votre assistant trouve le reste tout seul.
3. Une page Sendveo s'ouvre dans votre navigateur. Connectez-vous avec l'e-mail et le mot de passe que vous utilisez pour le tableau de bord.
4. Lisez ce que l'assistant demande et l'adresse vers laquelle il vous renverra, puis appuyez sur Autoriser. Appuyez sur Refuser et rien n'est accordé.

L'assistant reçoit une connexion liée à votre compte, portant les autorisations affichées sur cet écran d'approbation. Elle expire au bout d'une heure et se renouvelle discrètement tant que la connexion est utilisée. Vous ne collez jamais de clé dans l'assistant, et rien de ce que vous approuvez n'atteint un autre compte, la console opérateur ou votre mot de passe.

Pour vous déconnecter, supprimez le connecteur dans votre assistant. Une connexion supprimée côté Sendveo cesse de fonctionner immédiatement et définitivement.

Si aucune page de connexion ne s'ouvre, vérifiez que l'URL se termine par /mcp. Si votre assistant signale qu'il n'a pas pu joindre le service de connexion, c'est que Sendveo est injoignable depuis votre réseau : même vérification que pour le chargement du tableau de bord.

ChatGPT, Cursor et les autres assistants compatibles MCP utilisent la même URL dans leurs propres réglages de serveur MCP distant, et vous connectent de la même façon.

Option B : local (sur votre machine)

Si vous préférez garder la clé sur votre propre machine, exécutez le serveur MCP Sendveo en local. Il nécessite Node.js 22 ou plus récent. L'assistant le lance avec npx @sendveo/mcp et lui transmet votre clé via la variable d'environnement SENDVEO_API_KEY.

Ajoutez le bloc ci-dessous à la configuration MCP de votre assistant. Dans Claude Desktop, c'est claude_desktop_config.json ; dans Claude Code, lancez claude mcp add ou modifiez .mcp.json ; Cursor utilise .cursor/mcp.json. Le bloc est identique partout.

{
  "mcpServers": {
    "sendveo": {
      "command": "npx",
      "args": ["-y", "@sendveo/mcp"],
      "env": {
        "SENDVEO_API_KEY": "YOUR_SENDVEO_API_KEY"
      }
    }
  }
}

Remplacez le texte de substitution par votre clé, redémarrez l'assistant et demandez-lui de lister vos numéros Sendveo. Si le serveur s'arrête immédiatement, vérifiez que SENDVEO_API_KEY est bien définie.

Avec une clé API plutôt qu'une connexion

Se connecter est la façon normale d'utiliser l'URL hébergée. Si votre outil ne le permet pas, un script, un appel curl ou un client qui ne laisse définir que des en-têtes, la même URL accepte aussi une clé API Sendveo envoyée en jeton bearer. Chaque requête est authentifiée sur cette seule clé et reste limitée au compte de cette clé.

https://mcp.sendveo.com/mcp

Authorization: Bearer YOUR_SENDVEO_API_KEY

Portées

Chaque connexion porte des portées, et chaque outil en exige une. Quand vous vous connectez, l'écran d'approbation les liste en langage clair avant que vous appuyiez sur Autoriser. Une nouvelle clé API reçoit toutes les portées par défaut, sauf le raccourci lecture seule : elle fonctionne donc d'emblée avec tous les outils. Si un outil signale une portée manquante, ajustez la clé dans Clés API de votre tableau de bord, ou reconnectez-vous et approuvez la permission manquante.

messages:manage, chats:read, chats:manage, contacts:read, groups:read et groups:manage ont été ajoutées le 16 septembre 2026. Une clé API créée avant cette date n'en possède aucune et ne peut pas les recevoir : créez une nouvelle clé dans votre tableau de bord, ou reconnectez l'assistant et approuvez les permissions. Tout le reste continue de fonctionner avec l'ancienne clé.

La facturation est en lecture seule et couverte par numbers:read : il n'existe pas de portée facturation distincte.

Sécurité

• Se connecter ne donne jamais votre mot de passe à l'assistant, et le serveur hébergé ne stocke aucune clé API. Chaque requête est authentifiée avec l'identifiant qu'elle porte, et le serveur n'en conserve aucun.
• Chaque requête est isolée au compte derrière la connexion. Les fonctions opérateur ne sont pas accessibles via MCP.
• Des limites de débit s'appliquent, par clé et par source. Une réponse 429 signifie ralentir et réessayer un peu plus tard.
• Traitez la clé comme un mot de passe. Préférez une clé limitée à ce dont l'assistant a besoin, et révoquez-la depuis le tableau de bord en cas de fuite.

Dépannage