Référence des outils
Les 34 outils du serveur MCP Novadesko : consultation, préparation, envoi et confirmation, avec leurs paramètres et la fonctionnalité d'abonnement requise.
Cette liste est générée depuis le registre d'outils de Novadesko. Les schémas sont stricts : un paramètre inconnu, un type faux ou une valeur hors liste est refusé. Une fonctionnalité non incluse dans l'offre de l'entreprise renvoie un refus qui indique l'offre minimale et son prix.
Consultation (read)
| Outil | Paramètres (* obligatoire) | Fonctionnalité requise | Rôle |
|---|---|---|---|
get_company | aucun | aucune | Profil de l'entreprise connectée, abonnement, add-ons actifs et portées accordées. À appeler en premier. |
search_parties | kind* customer | supplierq stringpage integer | Gestion des clients si kind = customer | Recherche des clients ou fournisseurs. |
get_party | kind* customer | supplierid* integer | Gestion des clients si kind = customer | Fiche complète d'un client ou fournisseur : coordonnées, vérifications (TVA, 30 bis, Peppol), derniers documents. |
search_documents | type receipt | invoice | proforma | order | credit_note | estimate | purchaseq stringpaid booleanpage integerfrom stringto string | aucune | Recherche de documents (devis, bons de commande, factures, reçus, notes de crédit, achats). |
get_document | document_id* integer | aucune | Détail d'un document : lignes, montants, statut, Peppol, synchronisation comptable, liens. |
list_products | q stringpage integer | aucune | Produits et services du catalogue. |
get_revenue | from stringto stringcompare previous_year | previous_period | nonegroup_by month | none | aucune | Chiffre d'affaires sur une période (factures + reçus non convertis, moins les notes de crédit), comparaison et détail mensuel. |
get_top | from stringto stringkind customers | productslimit integer | aucune | Meilleurs clients ou produits sur une période. |
get_unpaid_invoices | aucun | aucune | Factures impayées : reste dû, retard, relances déjà envoyées. |
get_reminders | document_id integer | Relances de paiement | Réglages et historique des relances (e-mail et SMS). |
get_sms_credits | aucun | aucune | Crédits SMS restants. |
get_peppol_status | aucun | aucune | Statut Peppol : identifiant, demande d'activation, documents reçus et envoyés, validations, erreurs. Lecture seule. |
get_accounting_sync_status | from string | aucune | Documents synchronisés, en attente ou en erreur avec WinAuditor, WinBooks Connect, Horus et les autres intégrations comptables. |
get_bank_sync_status | aucun | aucune | BankSync : comptes, dernière synchronisation, transactions non rapprochées. Lecture seule. |
get_import_mailbox | aucun | aucune | Boîte mail d'import automatique : adresse, mails reçus, documents importés ou en erreur. |
get_document_settings | aucun | aucune | Paramètres de documents : conditions générales, mentions, en-têtes et pieds de page, logo. |
get_business_insights | topic* accounting | vat | bank | purchases | transactions | monthly_averages | fixed_charges | projections | payment_plans | credits | leases | vehicles | social_contributions | tax_estimation | stock | nace | selon topic (tableau plus bas) | Analyses de gestion calculées par Novadesko (mêmes chiffres que Nova AI), selon le sujet choisi. |
list_pending_actions | aucun | aucune | Aperçus en attente de confirmation dans cette conversation. |
search | query* string | aucune | Recherche transversale (clients, fournisseurs, documents). Renvoie des identifiants à lire avec fetch. (MCP seulement) |
fetch | id* string | aucune | Lit un résultat de search (customer:ID, supplier:ID ou document:ID). (MCP seulement) |
Préparation (write)
| Outil | Paramètres (* obligatoire) | Fonctionnalité requise | Rôle |
|---|---|---|---|
prepare_party_create | kind* customer | suppliercompany stringfirst_name stringlast_name stringemail stringphone stringaddress stringpostal_code stringcity stringcountry_code stringvat_number stringiban stringis_individual boolean | Gestion des clients si kind = customer | Aperçu de création d'un client ou fournisseur (contrôles VIES, article 30 bis, Peppol). N'enregistre rien. |
prepare_party_update | kind* customer | supplierid* integerchanges* object | Gestion des clients si kind = customer | Aperçu de modification d'une fiche client ou fournisseur. N'enregistre rien. |
prepare_document_create | type* estimate | order | invoice | receipt | credit_note | proformacustomer_id* integerdate stringdue_date stringobject stringnotes stringparent_document_id integerlines* array<object> | selon type : Facturation, Bons de commande (order), Reçus (receipt) | Aperçu PDF d'un nouveau devis, bon de commande, facture, reçu, proforma ou note de crédit. Le numéro légal est attribué à la confirmation. |
prepare_document_update | document_id* integerdate stringdue_date stringobject stringnotes stringlines array<object> | aucune | Aperçu PDF de modification d'un document modifiable (non verrouillé, non transmis via Peppol). lines remplace toutes les lignes. |
prepare_document_convert | document_id* integerto_type* order | invoice | credit_note | selon to_type | Aperçu de conversion : devis vers commande ou facture ; commande, reçu ou proforma vers facture ; facture vers note de crédit. |
prepare_document_import | data* objectfile_name* stringfile_base64* stringaccept_inconsistencies boolean | aucune | Aperçu d'import d'une facture d'achat lue par l'IA, avec le fichier en base64 (pièce jointe conservée). Contrôle des totaux et de la TVA, aucun crédit OCR consommé. (MCP seulement) |
prepare_settings_update | terms_html stringlegal_notice_html stringfooter array<object>header array<object> | aucune | Aperçu (PDF pour les conditions générales) de mise à jour des conditions générales, mentions légales, en-têtes et pieds de page. |
prepare_payment | document_id* integeramount* numberdate stringpayment_type* stringnotes string | aucune | Aperçu de l'enregistrement d'un paiement sur une facture, un reçu ou un achat : montant, date, mode de paiement (ex. banktransfert, cash, bankcard). |
prepare_peppol_request | request* activate | disable | delete | Activation Peppol | Aperçu d'une demande Peppol traitée par l'équipe Novadesko : activation, désactivation ou suppression. N'envoie jamais de document via Peppol. |
prepare_support_ticket | subject* stringmessage* string | aucune | Aperçu d'un ticket au support Novadesko, créé au nom de l'utilisateur après sa confirmation. |
Objet ligne de lines : kind (product | text), product_id, name, description, quantity, unit_price_ht, vat_rate, discount_pct, html. Les prix sont hors TVA, vat_rate en pour cent. Type text : bloc HTML simple filtré par liste blanche.
Envoi (send)
| Outil | Paramètres (* obligatoire) | Fonctionnalité requise | Rôle |
|---|---|---|---|
prepare_email | kind* customer | supplierparty_id* integerto stringsubject* stringbody_html* string | aucune | Aperçu d'un e-mail à un client ou fournisseur, uniquement vers une adresse de sa fiche. |
prepare_reminder | document_id* integerchannel* email | sms | bothsubject stringmessage stringsms_message string | Relances de paiement (+ Envoi de SMS si channel = sms ou both) | Aperçu d'une relance de facture impayée par e-mail, SMS ou les deux (crédits SMS vérifiés). |
Exécution
| Outil | Paramètres (* obligatoire) | Fonctionnalité requise | Rôle |
|---|---|---|---|
confirm_action | confirmation_token* string | aucune | Exécute une action préparée, uniquement après accord explicite de l'utilisateur sur l'aperçu. Jeton à usage unique. (MCP seulement) |
cancel_action | confirmation_token* string | aucune | Annule un aperçu en attente. (MCP seulement) |
Sujets de get_business_insights
| topic | Contenu | Fonctionnalité requise |
|---|---|---|
accounting | compte de résultat et bilan provisoires, caisse | Rapports détaillés |
vat | TVA due ou à récupérer, périodes | Gestion de la TVA |
bank | trésorerie bancaire et liaisons BankSync | aucune |
purchases | achats, fournisseurs et catégories de dépenses | aucune |
transactions | encaissements du mois par mode de paiement | aucune |
monthly_averages | chiffre d'affaires et dépenses moyens sur 12 mois | aucune |
fixed_charges | charges fixes récurrentes | aucune |
projections | projections financières et seuil de rentabilité | aucune |
payment_plans | plans de paiement | Plans de paiement |
credits | crédits en cours | Crédits |
leases | baux locatifs et loyers | Baux locatifs |
vehicles | véhicules et coût véhicule | Carnet de route |
social_contributions | cotisations sociales | Cotisations sociales |
tax_estimation | estimation fiscale | Estimation fiscale |
stock | stock réel | Gestion de stock |
nace | activités BCE (codes NACE) | aucune |
Types de documents
estimate, order, invoice, receipt, credit_note, proforma, purchase (achats, lecture seule).