> **Test site:** demo restaurants and test orders only. Nothing here is a real restaurant or a real order.

<!-- canonical: http://localhost:3000/fr/agents; language: fr; other language: http://localhost:3000/agents -->

# Pour les agents IA

Menu.ca offre une version texte de chaque page, une API REST et un serveur MCP. Sans inscription, sans CAPTCHA, sans confirmation humaine.

- OpenAPI: http://localhost:3000/api/v1/openapi.json
- MCP (Streamable HTTP): http://localhost:3000/mcp
- Server card: http://localhost:3000/mcp/server-card
- llms.txt: http://localhost:3000/llms.txt

Fast path: search → menu → quote → place order → status. Orders are sandbox tests on this site.

## Versions texte des pages

Chaque page a une version texte. Ajoutez .md à son adresse : cela fonctionne toujours. Demander text/markdown fonctionne aussi, mais certains hébergeurs y répondent eux-mêmes, sans nos identifiants ni l'état en direct.

- http://localhost:3000/ottawa.md
- http://localhost:3000/ottawa/pelican-lane-pizza.md

## Le chemin rapide

menuca_order_now crée une carte de commande et la passe en un seul appel. Les articles peuvent être donnés par leur nom, en français ou en anglais. Un nom qui correspond à plusieurs choses, ou à aucune, revient en erreur 422 avec les candidats.

## Cartes de commande

Chaque commande est passée à partir d'une carte de commande : un panier figé à un moment donné et tarifé par le restaurant. Une carte ne change jamais. Si un prix a bougé quand vous la passez, rien n'est passé : vous recevez une erreur 409 card_changed avec le nouveau total et une carte de remplacement. Chaque carte a une page que l'on peut ouvrir et partager, et une version texte.

## Commander pour une personne

Un agent relié au compte Menu.ca d'une personne utilise son nom, son adresse et son paiement par défaut, et ses commandes s'ajoutent à son historique. Menu.ca n'ajoute aucune limite, approbation ni plafond pour les agents.

- Claude : allez dans Personnaliser, Connecteurs, Ajouter un connecteur personnalisé. Saisissez http://localhost:3000/mcp/me. Laissez le client OAuth sur « Utiliser l'identité publiée de Claude », cliquez sur Ajouter, puis Connecter, ouvrez une session Menu.ca et choisissez Autoriser.
- ChatGPT : ouvrez chatgpt.com/plugins, choisissez +, puis Ajouter un serveur MCP personnalisé. Saisissez http://localhost:3000/mcp/me, choisissez Créer comme plugin, et ouvrez une session Menu.ca quand on vous le demande.
- Agents de navigation (ils utilisent le site comme une personne) : ouvrez le lien d'une carte de commande, saisissez le nom et appuyez sur Passer cette commande. Chaque commande porte une étiquette de texte visible.
- Tout autre agent : créez une clé à http://localhost:3000/fr/compte/agents et envoyez-la comme jeton Bearer à http://localhost:3000/mcp/me ou http://localhost:3000/api/v1/me.
- Un court fichier de compétences que tout agent peut charger: http://localhost:3000/agents/skill.md
- OAuth metadata: http://localhost:3000/.well-known/oauth-authorization-server
