Passer au contenu principal

Agir sur vos données Spendesk avec l’IA - Write Tools MCP

Utilisez les Write Tools MCP de Spendesk pour créer, modifier, archiver et gérer certaines données Spendesk directement depuis votre assistant IA, avec les permissions et garde-fous appropriés.

Agir sur vos données Spendesk avec l’IA - Write Tools MCP

Le MCP Spendesk ne se limite plus à répondre à vos questions sur vos données financières.

Avec les Write Tools MCP, les utilisateurs autorisés peuvent demander à leur assistant IA d’effectuer certaines actions dans Spendesk, par exemple modifier des informations comptables, créer un fournisseur, gérer des champs analytiques ou préparer une dépense pour l’export.

Les Write Tools sont disponibles uniquement pour les actions prises en charge, et seulement lorsque l’utilisateur, l’organisation et la connexion MCP disposent des permissions nécessaires.

⚠️ Les Write Tools sont en bêta. Les permissions d’écriture sont désactivées par défaut : un Propriétaire du compte ou un Administrateur les active sur la connexion MCP, puis chaque utilisateur coche celles dont il a besoin au moment de se connecter. Les Write Tools peuvent modifier de vraies données Spendesk, et certaines actions sont irréversibles. Les Write Tools ne contournent pas vos permissions Spendesk, mais votre assistant IA peut tout de même mal interpréter une demande ou choisir une action que vous n’aviez pas prévue. N’activez que les permissions dont vous avez besoin, et vérifiez l’entité ciblée, l’objet, les champs, les valeurs et la réversibilité avant de confirmer une action. Les outils pris en charge et leur comportement peuvent évoluer pendant la bêta.

Remarque : les captures d’écran montrent Claude à titre d’exemple. Les mêmes étapes s’appliquent à ChatGPT, Dust et Langdock, avec leurs propres écrans.

Activer les Write Tools sur une connexion MCP existante

Les permissions d’écriture sont désactivées par défaut. Votre connexion MCP existante reste inchangée tant que vous n’activez pas explicitement les permissions dont vous avez besoin.

Organisation mono-entité

  1. Allez dans Paramètres → Intégrations → MCP.

  2. Sur la page MCP connections, cliquez sur Manage pour la connexion existante.

  3. Ouvrez l’onglet Permissions.

  4. Dans la colonne Access, activez les permissions d’écriture que vous souhaitez accorder.

  5. Cliquez sur Save.

  6. Si cela vous est demandé, confirmez la modification dans l’application mobile Spendesk.

L’onglet Permissions d’une connexion MCP dans Spendesk, avec la colonne Access

Organisation multi-entités

  1. Allez dans Multi-entity Hub → MCP.

  2. Cliquez sur Manage pour la connexion existante, puis suivez les mêmes étapes depuis l’onglet Permissions.

Ensuite, chaque utilisateur active les actions dont il a besoin

Activer des permissions d’écriture sur la connexion les rend disponibles ; cela ne les accorde encore à personne. Chaque Propriétaire du compte ou Contrôleur qui souhaite que l’assistant agisse :

  1. Reconnecte Spendesk dans son assistant IA (déconnexion puis nouvelle connexion).

  2. Sur l’écran d’autorisation Spendesk, coche les permissions d’écriture dont il a besoin. Les permissions d’écriture sont décochées par défaut ; les permissions de lecture restent cochées.

Actualiser la liste des outils dans l’assistant IA ne suffit pas : les nouvelles actions n’apparaissent qu’après la reconnexion.

L’utilisateur coche seulement la permission d’écriture nécessaire, ici Manage suppliers
Avec la lecture et Manage suppliers seulement, Claude voit 37 outils Spendesk au lieu de 62

ChatGPT Business et Enterprise : ChatGPT conserve la liste des outils telle qu’elle était lors de la publication de l’app dans votre espace de travail. Un administrateur de l’espace de travail doit actualiser l’app (Enterprise) ou la recréer et la republier (Business) pour que les Write Tools apparaissent.

