- Endpoint unique :
https://mcp.factumis.fr
- Transport : Streamable HTTP. Les réponses peuvent être renvoyées en JSON
ou en flux SSE (
text/event-stream).
- Protocole : JSON-RPC 2.0.
| En-tête | Valeur |
|---|
Authorization | Bearer <clé API> (obligatoire) |
Content-Type | application/json |
Accept | application/json, text/event-stream |
Mcp-Session-Id | géré par le client après initialize, le cas échéant |
initialize — négociation du protocole et des capacités.tools/list — énumération des tools (voir Tools).tools/call — exécution d’un tool ({ name, arguments }).
Chaque tool renvoie un contenu textuel JSON :
{ "content": [{ "type": "text", "text": "{ ...résultat JSON... }" }] }
En cas d’erreur métier, la réponse porte "isError": true et un message court
exploitable par l’assistant.
| Message | Cause |
|---|
Quota mensuel atteint (used/limit) | Plafond de factures du mois atteint |
| E-invoice non prêt | Compte e-invoicing non provisionné |
| Envoi désactivé en beta (sandbox) | Phase beta — envoi indisponible |
| Email manquant | Le client n’a pas d’email pour l’envoi |
| Contact requis | Données client incomplètes |
| Erreur du service e-invoicing | Erreur côté plateforme agréée |
| Permission insuffisante | Le rôle ne couvre pas l’action |
| Erreur interne | Erreur inattendue côté serveur |
| Code | Signification |
|---|
200 | Requête JSON-RPC traitée (succès ou erreur métier dans le corps) |
401 | Authentification échouée (clé absente/invalide) |