Hiflow MCP : connectez votre assistant IA à Hiflow

Hiflow MCP est un serveur Model Context Protocol (MCP) pour l'API de Hiflow, publié sur npm sous le nom hiflow-mcp.

Concrètement, il expose la plateforme Hiflow sous forme d'outils que les assistants IA (Claude Desktop, Claude Code, Cursor et tout client compatible MCP) peuvent appeler pour consulter et gérer vos données : clients, devis, factures de vente et d'achat, catalogue d'articles, projets, tâches, timesheets, trackers, utilisateurs, rapports et tableau de bord d'activité.

Vous pouvez ainsi demander à votre assistant des choses comme : « Liste mes factures impayées », « Crée un devis pour le client X » ou « Encode 2 h de prestations sur le projet Y ».

Prérequis

• Node.js 18 ou supérieur ;
• un compte Hiflow et une clé d'API ;
• le sous-domaine de votre compte : la partie avant .hiflow.net dans votre URL (pour masociete.hiflow.net, le sous-domaine est masociete).

Obtenir votre clé d'API

1. Connectez-vous à Hiflow.
2. Ouvrez le module Paramètres → Clés API.
3. Créez une clé et copiez le jeton.

Voir aussi : Créer une clé d'API.

Configuration

Le serveur lit deux variables d'environnement :

Variable	Description	Exemple
HIFLOW_ACCOUNT	Le sous-domaine de votre compte	masociete
HIFLOW_TOKEN	Votre jeton d'API (Bearer)	xxxxxxxx

Claude Desktop / Cursor

Ajoutez ceci à votre configuration MCP (claude_desktop_config.json ou l'équivalent de votre client) :

{
  "mcpServers": {
    "hiflow": {
      "command": "npx",
      "args": ["-y", "hiflow-mcp"],
      "env": {
        "HIFLOW_ACCOUNT": "votre-sous-domaine",
        "HIFLOW_TOKEN": "votre-jeton-api"
      }
    }
  }
}

Claude Code

claude mcp add hiflow \
  -e HIFLOW_ACCOUNT=votre-sous-domaine \
  -e HIFLOW_TOKEN=votre-jeton-api \
  -- npx -y hiflow-mcp

Une fois la configuration en place, redémarrez votre client : les outils Hiflow sont disponibles immédiatement.

Les outils disponibles

Le serveur expose 49 outils, préfixés hiflow_ et regroupés par ressource :

Ressource	Outils
Clients	lister, consulter, créer, modifier, supprimer, contacts, formes juridiques, types de TVA
Devis	lister, consulter, créer, modifier, supprimer, statuts, unités
Factures de vente	lister, consulter, créer, supprimer, statuts, types de TVA
Factures d'achat	lister, consulter, créer, supprimer, statuts de paiement
Catalogue d'articles	lister, créer, dossiers
Projets	lister, consulter, créer, modifier, supprimer, statuts
Tâches	lister, consulter, créer, modifier, supprimer, historique, statuts, priorités, utilisateurs, tags, trackers
Timesheets	lister, consulter, créer, modifier, supprimer, envoi du bon de prestations
Trackers	lister, consulter, créer, supprimer
Utilisateurs	lister, consulter, créer
Rapports	lister, exécuter
Activité	tableau de bord

Sécurité et bonnes pratiques

Le serveur tourne entièrement sur votre machine. Votre sous-domaine et votre jeton restent dans la configuration locale de votre client MCP et ne sont envoyés qu'à votre instance Hiflow — il n'y a aucun backend hébergé. Le code source est publié sous licence MIT et librement consultable.

Quelques recommandations :

• Traitez votre jeton d'API comme un mot de passe : ne le partagez pas et ne le committez jamais dans un dépôt git.
• Créez une clé d'API dédiée à cette intégration, que vous pourrez révoquer indépendamment à tout moment.
• Certains outils effectuent des opérations d'écriture et de suppression (clients, factures, tâches, timesheets…). Un assistant IA configuré avec ce serveur peut donc modifier ou supprimer des données réelles.