Qui peut gérer l’accès ? Les Propriétaires du compte et les Administrateurs peuvent créer et gérer les connexions MCP et leurs permissions. Les Propriétaires du compte et les Contrôleurs peuvent utiliser le MCP (un Administrateur qui n’est ni l’un ni l’autre peut configurer une connexion, mais pas l’utiliser), dans la limite de leurs permissions Spendesk et des permissions qu’ils ont approuvées lors de la connexion. Vous n’avez pas besoin de générer de nouveaux identifiants OAuth ni de créer une nouvelle connexion au serveur MCP pour activer les Write Tools.

Que sont les Write Tools MCP ?

Les outils MCP connectent votre assistant IA à Spendesk.

Type d’outil

Ce qu’il permet de faire

Exemple

Read Tool

Rechercher, consulter ou analyser des données

« Affiche toutes les dépenses en retard »

Write Tool

Créer, modifier, archiver ou déclencher une action

« Modifie le centre de coûts de cette dépense »

Un Write Tool ne donne pas à votre assistant IA un accès illimité à Spendesk. Chaque action reste soumise à votre rôle et à vos permissions Spendesk, aux permissions accordées à la connexion MCP, au contexte de l’organisation et de l’entité, aux règles métier de Spendesk et aux permissions que vous avez approuvées lors de la connexion.

Avant d’utiliser un Write Tool

Lorsque votre assistant appelle un Write Tool, Spendesk vérifie les permissions activées sur la connexion et approuvées lors de votre connexion, votre rôle Spendesk, l’organisation et l’entité, ainsi que les règles métier de l’objet (par exemple, seul un fournisseur sans paiement, demande ni abonnement peut être archivé).

L’étape de confirmation dépend de votre assistant IA. Claude vous demande votre approbation avant chaque appel d’outil, sauf si vous avez réglé un outil sur Always allow. Dust, une fois connecté, appelle les outils sans vous demander à chaque fois. Les autres assistants ont leurs propres demandes d’approbation. Un aperçu ou une réponse en langage courant ne prouve pas que rien n’a été modifié : en cas de doute, vérifiez l’objet dans Spendesk ou dans l’Action log de la connexion. Pour savoir ce qu’un assistant IA peut encore mal faire et les bonnes habitudes à prendre avant de le laisser agir, consultez Utiliser les assistants IA avec Spendesk en toute sécurité.

Avant de confirmer une action, demandez à votre assistant IA d’indiquer :

  1. L’entité dans laquelle l’action sera exécutée.

  2. L’objet qui sera modifié.

  3. L’action qui sera effectuée.

  4. Les champs et valeurs qui seront concernés.

  5. Si l’action peut être annulée dans l’interface Spendesk.

  6. Où l’action peut être annulée, le cas échéant.

  7. Ce qui peut arriver aux données existantes ou déjà exportées.

Avant d’archiver un fournisseur, Claude montre ce qui va changer, dans quelle entité, et si l’action est réversible
Claude demande l’approbation avant l’action Archive supplier : choisissez Allow once

Exemple : « Avant d’exécuter cette action, indique-moi si elle peut être annulée dans l’interface Spendesk, où je peux l’annuler et quelles données peuvent être affectées. »

Réversibilité des Write Tools

Statut

Signification

✅ Peut être annulée

L’action peut être annulée, avec le même outil ou une action documentée.

⚠️ Pas d’annulation en un clic

Le résultat peut être corrigé avec une autre action, mais Spendesk ne propose pas de bouton d’annulation directe.

🛑 Pas d’annulation

L’action ne peut pas être annulée avec un outil MCP, et parfois pas non plus depuis l’interface Spendesk. Chaque ligne le précise : Pas d’annulation via MCP, Pas d’annulation dans l’interface ou Irréversible en pratique. Une intervention du Support ou une correction distincte peut être nécessaire.

Write Tools disponibles

Fournisseurs

Outil

Description

Peut-on l’annuler ?

Où et comment ?

Avertissement

create_suppliers

Crée un ou plusieurs fournisseurs, avec leurs informations générales et de paiement.

⚠️ Pas d’annulation en un clic

Archivez ensuite le fournisseur, s’il n’a ni paiement, ni demande, ni abonnement.

L’archivage est une action corrective, pas un véritable retour arrière. L’assistant ne renseigne que les coordonnées bancaires que vous avez fournies et confirmées à l’identique.

update_supplier

Modifie certains champs d’un fournisseur existant.

