Ressources, prompts & OpenAPI

Au-delà des outils, le serveur expose des ressources en lecture seule, des prompts prêts à l’emploi, et une spec OpenAPI de découverte.

01Ressources (resources/*)

Lecture directe, sans appel d’outil. resources/list puis resources/read avec l’uri.

URI	Contenu
`mia://conversations`	Les 20 dernières conversations de l’utilisateur avec Mia.
`mia://memories`	Faits durables mémorisés (préférences, règles de gestion).
`mia://kpi/current`	Indicateurs clés de l’espace (ventes, achats, stock, trésorerie).
`mia://audit/recent`	Les 50 dernières actions Mia (lecture + écriture, MCP + interface).

jsonresources/read

{"jsonrpc":"2.0","id":3,"method":"resources/read",
 "params":{"uri":"mia://kpi/current"}}

{"jsonrpc":"2.0","id":3,"result":{
  "contents":[{"uri":"mia://kpi/current","mimeType":"application/json","text":"{…}"}]
}}

02Prompts (prompts/*)

Modèles de conversation exposés aux clients qui les affichent (Claude Desktop, etc.). prompts/get interpole les arguments fournis.

Nom	Rôle	Arguments
`analyse_mensuelle`	Analyse financière mensuelle : CA, charges, résultat.	`mois` (YYYY-MM)
`audit_comptable`	Audit de cohérence : anomalies, soldes anormaux, TVA.	aucun
`relance_impayes`	Factures impayées + préparation des relances.	`jours` (défaut 30)
`bilan_fabrication`	Production : OF en cours, à lancer, terminés.	`periode` : today\|week\|month
`kpi_crm`	Pipeline, taux de gain, opportunités à relancer.	`periode` : month\|quarter\|year
`projection_tresorerie`	Trésorerie sur 4 semaines, encaissements / décaissements.	`semaines` (1-12)
`rapport_paie`	Synthèse paie : total versé, charges, anomalies.	`mois` (YYYY-MM)
`bilan_stock`	Ruptures, valorisation, mouvements récents.	aucun

03Spec OpenAPI (openapi.json)

GET /mia/mcp/openapi.json renvoie une spec OpenAPI 3.0 construite dynamiquement à partir du catalogue d’outils. Elle sert à configurer une Action ChatGPT.

Chemin d’appel réel

La spec décrit des chemins /mia/mcp/tools/<nom> : ils n’ont pas de handler dédié. L’appel réel se fait toujours sur l’endpoint JSON-RPC /mia/mcp via tools/call. Les clients MCP modernes (dont ChatGPT) s’y connectent nativement.

04Téléchargement de fichiers

Les outils qui génèrent un fichier (export_accounting, generate_report, generate_accounting_report…) renvoient une pièce jointe. On la récupère avec la même clé Bearer :

bashrécupérer un export

curl -s https://<espace>.madata.app/mia/mcp/download/<attachment_id> \
  -H "Authorization: Bearer mia_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -o export.xlsx

Seules les pièces jointes rattachées à une conversation Mia sont servies ; les autres renvoient 403.

05Journalisation

Chaque tools/call est journalisé : espace, utilisateur, nom de l’outil, succès ou échec, type d’erreur. En cas de comportement inattendu d’un outil, ce journal aide le support à diagnostiquer.