Skip to main content
À qui ça s’adresse : un développeur qui raccorde un client IA ou un agent au compte storekit d’un marchand. Pour les surfaces côté client (un agent qui lit un menu public et construit un basket), consulte Agents de commande. Pour les guides de configuration non techniques, consulte Connecter ton agent IA.
Fonctionnalité beta - Le MCP marchand est en beta et les comptes sont activés à partir d’une liste d’attente. Demande l’accès, ou écris à mcp@storekit.com.

​
Endpoint

Chaque requête crée un serveur MCP frais lié au compte authentifié, traite un message et se ferme. Rien n’est retenu entre les appels ; une conversation transporte elle-même les identifiants d’établissements et de commandes.

​
Outils

Dix-huit outils, tous restreints au compte authentifié. Seize sont en lecture seule (readOnlyHint: true) ; create-discount-code et create-payment-link sont des écritures. La référence complète des entrées se trouve sur Outils. Il n’y a aucun outil qui modifie les commandes, les menus, les venues, les utilisateurs ou les réglages.

​
Contrat en bref

  • Chaque succès est une enveloppe { data, meta }, renvoyée à la fois comme structuredContent et comme JSON dans le premier bloc texte. Chaque outil publie un outputSchema pour elle. Voir Format de réponse.
  • Les erreurs sont des résultats isError: true texte uniquement portant une enveloppe { error } avec un code stable. Voir Erreurs.
  • L’argent est en unités mineures avec un code devise explicite. Les dates sont en ISO strict. Les requêtes portant sur un établissement sont par défaut dans son fuseau horaire, les requêtes à l’échelle du compte en UTC.
  • La pagination commence à la page 1, est plafonnée à 100 lignes, et signale hasMore/nextPage à partir d’une anticipation d’une ligne plutôt qu’à partir de totaux.

​
Limites

​
Référence

Authentification

La discovery et la connexion OAuth, comment le compte est choisi.

Outils

Chaque outil avec ses entrées, valeurs par défaut et base de date.

Format de réponse

L’enveloppe, la pagination, les dates, fuseaux horaires et l’argent.

Erreurs

Codes d’erreur, règles de reprise et les formes que les clients doivent gérer.