Skip to main content
Le Model Context Protocol (MCP) permet à un assistant IA de lire et d’agir sur votre boutique avec les outils que vous lui accordez, et uniquement ceux-là. Pulse-Sell expose un serveur MCP : vous créez une connexion, vous cochez ses permissions, vous collez le jeton dans votre client.
Le MCP agit au nom de votre boutique. Il est distinct de la clé d’API publique (pour vos serveurs) et des Pulses (pour être prévenu).

​
Créer une connexion

1

Ouvrir l'écran

Dans le tableau de bord, ouvrez Intégrations, puis MCP & Agents IA.
2

Choisir les permissions

Chaque permission correspond à un outil réel. Cochez le minimum nécessaire : un agent qui ne fait que consulter n’a pas besoin de refund_order.
3

Copier le jeton

Il commence par mcp_ et s’affiche une seule fois. Seule une empreinte est conservée chez nous : si vous le perdez, supprimez la connexion et créez-en une autre.

​
Brancher votre client

Le serveur parle JSON-RPC 2.0 en HTTPS. Adresse : https://api.pulse-sell.com/api/mcp/rpc, avec l’en-tête Authorization: Bearer mcp_….
La réponse ne liste que les outils accordés à ce jeton. Pour appeler un outil :
Méthodes gérées : initialize, tools/list, tools/call. Tout autre appel répond -32601.

​
Les 30 outils

Les outils d’écriture (refund_order, cancel_order, delete_product, send_*) ont des effets réels et visibles par vos clients. Accordez-les seulement aux agents que vous surveillez.

​
Sécurité

  • Jeton haché : le secret est stocké sous forme de hachage bcrypt, jamais en clair.
  • Permissions vérifiées à chaque appel : un outil non accordé répond 403 (-32003), même si l’agent le connaît.
  • Limite : 60 requêtes par minute et par connexion (429, code -32002).
  • Suivi : date de dernier usage, nombre d’appels, nombre d’erreurs et dernière erreur sont visibles sur chaque connexion.
  • Révocation immédiate : supprimer la connexion invalide le jeton aussitôt.

​
Tester sans client

L’écran MCP propose un appel de test avec les mêmes permissions que le jeton réel, pour vérifier un outil avant de le confier à un agent.

​
Codes d’erreur

​
Équipe et MCP

Une connexion MCP appartient à la personne qui la crée et agit sur sa propre boutique. Un collaborateur d’une autre boutique ne peut donc pas en créer une pour cette boutique : le propriétaire la crée lui-même. Voir Équipe et collaborateurs.