Documentation développeur

Branche un assistant IA sur ton espace MADATA

Chaque espace <espace>.madata.app embarque un serveur MCP : un assistant IA, ou votre propre code, y lit et écrit vos données métier avec vos droits.

Le serveur MCP de votre espace expose ≈150 outils métier (indicateurs, ventes, comptabilité, paie, écritures…) à un client externe : Claude, ChatGPT, Gemini, Mistral Le Chat, ou un programme que vous écrivez. Toute l’exécution se fait avec les droits de l’utilisateur porteur de la clé.

01Démarrage rapide en 3 étapes

Créer une clé d’API. Dans MADATA, ouvrez Mon profil → Sécurité du compte → Clés API et générez une clé. Elle commence par mia_ et n’est affichée qu’une fois. Réservé aux Administrateurs MADATA de l’espace. Détails.
Récupérer l’URL de l’espace. Elle a la forme https://<espace>.madata.app/mia/mcp et s’affiche à côté de la clé.
Appeler. Un POST JSON-RPC avec l’en-tête Authorization: Bearer :

bashlister les outils disponibles

curl -s https://<espace>.madata.app/mia/mcp \
  -H "Authorization: Bearer mia_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Pour brancher Claude ou Mistral Le Chat, pas de clé à coller : ils se connectent en OAuth avec la seule URL. Voir Connecter un assistant.

02Ce que le serveur MCP sait faire

À l’installation d’un espace, 150 outils sont exposés (73 en lecture, 77 en écriture). La liste réellement visible dépend des modules installés, des droits de l’utilisateur et de la portée de la clé.

Famille	Exemples
Indicateurs	`get_kpi`, `get_cash_flow`, `get_crm_kpi`, `get_revenue_forecast`
Lecture métier	`search_sales`, `search_invoices`, `get_stock_card`, `query_records`
Comptabilité	`get_balance_sheet`, `check_accounting_consistency`, `export_accounting`, `create_journal_entry`
Écritures	`create_quotation`, `create_customer_invoice`, `register_payment`, `action_record`
RH & paie	`create_payslip`, `validate_batch`, `send_payslip`, `create_leave`
Communication	`send_email`, `prepare_whatsapp_message`, `send_payment_followups`

Le serveur expose aussi 4 ressources (mia://kpi/current…) et 8 prompts prêts à l’emploi. Catalogue complet : Catalogue des outils.

03Conventions

Endpoint: https://<espace>.madata.app/mia/mcp : un par espace.
Auth: En-tête Authorization: Bearer mia_…, ou OAuth 2.1 (Claude, Mistral).
Langue: Messages d’erreur et descriptions en français.
Nom: La plateforme s’appelle MADATA.

Sécurité

Une clé n’élève jamais les droits : chaque appel s’exécute sous l’utilisateur réel, avec ses permissions natives. Les ressources facturées (utilisateurs, sociétés, points de vente, applications) restent non modifiables : elles se gèrent dans le portail.

04Support

Une capacité manque, un outil se comporte mal ? Depuis un assistant connecté, demandez d’enregistrer une demande : l’outil suggest_feature_request la transmet. Sinon, passez par le support depuis votre espace client.