Serveur MCP

Le Model Context Protocol est la façon dont un assistant (Claude, ChatGPT, Copilot, Cursor…) se branche sur des outils. @hela/mcp expose une entreprise Hela à un assistant : il peut lire les ventes, les créances, le stock, et — si vous l'y autorisez — rédiger un devis ou enregistrer un paiement.

Installer

npm install -g @hela/mcp

Ou, sans installer, npx @hela/mcp.

Configurer

Le serveur lit trois variables :

Variable	Rôle
HELA_API_URL	https://<votre-serveur>/v1
HELA_API_KEY	Une clé d'API. Ses portées bornent ce que l'assistant peut faire : une clé en lecture seule donne un assistant en lecture seule.
HELA_COMPANY_ID	L'entreprise.

Avec Claude Desktop, dans claude_desktop_config.json :

{
  "mcpServers": {
    "hela": {
      "command": "npx",
      "args": ["-y", "@hela/mcp"],
      "env": {
        "HELA_API_URL": "https://api.example.com/v1",
        "HELA_API_KEY": "hela_live_…",
        "HELA_COMPANY_ID": "4c1d…"
      }
    }
  }
}

Outils

Outil	Ce qu'il fait	Écrit ?
list_sales	Les ventes d'une période, filtrables par client, statut, établissement.	non
get_sale	Une vente et son détail.	non
get_receivables	Qui doit quoi, et depuis combien de temps.	non
low_stock	Les articles sous leur seuil.	non
daily_report	Le résumé d'une journée : ventes, encaissements, marge, caisse.	non
search_partners, search_items	Retrouver un client, un article.	non
create_quote	Rédiger un devis à partir de lignes et d'un client.	oui
record_payment	Enregistrer un paiement sur une facture.	oui
send_reminder	Envoyer un rappel pour une facture en retard.	oui

Les outils qui écrivent sont déclarés avec requires_confirmation : l'assistant doit vous montrer ce qu'il va faire et attendre votre accord. Avec une clé de test, ils sont présents mais le serveur répond forbidden — pratique pour essayer sans risque.

Ce que l'assistant voit

Les montants lui sont donnés déjà convertis en unité majeure avec la devise (« 125,00 USD ») ; il n'a pas à savoir que le franc n'a pas de décimales. Les identifiants techniques restent disponibles pour enchaîner les outils.

Le serveur ne garde rien : chaque appel va à l'API avec la clé fournie, et l'historique des documents porte « Clé API » comme auteur. Révoquer la clé coupe l'assistant.

Code source

packages/mcp dans le dépôt Hela. Licence MIT.