Passer au contenu principal
StockShift est un serveur MCP : un assistant IA comme Claude ou ChatGPT peut donc consulter de l’information et effectuer du travail dans StockShift. L’assistant agit en tant que membre qui l’a connecté : il ne peut faire que ce que ce membre peut faire, et seulement ce que ce membre lui permet. Chaque changement qu’il apporte figure dans l’historique d’audit sous le nom du membre et le nom de l’application. Le serveur se trouve à https://app.stockshift.io/mcp et utilise le transport Streamable HTTP. Il exige le forfait Starter ou un forfait supérieur.

​
Connecter un assistant

  1. Dans votre assistant, ajoutez un connecteur personnalisé ou un serveur MCP avec l’adresse ci-dessus.
  2. L’assistant ouvre StockShift dans votre navigateur et vous demande de vous connecter.
  3. La page Connecter affiche le nom de l’application et l’endroit où vous serez renvoyé. N’importe qui peut enregistrer une application : continuez seulement si vous avez lancé la connexion et faites confiance à l’application.
  4. Choisissez l’organisation dans laquelle l’application doit travailler.
  5. Choisissez ce qu’elle peut faire, module par module.
  6. Appuyez sur Autoriser l’accès.
La connexion utilise le même flux OAuth que n’importe quelle application OAuth. Un client MCP le découvre grâce à l’en-tête WWW-Authenticate de son premier appel non authentifié, qui pointe vers /.well-known/oauth-protected-resource.

​
Outils

L’assistant reçoit un outil pour chaque action que StockShift a rendue disponible aux automatisations, comme consulter un article, créer un bon de commande ou confirmer une commande client. Un outil n’apparaît que si les autorisations du membre, le forfait et les portées que le membre a accordées lui permettent de l’utiliser. Appelez tools/list pour les voir. Appeler le serveur MCP dans la référence de l’API liste tous les outils du serveur. Les outils qui ne font que consulter sont marqués en lecture seule, et ceux qui changent quelque chose sont marqués comme modifiant des données. Chaque outil prend les mêmes champs que le point de terminaison REST correspondant.
  • Un appel invalide, ou que le membre n’a pas le droit de faire, revient comme une erreur d’outil avec les mêmes détails de problème que ceux de l’API REST.
  • Envoyer deux fois le même appel n’applique le changement qu’une fois. Un appel peut fournir sa propre clé dans _meta.idempotencyKey. Sans clé, l’identifiant de la requête sert de clé.
  • Une réponse est tronquée à 100 Ko, avec une note qui invite à utiliser le point de terminaison REST pour obtenir le reste.
  • Chaque application est limitée à 30 appels d’outils par minute, en plus des limites de débit.