SimplyBoost MCP

npx add-mcp 'https://get-api.simplyboost.io/api/v1/mcp'

Ce que c’est

Le serveur MCP se trouve à https://get-api.simplyboost.io/api/v1/mcp. Il utilise le transport HTTP Streamable et le même jeton d’API que l’API REST (Authorization: Bearer sb_live_…), les mêmes forfaits (Growth, Pro et Enterprise), les mêmes autorisations et les mêmes limites. Chaque outil fait ce que fait le point de terminaison REST correspondant et nécessite la même portée ; l’assistant voit un outil qu’il ne peut pas utiliser comme un refus explicite, et non comme une erreur.

Il est sans état : chaque appel correspond à une requête et une réponse, sans session à maintenir, ce qui vous permet de vous connecter depuis n’importe quelle machine. Le serveur ne lance jamais de flux de son propre chef.

Connecter un client

Deux façons de procéder. Se connecter (OAuth) : ajoutez l’adresse du serveur et, lorsque le client vous le demande, approuvez la connexion dans un onglet SimplyBoost en tant que propriétaire d’équipe, en choisissant l’équipe, les autorisations et les chatbots. C’est ainsi que les connecteurs claude.ai et ChatGPT, Cursor, Codex et Claude Code se connectent, sans rien à coller. Un jeton : pour un client que vous configurez manuellement ou un script que vous avez créé, créez un jeton dans Settings → API avec uniquement les autorisations dont l’assistant a besoin, puis envoyez-le dans un en-tête.

Claude Code (connectez-vous lorsqu’il vous le demande)

claude mcp add --transport http simplyboost https://get-api.simplyboost.io/api/v1/mcp

Codex

codex mcp add simplyboost --url https://get-api.simplyboost.io/api/v1/mcp
codex mcp login simplyboost

Cursor, Windsurf, VS Code et les autres clients avec un mcp.json (connectez-vous lorsqu’on vous le demande)

{
  "mcpServers": {
    "simplyboost": { "url": "https://get-api.simplyboost.io/api/v1/mcp" }
  }
}

Même configuration, avec un jeton au lieu de se connecter

{
  "mcpServers": {
    "simplyboost": {
      "url": "https://get-api.simplyboost.io/api/v1/mcp",
      "headers": { "Authorization": "Bearer sb_live_…" }
    }
  }
}

Une connexion établie en se connectant dure 90 jours, n’accorde que les autorisations que le propriétaire a cochées (la suppression est désactivée, sauf si elle est cochée) et figure dans Settings → API → Connected apps, où le propriétaire peut la déconnecter à tout moment. Seul un propriétaire d’équipe peut approuver une connexion, comme pour la création d’un jeton. Le nom de l’application affiché sur l’écran d’approbation est celui qu’elle a déclaré ; SimplyBoost ne le vérifie pas.

Un jeton dans la configuration d’un client est un mot de passe donnant accès à votre compte. Conservez-le sur votre propre ordinateur, définissez-lui une date d’expiration et renouvelez-le si le fichier de configuration est partagé. Se connecter évite ce problème : aucun secret n’est écrit dans un fichier.

Pour les développeurs de clients : le serveur suit la spécification d’autorisation MCP. Une requête sans identifiants renvoie 401 avec un en-tête WWW-Authenticate indiquant les métadonnées de la ressource protégée (https://get-api.simplyboost.io/.well-known/oauth-protected-resource/api/v1/mcp), qui indiquent le serveur d’autorisation (https://get-api.simplyboost.io/.well-known/oauth-authorization-server). Les clients s’enregistrent eux-mêmes (enregistrement dynamique des clients), utilisent le flux de code d’autorisation avec PKCE (S256 uniquement), peuvent indiquer la ressource et obtiennent des jetons d’actualisation renouvelés. Les jetons d’accès sont valides une heure et ne fonctionnent que sur le point de terminaison MCP ; les points de terminaison REST nécessitent des jetons d’API.

Les outils

Les arguments et les résultats utilisent les mêmes noms que l’API REST (chatbotId, threadId, champs camelCase) ; les pages des points de terminaison décrivent donc les deux. Commencez par list_chatbots pour trouver l’identifiant d’un chatbot.

Outil	Nécessite	Fonction
get_account	rien	Le compte, le forfait et les autorisations propres au jeton.
get_usage	account:read	Les messages utilisés pendant cette période de facturation.
list_chatbots, get_chatbot	chatbots:read	Les chatbots que le jeton peut utiliser.
send_message	conversations:write	Interroger un chatbot comme le ferait un visiteur ; compte dans le quota de messages du forfait. Transmettez threadId pour continuer.
list_conversations, get_conversation, list_messages	conversations:read	Les conversations sur tous les canaux et leurs messages.
take_over_conversation, reply_to_conversation, hand_back_to_chatbot, resolve_conversation	conversations:write	Gérer une conversation comme une personne : la prendre en charge, répondre, la rendre, la résoudre ou la rouvrir.
list_leads, get_lead	leads:read	Les prospects recueillis par un chatbot.
update_lead	leads:write	Modifier les informations d’un prospect ou le marquer comme converti.
delete_lead	leads:delete	Supprimer un prospect.
list_knowledge_sources, get_knowledge_source	knowledge:read	Ce que sait un chatbot, avec le statut et le texte de chaque source.
add_text_knowledge, add_website_knowledge, update_knowledge_source, refresh_knowledge_source	knowledge:write	Apprendre au chatbot du texte ou le contenu d’un site web, modifier une source, relire un site web.
delete_knowledge_source	knowledge:delete	Supprimer une source.

Les téléversements de fichiers et les webhooks ne sont pas proposés comme outils ; utilisez les points de terminaison REST pour ces opérations. Les outils de suppression sont signalés comme destructifs, et les instructions du serveur indiquent à l’assistant de vous demander confirmation au préalable.

Erreurs et limites

Un appel d’outil refusé (autorisation manquante, chatbot inaccessible au jeton, argument invalide, limite du forfait) renvoie un résultat d’outil marqué comme erreur, avec le même code et le même message que ceux renvoyés par l’API REST, afin que l’assistant puisse vous indiquer ce qu’il faut modifier. Un jeton manquant ou invalide renvoie 401, un forfait sans accès à l’API ou un abonnement expiré renvoie 403, et la limite de débit par jeton renvoie 429, exactement comme pour l’API REST.

Un message qui n’est pas au format JSON-RPC 2.0 renvoie une erreur JSON-RPC. GET et DELETE sur le point de terminaison renvoient 405, car il n’y a ni session ni flux serveur.