Outils et ressources MCP - Chataigne Docs

La surface MCP restaurant contient 18 outils de lecture et 6 actions opérationnelles. Les inputs refusent les propriétés inconnues, les listes sont limitées à 50 éléments, les transcriptions à 100 messages et les analytics à huit métriques sur 366 jours maximum. Les capacités supplémentaires d’administration de plateforme sont documentées uniquement dans l’espace Admin protégé.

Contexte et espaces de travail

Outil	Usage	Input principal
`chataigne_context_get`	Inspecter utilisateur délégué, client OAuth, scopes et déploiement	Aucun input
`chataigne_workspaces_list`	Découvrir organisations et établissements accessibles	`cursor?`, `limit?`
`chataigne_business_organization_get`	Lire un groupe et ses établissements	`business_organization_id`
`chataigne_location_get`	Lire le résumé opérationnel sûr d’un restaurant	`location_id`
`chataigne_location_settings_get`	Lire uniquement les sections de paramètres choisies	`location_id`, `sections[]`
`chataigne_location_ordering_status_get`	Lire le statut Ouvert, Fermé, Rush ou Pause	`location_id`

Les sections de paramètres sont store, order, opening_hours, delivery, payment_methods, ai, loyalty, referrals, notifications et privacy.

Catalogue

Outil	Usage	Input principal
`chataigne_catalogs_list`	Lister des résumés compacts de catalogues	`location_id`
`chataigne_catalog_search`	Rechercher sans charger tout l’arbre du menu	`location_id`, `query?`, `kinds?`, `available?`
`chataigne_catalog_item_get`	Lire un produit, une option, liste d’options, catégorie ou bundle	`kind`, `item_id`

Les résultats de recherche incluent une URI chataigne://catalog-items/... lorsqu’elle est disponible.

Commandes et clients

Outil	Usage	Input principal
`chataigne_orders_list`	Rechercher par propriétaire, statut, service et date	`owner`, filtres, curseur
`chataigne_order_get`	Lire lignes, totaux, fulfillment et historique de statut	`order_id`, `include_customer_contact?`
`chataigne_customers_list`	Rechercher des profils scoped sans coordonnées	`owner`, filtres, curseur
`chataigne_customer_get`	Lire un client dans son périmètre propriétaire	`owner`, `customer_id`, `include_contact?`

Le propriétaire est toujours explicite :

{ "type": "location", "id": "loc_..." }

ou :

{ "type": "business_organization", "id": "org_..." }

Les coordonnées d’une commande exigent à la fois orders.read et customers.read.

Conversations

Outil	Usage	Input principal
`chataigne_conversations_list`	Rechercher des résumés et états chatbot/rapport	`owner`, filtres, curseur
`chataigne_conversation_get`	Lire une transcription merchant-safe bornée	`conversation_id`, `message_limit?`

Les traces d’outils internes, identités provider brutes et payloads provider ne sont jamais renvoyés.

Analytics et configuration

Outil	Usage	Input principal
`chataigne_analytics_query`	Calculer jusqu’à huit métriques en un appel	`owner`, `metrics[]`, `from`, `to`
`chataigne_discounts_list`	Lister les remises du propriétaire	`owner`
`chataigne_integrations_list`	Lister providers et indicateurs non sensibles	`location_id`, `categories?`

Métriques analytics disponibles :

total_orders, gross_volume, average_cart, orders_evolution,
orders_by_channel, average_cart_by_channel, orders_heatmap,
cancelled_orders, active_customers, new_customers,
repeat_customer_rate, interactions, conversion_rate,
top_products, trending_products, delivery_cities,
discount_usage, products_sold, products_per_order

Actions opérationnelles

Ces actions restaurant sont visibles uniquement si le déploiement des écritures est actif et si le token possède le scope d’écriture.

Outil	Effet et précondition de sûreté
`chataigne_location_ordering_status_set`	Définit Online, Rush ou Pause ; exige `expected_mode`
`chataigne_catalog_item_availability_set`	Bascule atomiquement produit/option ; exige `expected_available`
`chataigne_order_status_set`	Avance vers un statut non destructif autorisé ; exige `expected_status`
`chataigne_conversation_chatbot_set`	Active/désactive atomiquement l’IA ; exige `expected_active`
`chataigne_conversation_message_send`	Envoie un message texte manuel ; exige `idempotency_key`
`chataigne_conversation_instruction_send`	Envoie une instruction à l’IA ; exige `idempotency_key`

chataigne_order_status_set accepte uniquement accepted, in_preparation, awaiting_shipment, awaiting_collection, in_delivery ou completed. Il ne peut ni annuler, ni rejeter, ni marquer un échec de livraison, ni rembourser.

Templates de ressources

Le serveur annonce uniquement les templates couverts par les scopes du token :

chataigne://business-organizations/{id}
chataigne://locations/{id}
chataigne://catalog-items/{kind}/{id}
chataigne://orders/{id}
chataigne://customers/{ownerType}/{ownerId}/{id}
chataigne://conversations/{id}

Les ressources renvoient application/json et appliquent la même autorisation en temps réel que l’outil de détail correspondant.

​Contexte et espaces de travail

​Catalogue

​Commandes et clients

​Conversations

​Analytics et configuration

​Actions opérationnelles

​Templates de ressources