Connecter votre assistant IA
Manisma peut se connecter à un assistant IA que vous utilisez déjà, comme Claude Desktop, Claude Code, l’application de bureau ChatGPT ou le Codex CLI. La connexion utilise le protocole ouvert Model Context Protocol. Vous pouvez alors poser des questions et effectuer du travail de planification dans la fenêtre de discussion de votre assistant.
Votre assistant, votre IA
C’est votre propre assistant qui réfléchit. Manisma fournit le planning et les données, mais n’exécute pas sa propre IA pour cette connexion. Elle ne consomme pas non plus les actions IA incluses dans votre abonnement Manisma.
Le bouton Proposition IA dans Manisma est distinct. Cette fonction utilise l’IA de Manisma et les actions IA de votre abonnement.
Ce que votre assistant peut faire
Votre assistant peut rechercher des ordres, clients, techniciens, matériaux, types de tâches et appareils. Il peut créer et modifier des ordres et des clients, planifier un ordre avec un technicien et demander une proposition de planification. Il ne peut jamais supprimer quoi que ce soit.
Créer une clé
Ouvrez Administration → Clés API, créez une clé et copiez-la immédiatement. Elle n’est affichée qu’une seule fois. La lecture, l’écriture et la planification sont des autorisations distinctes. Une clé en lecture seule peut donc rechercher des informations, mais ne peut rien modifier. Traitez la clé comme un mot de passe.
Installer la connexion
Toutes les méthodes nécessitent Node.js 22 ou une version plus récente. Vérifiez la version installée :
node --version
Récupérez la clé API dans Administration → Clés API. Elle n’est affichée
qu’une fois et se présente sous la forme msk_ suivi de 40 caractères
hexadécimaux. La lecture, l’écriture et la planification sont des droits distincts.
Méthode 1 : Claude Desktop
- Téléchargez https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb.
- Ouvrez le fichier téléchargé. Claude Desktop affiche une fenêtre d’installation.
- Collez la clé API lorsqu’elle est demandée. Elle est stockée de manière sécurisée.
Aucune modification de fichier et aucun terminal ne sont nécessaires.
Méthode 2 : Claude Code
- Téléchargez https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb.
- Ouvrez un terminal dans le dossier du téléchargement et exécutez :
unzip manisma-mcp-0.2.0.mcpb -d ~/manisma-mcp
claude mcp add manisma -e MANISMA_API_KEY=msk_your_key_here -- node ~/manisma-mcp/dist/index.js
- Remplacez
msk_your_key_herepar la clé API. - Dans Claude Code, utilisez la commande
/mcppour vérifier la connexion.
Méthode 3 : Codex CLI et l’application de bureau ChatGPT
- Téléchargez https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb.
- Ouvrez un terminal dans le dossier du téléchargement et décompressez-le :
unzip manisma-mcp-0.2.0.mcpb -d ~/manisma-mcp
- Ajoutez ce bloc à
~/.codex/config.tomlen remplaçant le chemin et la clé. Le chemin doit être absolu, car~n’est pas développé dans ce fichier.
[mcp_servers.manisma]
command = "node"
args = ["/home/you/manisma-mcp/dist/index.js"]
env = { MANISMA_API_KEY = "msk_your_key_here" }
- Exécutez
codex mcp list.manismadoit apparaître commeenabled.
Sous Windows, le fichier .mcpb est une archive ZIP. Si Windows ne peut pas
la décompresser, renommez l’extension en .zip et utilisez Extraire tout.
À quoi vous attendre
Votre assistant demande confirmation avant toute modification et traite un ordre à la fois. Une proposition de planification est d’abord affichée et n’est pas appliquée avant votre confirmation.
L’assistant ne peut pas voir les horaires de travail ni les jours de congé. Vérifiez donc une heure proposée par rapport au planning réel. Les propositions de planification sont limitées à quelques demandes par dix minutes.
Limites
La connexion fonctionne avec les données enregistrées dans Manisma. Elle ne remplace pas le tableau de planification et n’est à jour que selon ce qui a été enregistré.