⚠️ Pas d’annulation en un clic

Modifiez à nouveau le fournisseur avec ses anciennes valeurs.

Les valeurs précédentes peuvent ne pas être disponibles pour l’utilisateur.

archive_supplier

Archive ou restaure un fournisseur tout en conservant son historique.

✅ Peut être annulée

Demandez à l’assistant de le désarchiver, ou dans Spendesk allez dans Paramètres → Accounts payable → Archived, sélectionnez le fournisseur et cliquez sur Un-archive suppliers.

Seuls les fournisseurs sans paiement, demande ni abonnement peuvent être archivés.

Claude confirme le résultat : un fournisseur mis à jour, aucun ignoré, aucun échec
Restauration du fournisseur avec le même outil : il est de nouveau actif, avec ses données inchangées

Plan comptable

Outil

Description

Peut-on l’annuler ?

Où et comment ?

Avertissement

create_accounts

Crée des comptes dans le plan comptable de l’entreprise.

⚠️ Pas d’annulation en un clic

Archivez ensuite le compte (delete_accounts l’archive).

Non disponible lorsque votre plan comptable est géré par votre intégration comptable : effectuez la modification dans votre logiciel comptable.

update_accounts

Modifie des comptes existants du plan comptable.

⚠️ Pas d’annulation en un clic

Modifiez à nouveau le compte avec ses anciennes valeurs.

Non disponible lorsque votre plan comptable est géré par votre intégration comptable.

delete_accounts

Archive un compte du plan comptable (il n’est pas supprimé définitivement).

✅ Peut être annulée

Demandez à l’assistant de le désarchiver (update_accounts le réactive).

Non disponible lorsque votre plan comptable est géré par votre intégration comptable.

Champs analytiques

Outil

Description

Peut-on l’annuler ?

Où et comment ?

Avertissement

create_analytical_field

Crée une dimension analytique définie par l’entreprise.

⚠️ Pas d’annulation en un clic

Supprimez-le ensuite (delete_analytical_field l’archive).

Les classifications existantes peuvent être affectées.

update_analytical_field

Modifie la configuration d’un champ analytique.

⚠️ Pas d’annulation en un clic

Modifiez à nouveau le champ avec ses anciennes valeurs.

Aucun retour automatique aux valeurs précédentes n’est disponible.

delete_analytical_field

Supprime ou archive un champ analytique.

🛑 Pas d’annulation via MCP

Aucun outil MCP ne permet de le restaurer.

Le champ est supprimé logiquement, mais ses valeurs ne le sont pas. Elles restent isolées et ne peuvent plus être gérées individuellement.

create_analytical_field_value

Ajoute une valeur à un champ analytique.

⚠️ Pas d’annulation en un clic

Supprimez-la ensuite (delete_analytical_field_value l’archive).

La valeur peut déjà être utilisée sur des paiements.

update_analytical_field_value

Modifie une valeur de champ analytique.

⚠️ Pas d’annulation en un clic

Modifiez à nouveau la valeur avec sa valeur précédente.

Un renommage peut affecter les sélections et le reporting futurs.

delete_analytical_field_value

Supprime une valeur de champ analytique.

🛑 Pas d’annulation via MCP

Aucun outil MCP ne permet de la restaurer.

Vérifiez la valeur et son utilisation avant de confirmer la suppression.

Catégories de dépenses

Outil

Description

Peut-on l’annuler ?

Où et comment ?

Avertissement

create_expense_category_field

Crée le champ de catégories de dépenses de l’entreprise.

⚠️ Pas d’annulation en un clic

Supprimez-le ensuite (delete_expense_category_field), ce qui supprime aussi ses catégories.

Une entreprise n’a qu’un seul champ de catégories de dépenses.

update_expense_category_field

Modifie la configuration du champ de catégories de dépenses.

⚠️ Pas d’annulation en un clic

Modifiez à nouveau la configuration avec ses anciennes valeurs.

Vérifiez si le champ est obligatoire avant de le modifier.

delete_expense_category_field

Supprime le champ de catégories de dépenses et ses catégories.

🛑 Pas d’annulation via MCP

Aucun outil MCP ne permet de le restaurer.

Cette action supprime toutes les catégories rattachées au champ.

