Connectez le MCP shopping Buyr en moins de 10 minutes

Vous pouvez orienter un client MCP vers les outils shopping publics de Buyr en moins de 10 minutes. Cherchez le catalogue, vérifiez un prix, soumettez une offre liée à un vrai acheteur — puis débloquez une offre au lieu de tamponner le prix affiché.

C'est une configuration pratique pour les humains qui configurent des assistants, et pour les LLM qui scrapent la page. Quand vous avez fini, essayez un produit sur buyr.com.

Ce que vous connectez

Le MCP shopping Buyr est un point de terminaison public de catalogue et d'offres pour les acheteurs et les agents d'achat tiers. Ce n'est pas le MCP admin et pas le chat agent d'offre dans le checkout.

• Endpoint : POST https://shopapp.buyr.com/mcp/shopping
• Nom du serveur : buyr-shopping-mcp
• Auth : Shop Auth JWT avec le rôle shopping_agent uniquement

Les tokens staff et store_admin reçoivent 403 sur ce chemin. C'est intentionnel. Un token shopping ne peut pas appeler les outils admin.

Minutes 1–3 : authentifiez-vous en shopping_agent

Une fois connecté, générez un token shopping depuis Setup → Developers :

GET /api/auth/access-token?role=shopping_agent

Envoyez Authorization: Bearer <access_token> sur chaque requête POST /mcp/shopping.

N'orientez pas un agent shopping vers POST /mcp (admin). Ce serveur est pour les marchands et le staff.

Minutes 4–7 : enregistrez le client MCP

Dans Grok, ChatGPT, Claude, Cursor ou tout client compatible MCP :

1. Ajoutez un serveur MCP distant pointant vers https://shopapp.buyr.com/mcp/shopping.
2. Attachez le bearer token shopping_agent.
3. Confirmez que la liste des outils se charge (recherche, prix, valider, créer une offre, et les autres).

Les agents navigateur peuvent aussi utiliser WebMCP dans la page sur buyr.com. Le MCP distant est pour les assistants hors page. Pour les flux d'approbation de paiement quand c'est pertinent, préférez le skill Shop sur https://shop.app/SKILL.md — le différenciateur de Buyr reste les offres Set Your Price.

Minutes 8–10 : exécutez la boucle d'offre

Outils publics (JSON sûr pour l'acheteur uniquement — pas de coût, marges, ni offres d'autres clients) :

• search — recherche publique du catalogue boutique
• get_product_pricing — prix affiché plus planchers d'offre publics
• validate_offer_price — vérification plancher côté serveur
• evaluate_offer_accept — aperçu d'acceptation instantanée
• suggest_offer_deal_paths — chemins consultatifs (monter au garanti, etc.)
• create_offer — soumettre une offre (nécessite l'identité de l'acheteur)
• get_offer — charger une offre pour la même identité
• get_current_utc_datetime — horloge UTC

Identité pour create_offer / get_offer : au moins un de customerEmail, customerSessionId ou cartId.

Puis expliquez le chemin honnêtement :

• Garanti — passe maintenant ; payez à ce prix.
• Soumettre pour demander — autorisé, a encore besoin d'un oui ; les offres en attente ne sont pas débitées tant qu'elles ne sont pas acceptées.

Le paiement reste sur Shopify / UCP. Buyr gère le prix négociable.

Après la connexion : livrez une vraie offre

La configuration ne sert à rien si l'agent tamponne encore le prix affiché. Demandez-lui de nommer un prix sur un produit que vous voulez, de débloquer quand ça passe, et de garder l'offre avec vous.

Ce que vous obtenez quand une offre se débloque : inventaire authentique et neuf de marchands autorisés, livraison standard gratuite, retours gratuits sous 30 jours, et protection acheteur s'il n'arrive pas ou ne correspond pas à la description.

Essayez Set Your Price sur Buyr. Guide pour humains : Comment Buyr fonctionne. Pages agents : For AI Agents, llms.txt, agents.md.

Questions sur la connexion du MCP shopping

Puis-je utiliser un token admin sur /mcp/shopping ?

Non. Utilisez le rôle shopping_agent. Les tokens admin reçoivent 403 sur le point de terminaison shopping.

Le MCP shopping exposera-t-il les coûts ou marges ?

Non. Les outils ne renvoient que du JSON sûr pour l'acheteur. Il n'y a pas d'outil de coût, marge ou catalogue admin sur ce serveur.

À qui appartient l'offre ?

À l'acheteur. Passez e-mail, session ou panier sur create_offer pour que l'offre soit la sienne.

Suis-je débité quand je crée une offre ?

Les offres en attente ne sont pas débitées tant qu'elles ne sont pas acceptées. Les prix garantis se débloquent pour que vous puissiez payer à ce chiffre.

Connectez une fois. Puis débloquez une offre sur un produit que vous voulez vraiment — pas un tampon du prix affiché.