Aperçu
KLARA MCP est un serveur basé sur le protocole ouvert Model Context Protocol (MCP), exploité par ePost Service SA. Il relie les assistants IA compatibles MCP – par exemple Claude ou ChatGPT – à votre mandant KLARA. L'assistant peut ainsi rechercher et gérer clients et articles, créer des factures avec positions et destinataire, saisir des écritures avec justificatifs et enregistrer des positions salariales variables sur les décomptes de salaire ouverts.
- Adresse du serveur :
https://mcp.klara.ch/mcp - Transport : Streamable HTTP · Connexion : OAuth 2.0 avec clé API KLARA personnelle
- 34 outils répartis sur quatre domaines, voir Outils disponibles
Connexion
Étape 1 pour tous les clients : créer une clé API dans KLARA. Dans KLARA, sous Utilisateurs, créez une nouvelle clé API. Ne lui attribuez que les rôles dont vous avez réellement besoin – KLARA MCP accède exactement à ce que le rôle de la clé ouvre. La connexion fonctionne exclusivement avec une clé API ; ne saisissez votre mot de passe KLARA que sur KLARA, jamais ailleurs.
Connexion avec Claude
- Dans Claude, sous Paramètres → Connecteurs, choisissez Ajouter un connecteur personnalisé et saisissez
https://mcp.klara.ch/mcp– ou sélectionnez l'entrée KLARA dans le répertoire des connecteurs. - Claude ouvre la page de connexion KLARA MCP : collez la clé API et connectez-vous.
Connexion avec ChatGPT
- Ouvrez chatgpt.com/plugins et cliquez sur le plus « Nouveau plugin ». Saisissez l'adresse
https://mcp.klara.ch/mcp. - Lors de la première connexion, la page de connexion KLARA MCP s'ouvre : collez la clé API et connectez-vous.
Commencez par le prompt « KLARA whoami » – l'assistant vous montre alors à quelle entreprise vous êtes connecté et quels domaines votre rôle ouvre.
Exemples
Voici à quoi ressemblent des demandes typiques à votre assistant IA (toutes les données sont fictives) :
Fonctionnalités
| Domaine | Ce que l'assistant peut faire | Accès |
|---|---|---|
| Clients & articles | Rechercher, créer et modifier : clients avec adresses, contacts, IDE et numéro TVA ; articles avec prix, TVA et images ; catégories et filtres. | Lecture Écriture |
| Factures & commandes | Créer des factures avec positions et destinataire, les récupérer en PDF ; envoi par e-mail, ePost, eBill ou poste ; consulter les documents de commande. | Lecture Code |
| Comptabilité | Saisir des écritures manuelles avec justificatifs, consulter le plan comptable et les catalogues TVA, lire les positions ouvertes du rapprochement bancaire et les décomptes TVA. | Lecture Code |
| Salaires | Parcourir le répertoire du personnel et enregistrer des positions salariales variables (heures, indemnités, bonus) sur les décomptes ouverts. | Lecture Code |
Le mécanisme de confirmation
Tout ce qui est irréversible se déroule en deux étapes : l'assistant prépare l'action et vous présente un récapitulatif avec un code de confirmation à usage unique. L'exécution n'a lieu que lorsque vous indiquez le code – et chaque action une seule fois. Cela vaut toujours pour : les suppressions, la création et l'envoi de factures, les écritures, les justificatifs, les positions salariales, les compteurs de numérotation, les données de base de l'entreprise et les abonnements. Les préparations non confirmées expirent d'elles-mêmes après 30 minutes.
Outils disponibles
KLARA MCP met 34 outils à disposition. Lecture ne fait que consulter des données, Écriture s'exécute directement, Code nécessite votre confirmation avec le code à usage unique.
Contexte et données de référence
| Outil | Fonction | Accès |
|---|---|---|
klara_whoami | Entreprise connectée, mode de connexion et domaines ouverts par votre rôle | Lecture |
klara_reference_data | Plan comptable, catalogues et cas de TVA, types d'écriture, modèles, comptes bancaires, cours de change, localités, catégories et filtres d'articles | Lecture |
Clients et articles
| Outil | Fonction | Accès |
|---|---|---|
klara_search_customers | Rechercher des clients par nom, e-mail, téléphone ou numéro de client | Lecture |
klara_get_customer | Un client en détail, avec contacts et adresses supplémentaires sur demande | Lecture |
klara_search_articles | Articles par recherche plein texte ou liste par type de produit | Lecture |
klara_article_details | Un article avec variantes, composants de set et image | Lecture |
klara_lookup_articles | Articles par numéros d'article ou en liste de variantes résolue | Lecture |
klara_prepare_customer | Créer ou modifier un client – y compris IDE, numéro TVA et registre du commerce | Écriture Suppression : code |
klara_prepare_customer_contact | Créer ou modifier une personne de contact d'un client | Écriture Suppression : code |
klara_prepare_customer_address | Créer ou modifier une adresse supplémentaire d'un client | Écriture Suppression : code |
klara_prepare_article | Créer ou modifier un article – y compris type, cas et code TVA | Écriture Suppression : code |
klara_prepare_articles_bulk | Créer plusieurs articles en un seul appel | Écriture |
klara_prepare_article_catalog | Créer et modifier des catégories et filtres d'articles, les attribuer aux articles | Écriture Suppression : code |
klara_prepare_article_image | Ajouter ou remplacer une image d'article (PNG/JPEG) | Écriture Suppression : code |
Factures et documents de commande
| Outil | Fonction | Accès |
|---|---|---|
klara_get_invoice | Une facture avec destinataire, positions et statut comptable | Lecture |
klara_recent_invoices | Journal des factures créées via KLARA MCP (l'API KLARA n'a pas de liste de factures) | Lecture |
klara_invoice_pdf | Récupérer la facture en PDF et en extraire le texte | Lecture |
klara_order_documents | Consulter les documents de commande et la configuration de numérotation | Lecture |
klara_prepare_invoice | Créer une facture avec destinataire et positions, ou modifier un brouillon | Code |
klara_prepare_send_invoice | Envoyer une facture comptabilisée : Smart Delivery ou canal fixe (e-mail, ePost, eBill, poste) | Code |
klara_prepare_next_number | Tirer le prochain numéro de commande ou de document (avance le compteur de façon irréversible) | Code |
Comptabilité
| Outil | Fonction | Accès |
|---|---|---|
klara_bank_open_positions | Positions ouvertes du rapprochement bancaire | Lecture |
klara_vat_report | Lire le décompte TVA d'une période (sans recalcul) | Lecture |
klara_prepare_booking | Saisir une écriture manuelle, avec justificatif PDF sur demande ; débit/crédit vérifié au préalable | Code |
klara_prepare_receipt_attachment | Joindre un justificatif PDF à une écriture existante | Code |
Salaires
| Outil | Fonction | Accès |
|---|---|---|
klara_search_employees | Répertoire du personnel avec recherche, filtres et tri | Lecture |
klara_addable_salary_items | Quels genres de salaire sont admis sur le décompte de salaire ouvert d'une personne | Lecture |
klara_payroll_export | Générer le fichier d'interface salaires (contenu uniquement sur demande explicite) | Lecture |
klara_prepare_salary_item | Saisir une position salariale variable (heures, indemnités, bonus) sur un décompte ouvert | Code |
Entreprise et mécanisme de confirmation
| Outil | Fonction | Accès |
|---|---|---|
klara_prepare_profile | Modifier ou créer les données de base de votre propre entreprise | Code |
klara_prepare_subscription | Créer un abonnement KLARA (payant, conditions contractuelles propres) | Code |
klara_pending_actions | Afficher les actions préparées mais pas encore confirmées | Lecture |
klara_confirm | Exécuter une action préparée avec le code de confirmation | Code |
klara_cancel_pending | Abandonner une action préparée | Écriture |
Sécurité & données
- Connexion via OAuth 2.0, exclusivement avec clé API. L'assistant IA ne reçoit jamais votre clé API KLARA – elle reste chiffrée sur le serveur KLARA MCP (exploité par ePost Service SA, hébergé à Francfort) et ne sert qu'aux appels vers KLARA. Il n'existe volontairement pas de connexion par nom d'utilisateur et mot de passe KLARA : votre mot de passe n'a sa place que sur la page de connexion de KLARA.
- Votre rôle détermine l'accès. KLARA MCP accède exactement aux domaines que le rôle de votre clé API ouvre dans KLARA – pas davantage.
- Minimisation des données. Les numéros AVS, dates de naissance et numéros de personnel ne quittent jamais le serveur. Dans les listes, les adresses e-mail sont masquées. Les fichiers d'exportation des salaires ne renvoient par défaut que le format et la taille, pas le contenu.
- Ce que voit l'assistant IA. Les résultats des outils – par exemple les clients trouvés ou un récapitulatif de facture – alimentent votre conversation et sont traités par le fournisseur concerné (p. ex. Anthropic ou OpenAI) comme le reste de vos contenus de chat.
- Service complémentaire facultatif. Le connecteur IA ne fait pas partie de l'utilisation normale de KLARA – vous l'activez délibérément et choisissez vous-même le service IA auquel vous connectez KLARA. Le fournisseur choisi traite les contenus consultés selon ses propres conditions, le cas échéant en dehors de la Suisse. La page de connexion le signale lors de la connexion.
- Délais de suppression. Les liens de connexion et codes à usage unique sont supprimés à leur expiration. Les contenus de justificatifs des actions préparées sont effacés immédiatement après exécution, annulation ou expiration, leurs récapitulatifs après 30 jours. Les connexions inutilisées pendant 180 jours sont supprimées avec la clé API chiffrée ; le journal des factures après un an.
- Protection des données. Vous trouverez les détails du traitement des données chez KLARA dans la déclaration de protection des données.
- Mettre fin à l'accès. Supprimez la clé API dans KLARA sous Utilisateurs – l'accès prend fin immédiatement et complètement. Vous pouvez en plus retirer le connecteur dans votre assistant IA.
Dépannage
« Accès refusé » ou un domaine manque
Le rôle de votre clé API n'a pas l'autorisation nécessaire, ou votre entreprise n'a pas l'abonnement KLARA correspondant – sans abonnement, une fonction reste fermée même pour les administrateurs. Demandez à l'assistant « KLARA whoami » : la réponse montre quels domaines sont ouverts. Pour plus d'accès, créez dans KLARA sous Utilisateurs une clé avec le rôle approprié et reconnectez-vous.
Une localité est refusée à la création
KLARA vérifie les localités dans son propre répertoire et n'en connaît certaines qu'avec le canton – par exemple « Studen BE » au lieu de « Studen ». Adaptez l'orthographe et réessayez ; le message d'erreur le signale.
La création de facture exige un numéro de document
Votre entreprise numérote les factures manuellement. KLARA MCP ne tire alors volontairement aucun numéro du compteur – indiquez à l'assistant le prochain numéro de votre série, il sera repris comme numéro de document. En numérotation automatique, cela se fait tout seul.
Aucun PDF de facture lors de la comptabilisation
C'est le comportement de l'API KLARA : contrairement à l'interface, elle ne génère pas de document lors de la comptabilisation. Demandez ensuite à l'assistant de créer le PDF – sur demande, il le joint ensuite à l'écriture.
Les nouvelles fonctions n'apparaissent pas
Les assistants IA mémorisent la liste des outils d'un serveur lors de la connexion. Après une mise à jour de KLARA MCP, déconnectez-vous une fois et reconnectez-vous.
La première réponse tarde
Après une pause prolongée, le serveur redémarre (démarrage à froid). La première requête peut donc prendre quelques secondes, ensuite c'est rapide.
« Cette action n'est plus valable »
Les actions préparées expirent après 30 minutes sans confirmation – par sécurité. Demandez simplement à l'assistant de préparer l'action à nouveau.
Erreur serveur avec identifiant d'incident lors de la comptabilisation, du PDF ou de l'envoi
Erreurs connues de l'interface KLARA (état : août 2026, signalées à KLARA) : la comptabilisation des factures, le rendu PDF et l'envoi peuvent échouer via l'interface avec une erreur serveur, alors que la même action fonctionne dans l'interface KLARA. Effectuez l'action dans KLARA ; l'identifiant d'incident du message aide le support.
Support
Questions, problèmes ou préoccupations de sécurité concernant KLARA MCP : support@klara.ch
Utile pour une réponse rapide : le message d'erreur de votre assistant IA – en cas d'erreur KLARA, il contient un identifiant d'incident qui rend le cas univoque. Ne joignez jamais de clés API ni de mots de passe.
En savoir plus sur KLARA : klara.ch · Pour les développeuses et développeurs : developer.klara.ch