create_expense_category

Crée une catégorie de dépenses proposée aux employés.

⚠️ Pas d’annulation en un clic

Supprimez-la ensuite (delete_expense_category l’archive).

La catégorie peut déjà être utilisée sur des paiements.

update_expense_category

Modifie une catégorie de dépenses et ses liens de classification.

⚠️ Pas d’annulation en un clic

Modifiez à nouveau la catégorie avec ses anciennes valeurs.

Un renommage peut modifier les libellés des dépenses exportées.

delete_expense_category

Supprime ou archive une catégorie de dépenses.

🛑 Pas d’annulation via MCP

Aucun outil MCP ne permet de la restaurer.

Vérifiez la catégorie et son utilisation avant de confirmer la suppression.

Dépenses et règlements

Outil

Description

Peut-on l’annuler ?

Où et comment ?

Avertissement

update_payable

Modifie les informations comptables d’une dépense existante.

⚠️ Pas d’annulation en un clic

Modifiez à nouveau la dépense avec ses anciennes valeurs.

La mise à jour des lignes peut remplacer plusieurs champs comptables à la fois.

mark_payable_as_ready

Fait passer une dépense de toPrepare à toExport (prête pour l’export comptable).

✅ Peut être annulée, dans Spendesk

Allez dans Bookkeep → Export, sélectionnez la dépense et renvoyez-la dans Prepare. Aucun outil MCP ne le fait.

La dépense doit disposer d’informations comptables complètes.

mark_payable_as_exported_manually

Enregistre qu’une dépense a été exportée en dehors de Spendesk.

🛑 Pas d’annulation dans l’interface actuellement

Aucune annulation en libre-service n’est documentée. Contactez le Support si une correction est nécessaire.

N’utilisez cette action que si la dépense a réellement été exportée en dehors de Spendesk.

mark_settlement_as_exported_manually

Enregistre qu’un règlement a été traité en dehors de Spendesk.

🛑 Irréversible en pratique

Aucun outil MCP ne permet de sortir un règlement de l’état exporté.

Vérifiez que le règlement a bien été traité en dehors de Spendesk avant d’utiliser cet outil.

Bons de commande

Outil

Description

Peut-on l’annuler ?

Où et comment ?

Avertissement

create_purchase_order

Crée un bon de commande et l’engagement de dépense correspondant.

⚠️ Pas d’annulation en un clic

Annulez le bon de commande s’il est encore éligible.

L’annulation est une étape distincte du cycle de vie, pas un retour arrière.

cancel_purchase_order

Annule un bon de commande ouvert.

🛑 Pas d’annulation dans l’interface

Aucune action d’annulation directe n’est disponible.

Cette action est irréversible.

close_purchase_order

Clôture un bon de commande terminé.

🛑 Pas d’annulation dans l’interface

Aucune action d’annulation directe n’est disponible.

Cette action est irréversible. La clôture remplace aussi le montant du bon de commande par le montant facturé : le montant approuvé à l’origine ne peut plus être retrouvé.

Exports comptables

La permission Gérer les exports comptables permet aussi à l’assistant de télécharger un export et de lister vos modèles de journaux.

Outil

Description

Peut-on l’annuler ?

Où et comment ?

Avertissement

create_accounting_export

Génère un journal d’achats ou de banque pour une période de 31 jours maximum.

✅ Aperçu : rien ne change · 🛑 Validé : aucun retour arrière

Par défaut, l’export est un aperçu et ne modifie aucun statut comptable. Il n’est validé que si vous le demandez explicitement.

Un export validé marque comme exportés les dépenses et règlements inclus. Vérifiez la période et le type de journal avant de valider, et ne le lancez pas deux fois.

Pour les développeurs et les revues de sécurité, la référence des outils MCP liste chaque outil avec sa permission, et Using the AI assistant safely explique ce qui vous protège (en anglais). Assistant actions and safety détaille ce que change chaque action et ce que Spendesk impose (en anglais).

Comment utiliser les Write Tools efficacement

Identifiez clairement l’objet

Indiquez le nom ou l’identifiant de l’objet que vous souhaitez modifier.

Bon exemple : « Modifie la dépense pay_12345. »

Décrivez explicitement l’action

