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
- 64 outils répartis sur sept 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 Validation |
| 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 Validation |
| 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 Validation |
| Salaires | Parcourir le répertoire du personnel et enregistrer des positions salariales variables (heures, indemnités, bonus) sur les décomptes ouverts. | Lecture Validation |
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 ainsi qu'un lien vers la page de validation de KLARA MCP. C'est là que vous validez vous-même l'action, avec le code de votre application d'authentification ou avec une passkey (Touch ID, Face ID, Windows Hello). L'assistant ne reçoit à aucun moment un code ou un secret ; il n'exécute que ce que vous avez validé, même sur instruction tirée d'un document. La validation vaut pour cette action précise et est journalisée sur le serveur. Sur la page de validation, vous pouvez aussi rejeter l'action. Lors de la première connexion, vous configurez une fois l'application d'authentification (code QR) ; cela vaut pour votre clé API, même si vous connectez KLARA plus tard à un autre service d'IA. Autre navigateur ou autre appareil : saisissez-y une fois votre clé API. Chaque action n'est exécutée qu'une seule fois. Cela vaut pour chaque accès en écriture : les données de base (clients, contacts, adresses, articles, catégories, images) comme les suppressions, la création et l'envoi de factures, les écritures, les justificatifs, les positions salariales et les compteurs de numérotation. Les préparations non confirmées expirent d'elles-mêmes après 30 minutes.
Outils disponibles
KLARA MCP met 64 outils à disposition – chaque opération est un outil distinct. Lecture ne fait que consulter des données, Validation prépare l'action et nécessite votre validation dans le navigateur (code d'authentification ou passkey), Écriture n'agit que sur des préparations (abandon).
Contexte
| Outil | Fonction | Accès |
|---|---|---|
klara_whoami | Entreprise connectée, mode de connexion et domaines ouverts par votre rôle | Lecture |
Données de référence
| Outil | Fonction | Accès |
|---|---|---|
klara_accounts | Plan comptable – complet ou un compte par numéro | Lecture |
klara_account_picker | Sélection de comptes pour les lignes d'écriture, valeurs links incluses | Lecture |
klara_booking_types | Types d'écriture | Lecture |
klara_business_case_templates | Modèles de cas d'affaires – catalogue, sélection de l'entreprise ou un seul | Lecture |
klara_business_case | Un cas d'affaires par identifiant | Lecture |
klara_business_case_from_template | Lire le cas d'affaires dérivé d'un modèle (modèle d'écriture prêt, lecture seule) | Lecture |
klara_accounting_config | Paramètres comptables de l'entreprise | Lecture |
klara_financial_years | Exercices comptables de l'entreprise | Lecture |
klara_vat_master | Catalogue TVA – liste, uniquement en vigueur ou un seul | Lecture |
klara_vat_types | Types de TVA – liste ou un seul | Lecture |
klara_vat_cases | Cas de TVA (p. ex. TAXABLE_SUPPLY) – liste ou un seul | Lecture |
klara_vat_profile | Profil TVA de l'entreprise (mode de décompte, taux de la dette fiscale nette) | Lecture |
klara_vat_suggestions | Suggestions de TVA de KLARA | Lecture |
klara_company_vats | Taux de TVA enregistrés dans l'entreprise | Lecture |
klara_vat_included_setting | Si les prix sont gérés TVA incluse ou exclue | Lecture |
klara_bank_accounts | Comptes bancaires de l'entreprise | Lecture |
klara_exchange_rate | Cours de change d'une devise en CHF | Lecture |
klara_article_categories | Catégories d'articles – liste ou une seule | Lecture |
klara_article_filters | Filtres d'articles – liste ou un seul | Lecture |
klara_city | Une localité dans le répertoire des localités de KLARA | 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_create | Créer un client – y compris IDE, numéro TVA et registre du commerce | Validation |
klara_prepare_customer_update | Modifier un client – le serveur lit l'existant et ne remplace que les champs indiqués | Validation |
klara_prepare_customer_delete | Supprimer un client (définitif) | Validation |
klara_prepare_contact_create | Créer une personne de contact d'un client | Validation |
klara_prepare_contact_update | Modifier une personne de contact | Validation |
klara_prepare_contact_delete | Supprimer une personne de contact (définitif) | Validation |
klara_prepare_address_create | Créer une adresse supplémentaire d'un client | Validation |
klara_prepare_address_update | Modifier une adresse supplémentaire | Validation |
klara_prepare_address_delete | Supprimer une adresse supplémentaire (définitif) | Validation |
klara_prepare_article_create | Créer un article – y compris type, cas et code TVA | Validation |
klara_prepare_article_update | Modifier un article – le serveur reprend les champs obligatoires de l'existant | Validation |
klara_prepare_article_delete | Supprimer un article (définitif) | Validation |
klara_prepare_articles_bulk | Créer plusieurs articles en un seul appel | Validation |
klara_prepare_catalog_create | Créer une catégorie ou un filtre d'articles | Validation |
klara_prepare_catalog_update | Modifier une catégorie ou un filtre d'articles | Validation |
klara_prepare_catalog_delete | Supprimer une catégorie ou un filtre d'articles (définitif) | Validation |
klara_prepare_catalog_assign | Attribuer une catégorie ou un filtre à une liste d'articles | Validation |
klara_prepare_article_image_upload | Ajouter ou remplacer une image d'article (PNG/JPEG) | Validation |
klara_prepare_article_image_delete | Supprimer une image d'article (définitif) | Validation |
Factures et documents de commande
| Outil | Fonction | Accès |
|---|---|---|
klara_get_invoice | Une facture avec destinataire, positions et statut comptable | Lecture |
klara_list_invoices | Rechercher et parcourir les factures : texte libre, filtres par statut et état de paiement | 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 d'un numéro de commande | Lecture |
klara_order_numbering | Lire la configuration de numérotation (automatique ou manuelle) | Lecture |
klara_prepare_invoice | Créer une facture avec destinataire et positions, ou modifier un brouillon | Validation |
klara_prepare_send_invoice | Envoyer une facture comptabilisée : Smart Delivery ou canal fixe (e-mail, ePost, eBill, poste) | Validation |
klara_prepare_next_number | Tirer le prochain numéro de commande ou de document (avance le compteur de façon irréversible) | Validation |
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 | Validation |
klara_prepare_receipt_attachment | Joindre un justificatif PDF à une écriture existante | Validation |
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_file_check | Vérifier le fichier d'interface salaires – format et taille uniquement, jamais le contenu | Lecture |
klara_prepare_salary_item | Saisir une position salariale variable (heures, indemnités, bonus) sur un décompte ouvert | Validation |
Mécanisme de validation
| Outil | Fonction | Accès |
|---|---|---|
klara_pending_actions | Afficher les actions préparées mais pas encore confirmées | Lecture |
klara_confirm | Exécuter une action que vous avez validée sur la page de validation | Validation |
klara_cancel_pending | Abandonner définitivement 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. Le numéro AVS, la date de naissance, le numéro de personnel, le nombre d'enfants et le paiement en espèces sont supprimés de chaque réponse et n'atteignent jamais l'assistant IA. Les fichiers d'exportation des salaires ne renvoient que le format et la taille, leur contenu n'est jamais transmis via le connecteur. Dans les listes, les adresses e-mail sont masquées. Tout ce que vous consultez par ailleurs parvient à l'assistant en clair : noms et genres de salaire de vos collaboratrices et collaborateurs, données clients, positions de facture, textes des justificatifs.
- 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