> ## 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.

# Découverte UCP

> Le profil Universal Commerce Protocol qu'un hôte de commande storekit publie sur /.well-known/ucp : les établissements vendus et leurs endpoints cart MCP.

**À qui cela s'adresse :** une plateforme de commerce ou un hôte d'agent qui connecte des clients à des marchands.

Un client [UCP](https://ucp.dev/2026-08-25/specification/overview/) lit un profil avant de se connecter à quoi que ce soit : quels services parle une entreprise, sur quel transport, à quel endpoint, et quelles capacités ces endpoints implémentent. Un hôte de commande storekit publie ce profil, et les endpoints qu'il nomme sont les [endpoints MCP](/docs/fr/developers/agents/ordering/mcp-endpoint) tournés vers le client.

## Chemins

| Chemin | Répond avec |
| - | - |
| `GET https://{host}/.well-known/ucp` | Chaque établissement pour lequel l'hôte vend, chacun comme sa propre entrée de service |
| `GET https://{host}/{venueSlug}/.well-known/ucp` | Cet unique établissement |

Un même hôte vend pour beaucoup d'établissements et chacun a son propre endpoint MCP, si bien que le profil de l'hôte les liste — plafonné à 25, comme toute autre liste destinée aux agents — et un agent qui parle déjà d'un établissement lit plutôt le chemin de l'établissement. Les établissements qui apparaissent proviennent de l'hôte lui-même, si bien qu'une marque sur son propre domaine annonce les emplacements de cette marque et rien d'autre.

Les réponses sont du JSON, mises en cache pendant 15 minutes et ouvertes à toute origine. Un hôte sans établissements, ou un slug d'établissement qui ne se résout pas, renvoie `404` : pas de profil vaut mieux qu'un profil sans endpoint dedans.

## Profil

```json theme={null}
{
  "ucp": {
    "version": "2026-08-25",
    "services": {
      "dev.ucp.shopping": [
        {
          "id": "gordon-ramsay-plane-food-1",
          "version": "2026-08-25",
          "spec": "https://ucp.dev/2026-08-25/specification/overview",
          "transport": "mcp",
          "endpoint": "https://order.storekit.com/gordon-ramsay-plane-food-1/api/mcp",
          "schema": "https://ucp.dev/2026-08-25/services/shopping/mcp.openrpc.json"
        }
      ]
    },
    "capabilities": {
      "dev.ucp.shopping.cart": [
        {
          "version": "2026-08-25",
          "spec": "https://ucp.dev/2026-08-25/specification/shopping/cart",
          "schema": "https://ucp.dev/2026-08-25/schemas/shopping/cart.json"
        }
      ]
    },
    "payment_handlers": {}
  }
}
```

| Champ | Signification |
| - | - |
| `services["dev.ucp.shopping"]` | Une entrée par établissement. Les entrées ne diffèrent que par `endpoint`, et chaque `id` est le slug d'établissement que le reste de l'API parle. |
| `transport` | `mcp` uniquement. C'est le seul transport que l'hôte sert ; le transport in-page d'UCP est le protocole iframe embarqué, que ces pages n'écoutent pas. |
| `schema` | Le binding contre lequel un client valide les appels, à la fois sur l'entrée de service et sur la capacité. |
| `capabilities["dev.ucp.shopping.cart"]` | Les quatre outils cart sur l'endpoint déclaré : `create_cart`, `get_cart`, `update_cart`, `cancel_cart`. |
| `payment_handlers` | Déclaré vide à dessein. Le paiement se règle sur la page propre de l'établissement, si bien qu'il n'y a aucun handler qu'une plateforme puisse tokeniser — un objet vide dit « aucun proposé » là où une clé manquante se lirait comme un profil inachevé. |

Chaque endpoint déclaré répond à un sondage `GET` par `200`, et le `robots.txt` de l'hôte de commande nomme les crawlers agents si bien que le chemin well-known leur est autorisé sans ambiguïté.


## Related topics

- [Endpoint MCP](/docs/fr/developers/agents/ordering/mcp-endpoint.md)
- [Aperçu des agents de commande](/docs/fr/developers/agents/ordering/overview.md)
- [Collecter les données clients](/docs/fr/guides/guest-data/overview.md)
- [Suivi des événements](/docs/fr/privacy-security/event-tracking.md)
- [Stratégie et bonnes pratiques des stories](/docs/fr/guides/menu-engineering/stories.md)


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