Soyez précis sur l’opération à effectuer.

« Archive le fournisseur supplier_123. »

Demandez d’abord un aperçu

« Montre-moi ce qui changerait sur cette dépense, mais ne la modifie pas encore. »

Demandez si l’action peut être annulée

« Avant d’exécuter cette action, indique-moi si elle peut être annulée dans l’interface Spendesk, où je peux l’annuler et quelles données peuvent être affectées. »

Demandez une confirmation après l’action

« Confirme que la dépense a bien été modifiée et affiche-moi ses champs comptables actuels. »

Limites importantes

Une action corrective n’est pas toujours un retour arrière

Archiver un objet, le modifier à nouveau ou recréer une valeur supprimée ne restaure pas nécessairement l’état précédent à l’identique. En particulier, certains outils de suppression n’ont pas d’outil de restauration MCP, même lorsque l’enregistrement existe toujours dans la base de données.

Si le tableau ci-dessus n’indique pas d’annulation directe, vérifiez soigneusement l’impact avant de confirmer.

Certaines actions sont irréversibles

Par exemple : marquer une dépense ou un règlement comme exporté manuellement, annuler ou clôturer un bon de commande, supprimer un champ analytique ou une valeur, supprimer une catégorie de dépenses ou le champ de catégories, et valider un export comptable.

Avertissement : vérifiez soigneusement ces actions avant de les confirmer. Si une action a été effectuée par erreur, contactez le Support Spendesk en indiquant l’identifiant de l’objet, l’action réalisée, l’heure approximative de l’exécution et l’identifiant de corrélation (correlation ID) affiché dans l’Action log.

Les actions sur plusieurs éléments peuvent réussir partiellement

Certains outils traitent plusieurs éléments en un seul appel — par exemple create_suppliers et update_accounts — et peuvent réussir pour certains éléments et échouer pour d’autres. Vérifiez toujours la liste des résultats renvoyée par votre assistant IA, puis contrôlez les éléments dans Spendesk.

L’impact peut dépendre de l’état des données

  • Les données historiques déjà exportées conservent la valeur utilisée au moment de l’export.

  • Les enregistrements encore en préparation peuvent perdre une valeur supprimée ou modifiée.

  • Les futures transactions peuvent ne plus proposer une valeur archivée ou supprimée.

Permissions et accès

Les Write Tools ne sont disponibles que si la permission d’écriture est activée sur la connexion MCP et approuvée par l’utilisateur lors de la connexion, si le rôle Spendesk de l’utilisateur autorise l’opération (Propriétaire du compte ou Contrôleur), et si l’objet est éligible à l’action demandée.

Le MCP ne contourne pas les permissions Spendesk. Votre assistant IA ne peut pas s’accorder d’accès supplémentaire ni utiliser un outil qui n’est pas disponible pour votre connexion.

Organisations multi-entités

Avec une connexion au niveau de l’organisation, chaque action cible une seule entité : votre assistant doit la nommer à chaque appel, et il ne peut agir que dans les entités actives où vous êtes Propriétaire du compte ou Contrôleur. Avant de confirmer une écriture, demandez à l’assistant dans quelle entité il va agir. L’Action log enregistre l’entité de chaque appel.

Sécurité et contrôle

  • Les actions sont limitées à votre organisation et à vos entités autorisées.

  • Chaque action est effectuée au nom de l’utilisateur Spendesk connecté : chaque utilisateur autorise la connexion avec ses propres identifiants Spendesk, et le MCP n’a aucune identité partagée ou anonyme.

  • Les permissions Spendesk continuent de s’appliquer.

  • La connexion MCP ne peut pas étendre ses propres permissions.

  • Les actions sensibles doivent être vérifiées avant confirmation.

  • Les identifiants OAuth doivent être conservés de manière sécurisée et ne jamais être collés dans une conversation avec une IA.

  • Chaque appel d’outil — lectures comme actions — est enregistré dans l’Action log de la connexion dans Spendesk (Manage → Action log) : date, outil, statut, utilisateur et entité. Les Propriétaires du compte et les Administrateurs peuvent le consulter. L’Action log n’indique pas les champs ni les valeurs modifiés : pour voir ce qui a changé sur un objet, ouvrez-le dans Spendesk.

  • Gardez l’approbation activée pour les Write Tools dans votre assistant : dans Claude, choisissez Allow once plutôt que Always allow pour les actions.

  • Un Propriétaire du compte ou un Administrateur peut supprimer la connexion depuis sa page dans Spendesk (Manage → Remove).

