NouveauMCP · Model Context Protocol

Connecter BeatEat à votre assistant IA

BeatEat expose un connecteur MCP : branchez-le à Claude, ChatGPT ou tout autre assistant compatible, et pilotez vos recettes et vos listes de courses en langage naturel — sans quitter votre conversation.

Qu’est-ce que le MCP ?

Le Model Context Protocol (MCP) est un standard ouvert qui permet à un assistant IA d’utiliser des outils externes en toute sécurité. En connectant BeatEat, votre assistant peut chercher des recettes, en créer, gérer vos listes et préparer vos courses — directement avec votre compte BeatEat. Vous décrivez ce que vous voulez, l’assistant appelle les bons outils pour vous.

Cherchez & découvrez

Trouvez des recettes par ingrédient, régime, équipement ou temps de préparation.

Créez & organisez

Rédigez de nouvelles recettes et rangez-les dans vos listes personnelles.

Faites vos courses

Transformez des recettes en liste de courses fusionnée, partagée et cochable.

L’adresse à connecter

Une seule chose à retenir : l’URL du connecteur. Collez-la dans votre assistant, la connexion sécurisée se fait toute seule (aucune clé ni mot de passe à saisir).

https://beat-eat-mcp-server-807553569972.europe-west1.run.app/mcp

Avant de commencer

  • Un compte BeatEat (le même que sur l’application). Pas encore de compte ? Créez-le ici.
  • Un assistant qui gère les connecteurs MCP personnalisés (la fonctionnalité est généralement réservée aux offres payantes — voir ci-dessous selon votre client).

Mise en place

Choisissez votre assistant. Les étapes diffèrent légèrement, mais l’adresse à coller est toujours la même.

Sur claude.ai ou l’application Claude Desktop (offre payante requise pour les connecteurs personnalisés).

  1. 1
    Ouvrez Paramètres → Connecteurs, puis « Ajouter un connecteur personnalisé ».
  2. 2
    Nom : Beat Eat — URL : collez l’adresse du connecteur.
  3. 3
    Validez, puis cliquez sur « Se connecter ». Une page beat-eat.com s’ouvre : identifiez-vous et autorisez l’accès.
  4. 4
    C’est prêt ! Les outils BeatEat apparaissent dans Claude. Lancez une demande pour les utiliser.
https://beat-eat-mcp-server-807553569972.europe-west1.run.app/mcp

Comment se fait la connexion ?

1. Vous collez l’URL

Votre assistant détecte automatiquement le connecteur et démarre une connexion sécurisée (OAuth 2.0 + PKCE).

2. Vous vous identifiez

Une page beat-eat.com s’ouvre. Vous vous connectez et autorisez l’accès. L’assistant ne voit jamais votre mot de passe.

3. Les outils s’activent

Les outils disponibles correspondent à vos droits. Les actions sont réalisées en votre nom, sur votre compte.

Ce que votre assistant peut faire

Vous n’avez pas à connaître ces noms d’outils : l’assistant choisit les bons tout seul. Ils sont listés ici pour la transparence. La liste s’adapte automatiquement à votre compte.

Recherche & découverte

Explorer le catalogue BeatEat.

  • search_recipes — rechercher des recettes (catégorie, ingrédient, équipement, régime, temps…)
  • get_recipe — afficher une recette complète
  • list_categories — lister les catégories
  • list_folders / get_folder — parcourir les dossiers thématiques
  • search_ingredients / search_units / search_equipments — consulter les référentiels
  • whoami — savoir avec quel compte vous êtes connecté

Mes recettes

Créer et modifier vos propres recettes.

  • create_recipe — créer une recette (parties, étapes, temps, régimes, mode Thermomix…)
  • update_recipe — modifier une de vos recettes
  • set_recipe_image — ajouter une photo à une recette
  • delete_recipe — supprimer une de vos recettes

Mes listes de recettes

Vos collections personnelles (et partagées).

  • create_list / list_lists / get_list — créer, lister et ouvrir vos collections
  • rename_list / delete_list — renommer ou supprimer une collection
  • add_recipe_to_list / remove_recipe_from_list — ranger ou retirer une recette

Listes de courses

Préparer et suivre vos courses, en solo ou à plusieurs.

  • create_shopping_list / list_shopping_lists / get_shopping_list — gérer vos listes de courses
  • add_recipe_to_shopping_list — ajouter une recette (les ingrédients sont fusionnés automatiquement)
  • add_item_to_shopping_list — ajouter un article libre
  • update_shopping_list_item — cocher / décocher, modifier une quantité
  • clear_checked_shopping_list_items — archiver tout ce qui est coché

Outils supplémentaires (selon vos droits)

Certains outils n’apparaissent que si votre compte y est autorisé :

  • Partenairesimport_recipe_from_url — importer une recette depuis l’adresse d’un site web.
  • AdminGestion du catalogue (ingrédients, unités, dossiers), publication Instagram et administration des comptes.

Exemples de demandes

Une fois connecté, écrivez simplement à votre assistant :

« Trouve-moi 3 recettes véganes sans gluten qui se préparent en moins de 30 minutes. »

« Crée une liste de courses « Semaine » et ajoute les ingrédients de ces 3 recettes pour 4 personnes. »

« Ajoute la recette « Curry de pois chiches » à ma liste de courses, puis coche ce que j’ai déjà. »

« Enregistre la recette de ma grand-mère : voici les ingrédients et les étapes… »

« Quelles recettes du dossier « Été » utilisent des courgettes ? »

« Range cette recette dans ma collection « À tester ce week-end ». »

Sécurité & confidentialité

  • • La connexion passe par une autorisation OAuth : votre mot de passe n’est jamais transmis à l’assistant.
  • • L’assistant agit uniquement avec vos droits et sur vos données (vos recettes, vos listes).
  • • Vous pouvez révoquer l’accès à tout moment depuis les réglages de connecteurs de votre assistant.

Questions fréquentes

Je ne trouve pas l’option « connecteur personnalisé ».

Les connecteurs MCP personnalisés sont généralement réservés aux offres payantes (Claude Pro/Max/Team/Enterprise, ChatGPT Plus/Pro/Business/Enterprise…). Vérifiez votre abonnement et que cette fonctionnalité est activée pour votre compte.

La liste d’outils est vide ou incomplète.

Demandez à l’assistant « qui suis-je ? » pour vérifier le compte connecté. Les outils d’import ou d’administration n’apparaissent que si votre compte dispose des droits correspondants.

On me redemande de me reconnecter de temps en temps.

C’est normal : l’accès est renouvelé automatiquement et l’autorisation se rafraîchit en arrière-plan pour des raisons de sécurité.

Mon client demande un « Client ID » ou un secret.

Ce n’est pas nécessaire : laissez ces champs vides. Le connecteur s’enregistre tout seul à partir de l’URL. Saisissez seulement l’adresse ci-dessus.