> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Aperçu du MCP marchand

> Serveur MCP distant, restreint au compte, donnant au client IA l'accès en lecture aux commandes, menus, statistiques et additions storekit, plus deux écritures.

**À 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](/docs/fr/developers/agents/ordering/overview). Pour les guides de configuration non techniques, consulte [Connecter ton agent IA](/docs/fr/guides/ai/overview).

> [!NOTE]
>
> **Fonctionnalité beta** - Le MCP marchand est en beta et les comptes sont activés à partir d'une liste d'attente. [Demande l'accès](https://t09czsyu90l.typeform.com/to/G6rIJWNv), ou écris à [mcp@storekit.com](mailto:mcp@storekit.com).

## Endpoint

| | |
| - | - |
| URL | `https://mcp.storekit.com/mcp` |
| Transport | MCP [Streamable HTTP](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports), réponses JSON (pas de streaming SSE) |
| Méthodes | `POST` pour les messages JSON-RPC ; `GET` et `DELETE` conformément à la spécification de transport |
| Session | Stateless. `initialize` renvoie un en-tête `Mcp-Session-Id`, mais les requêtes ne sont pas validées contre lui |
| Auth | Token bearer OAuth 2.1 : voir [Authentification](/docs/fr/developers/mcp/authentication) |
| Discovery | `GET /.well-known/oauth-protected-resource` |

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](/docs/fr/developers/mcp/tools).

| Domaine | Outils |
| - | - |
| Venues | `list-venues`, `get-venue` |
| Commandes | `list-orders`, `get-order`, `get-order-events` |
| Menus | `list-menus`, `get-menu` |
| Snooze | `get-snooze-report` |
| Stats | `get-order-stats`, `list-top-products` |
| Réductions | `list-discount-codes`, `create-discount-code` |
| Remboursements | `list-refunds` |
| Pay at table | `list-bills` |
| Liens de paiement | `list-payment-links`, `get-payment-link`, `create-payment-link`, `get-payment-link-qr` |

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](/docs/fr/developers/mcp/response-format).
* Les erreurs sont des résultats `isError: true` texte uniquement portant une enveloppe `{ error }` avec un `code` stable. Voir [Erreurs](/docs/fr/developers/mcp/errors).
* 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

| Limite | Valeur |
| - | - |
| Débit | 60 requêtes par minute par utilisateur ; `429` avec `Retry-After` au-delà |
| Timeout d'outil | 30 secondes ; une écriture qui a atteint le timeout peut malgré tout avoir abouti |
| Taille de page | 100 lignes (25 pour `list-top-products`) |
| Plage de dates | 90 dates calendaires locales, inclusives |
| Événements snooze par article | 100, signalés avec `eventsTruncated` |

## Référence

> **[Authentification](/docs/fr/developers/mcp/authentication)**
>
> La discovery et la connexion OAuth, comment le compte est choisi.

> **[Outils](/docs/fr/developers/mcp/tools)**
>
> Chaque outil avec ses entrées, valeurs par défaut et base de date.

> **[Format de réponse](/docs/fr/developers/mcp/response-format)**
>
> L'enveloppe, la pagination, les dates, fuseaux horaires et l'argent.

> **[Erreurs](/docs/fr/developers/mcp/errors)**
>
> Codes d'erreur, règles de reprise et les formes que les clients doivent gérer.


## Related topics

- [Introduction pour les développeurs](/docs/fr/developers/introduction.md)
- [Aperçu des agents de commande](/docs/fr/developers/agents/ordering/overview.md)
- [Endpoint MCP](/docs/fr/developers/agents/ordering/mcp-endpoint.md)
- [Aperçu du menu](/docs/fr/guides/menu/overview.md)
- [Authentification](/docs/fr/developers/mcp/authentication.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.