L’Action log enregistre l’appel Archive Supplier avec sa date, son statut, l’utilisateur, l’entité et l’identifiant de corrélation

Exemples de prompts

Modifier une dépense

« Affiche les champs comptables de la dépense pay_12345. Je veux remplacer son centre de coûts par Marketing, mais ne fais encore aucune modification. Indique-moi aussi si ce changement peut être annulé dans l’interface Spendesk. »

Créer un fournisseur

« Crée un fournisseur nommé Acme Ltd avec les informations suivantes. Montre-moi d’abord les données qui seront créées, indique-moi comment corriger l’action si besoin, puis demande-moi confirmation. »

Gérer un champ analytique

« Ajoute Germany comme valeur au champ analytique Business Unit. Avant de le faire, indique-moi si cette nouvelle valeur pourra être supprimée ou restaurée par la suite. »

Modifier une catégorie de dépenses

« Renomme la catégorie de dépenses Software en Software and AI Tools. Montre-moi les enregistrements et la configuration qui peuvent être affectés, et indique-moi si cette modification peut être annulée dans Spendesk. »

Créer un bon de commande

« Crée un bon de commande pour Acme Ltd de 12 000 €, du 1er octobre 2026 au 31 décembre 2026. Ne le crée pas avant ma confirmation. Indique-moi aussi si le bon de commande pourra ensuite être annulé ou rouvert. »

Préparer un export comptable

« Prépare l’export comptable des achats de septembre 2026. Avant de le lancer, montre-moi la période, le type de journal, les écritures incluses et si cette action peut être annulée. »

Foire aux questions

Le MCP peut-il modifier mes données Spendesk ?

Oui. Les Write Tools autorisés peuvent créer, modifier, archiver ou déclencher certaines opérations dans Spendesk.

Tous les utilisateurs peuvent-ils utiliser les Write Tools ?

Non. Seuls les Propriétaires du compte et les Contrôleurs peuvent les utiliser, et uniquement pour les actions dont la permission d’écriture est activée sur la connexion MCP et approuvée lors de leur connexion.

Le MCP peut-il modifier n’importe quel objet Spendesk ?

Non. Les Write Tools sont disponibles uniquement pour les objets et actions listés dans cet article. L’assistant ne peut pas approuver ou refuser des demandes ou des factures, payer une facture ou programmer un paiement, créer ou modifier des cartes, des utilisateurs ou des centres de coûts, ni consulter des budgets. mark_payable_as_ready rend une dépense prête pour l’export comptable : ce n’est pas une approbation. Voir Qu'est-ce que l'assistant ne peut pas faire ? dans le guide de démarrage.

Puis-je annuler une action ?

Cela dépend de l’action. Cet article indique si une annulation directe est possible et comment la faire.

Quelle est la différence entre une annulation et une action corrective ?

Une annulation restaure l’état précédent grâce à une action dédiée. Une action corrective réalise une nouvelle opération pour compenser ou modifier le résultat ; elle ne restaure pas nécessairement l’état précédent à l’identique.

Que faire si une action ne peut pas être annulée ?

N’effectuez pas l’action si vous n’êtes pas certain qu’elle est correcte. Si elle a déjà été réalisée par erreur, contactez le Support Spendesk en indiquant le nom de l’outil, l’identifiant de l’objet, l’action effectuée, les valeurs soumises, l’heure approximative de l’exécution et l’identifiant de corrélation (correlation ID) affiché dans l’Action log.

Pourquoi mon action Write Tool a-t-elle échoué ?

Les raisons les plus fréquentes sont : des permissions manquantes (la permission d’écriture n’est pas activée sur la connexion, ou vous ne l’avez pas cochée lors de la connexion — reconnectez-vous et cochez-la), un identifiant d’objet invalide, un statut d’objet incompatible, un objet modifié depuis sa dernière consultation, ou des informations manquantes ou invalides.

Avez-vous trouvé la réponse à votre question ?