GestSup MCP

Serveur MCP (Model Context Protocol) pour piloter les tickets GestSup depuis un agent LLM (Claude Desktop, etc.), accompagné d'un plugin serveur GestSup qui ajoute les endpoints manquants (recherche + écritures) et d'une documentation de l'API REST GestSup.

Sommaire

Related MCP server: GLPI MCP

Outils MCP exposés

🔌 = nécessite le plugin serveur gestsup_mcp installé et activé.

Lecture

Écriture

Toutes les écritures répliquent la logique native de GestSup et réutilisent son mailer : les notifications partent exactement selon tes paramètres (mail_auto_*). Aucune valeur de liste n'est codée en dur : les ids (états, priorités, catégories, techniciens, procédures…) sont lus de ton instance et validés. L'identité de l'acteur = GESTSUP_DEFAULT_USER_ID.

Documentation (Obsidian)

📓 = activé uniquement si un vault est configuré (OBSIDIAN_VAULT_PATH).

L'accès au vault est par fichiers (lecture/écriture directe des .md) : aucune dépendance à l'app Obsidian ni à un plugin tiers, donc compatible avec n'importe quel client MCP (Hermes agent, Claude Desktop…). gestsup_document_ticket avertit si le ticket est jugé pauvre (verdict + manques) mais documente quand même si demandé — c'est au LLM de décider. Anti path-traversal, écrasement jamais silencieux (mode explicite), kill-switch OBSIDIAN_ALLOW_WRITES.

Vault sur un serveur de fichiers (SMB/NFS…). Comme l'accès est par fichiers, il suffit de monter le partage sur la machine du MCP et de pointer OBSIDIAN_VAULT_PATH sur le dossier monté (aucun client SMB embarqué, donc rien de fragile). Au démarrage, le serveur vérifie que le vault est joignable et le signale ; si le partage est démonté, les outils de doc renvoient un message clair (« vault injoignable — partage monté ? ») sans planter les outils GestSup. Procédure de montage (Linux/macOS/Windows) dans le guide de démarrage.

Recherche dans les deux sens. De la doc vers la solution : obsidian_search retrouve un problème/solution déjà consigné. Du ticket vers la doc : gestsup_suggest_documentation (et la réponse de gestsup_close_ticket quand un vault est configuré) propose de documenter en fin de ticket, mais détecte d'abord si un cas similaire avec la même résolution est déjà en doc — auquel cas il invite à ne pas créer de doublon (ou à compléter la note existante). La détection de similarité est lexicale, déterministe et explicable ; le LLM tranche.

Scénarios d'assistant (exemples)

Une fois branché, tu pilotes GestSup en langage naturel ; l'assistant combine les outils :

• Point quotidien sur mes tickets : « Fais le point sur mes tickets ouverts » → gestsup_search_tickets(technician_id=<moi>, exclude_state_ids=[<résolu/rejeté>]) puis synthèse (les ids d'états viennent de gestsup_list_referential kind=state).

• Résumé d'un ticket : « Résume le ticket 1234 » → gestsup_get_ticket.

• Tickets d'un demandeur : « Où en sont les tickets de Marie ? » → gestsup_find_tickets_by_user / gestsup_search_tickets(requester_id=…).

• « Point infra » d'équipe : gestsup_search_tickets filtré par technicien(s)/groupe.

• Agir : commenter, noter en interne, changer l'état/résoudre, affecter, mettre à jour (catégorie/priorité/temps), clôturer (conforme), créer un ticket.

• Chercher une solution dans la doc : « A-t-on déjà eu ce souci d'imprimante ? » → obsidian_search (puis obsidian_read_note pour la fiche complète).

• Capitaliser depuis un ticket : « Le ticket 1234 mérite-t-il d'être documenté ? » → gestsup_assess_ticket_quality ; si oui, « Documente-le » → gestsup_document_ticket (article KB dans le vault). L'outil prévient si le ticket est trop pauvre.

• Proposition en fin de ticket (anti-doublon) : après une clôture, gestsup_suggest_documentation (ou directement la réponse de gestsup_close_ticket) propose de documenter — sauf si un cas similaire avec la même résolution est déjà en doc, où il invite à compléter la note existante plutôt qu'à en créer une.

• Documenter une conversation : « Note dans la doc la procédure d'accès VPN » → obsidian_write_note / obsidian_append_section (sans ticket source).

• Enrichir au fil du temps : « Ajoute à la note imprimante le cas du toner Lyon » → obsidian_append_section(path, heading, content).

Compatibilité clients MCP (Hermes, etc.)

Les outils de documentation sont conçus pour fonctionner avec n'importe quel client MCP, Hermes agent en cible : transport stdio standard, schémas d'outils classiques, résultats texte + JSON (pas de dépendance aux fonctionnalités MCP optionnelles resources/prompts/sampling que certains clients ne gèrent pas). L'accès au vault se fait par fichiers, sans exiger qu'Obsidian soit lancé : il suffit que le serveur MCP ait accès au dossier du vault.

Pré-requis côté GestSup

1. API activée : Administration → Paramètres → Connecteurs → onglet API.

2. Une clé d'API générée.

3. Accès en HTTPS (l'API refuse tout port ≠ 443).

4. Si une liste blanche d'IP est configurée, l'IP du serveur MCP doit y figurer.

5. Pour les outils 🔌 : le plugin gestsup_mcp installé et activé (voir plugin/gestsup_mcp/README.md).

Installation (serveur MCP)

npm install
npm run build

Configuration

Variables d'environnement (voir .env.example) :

Brancher sur Claude Desktop

Dans claude_desktop_config.json :

{
  "mcpServers": {
    "gestsup": {
      "command": "node",
      "args": ["/chemin/absolu/vers/Gestsup-mcp/dist/index.js"],
      "env": {
        "GESTSUP_BASE_URL": "https://support.exemple.fr",
        "GESTSUP_API_KEY": "votre-cle",
        "GESTSUP_DEFAULT_USER_ID": "1"
      }
    }
  }
}

Sous Windows, utilisez des / dans le chemin (ou doublez les \\). La version Microsoft Store de Claude Desktop lit sa config dans %LOCALAPPDATA%\Packages\Claude_*\LocalCache\Roaming\Claude\ (pas dans %APPDATA%\Claude\).

Tester en local sans risque (Docker)

Le dossier docker/ monte une instance GestSup jetable (données d'exemple, plugin auto-installé et activé) :

cd docker
./fetch-source.sh
docker compose up -d --build

Interface web : http://localhost:8080 (admin / admin). Détails et branchement du MCP : README du stack. Revalidation bout-en-bout : test-integration/.

Développement & tests

npm run typecheck     # types
npm run lint          # ESLint
npm run format        # Prettier (écriture) ; format:check pour vérifier
npm test              # tests unitaires (vitest, réseau simulé)
npm run build         # compilation
npm run dev           # compilation en watch

CI : .github/workflows/ci.yml lance lint, format, typecheck, tests et build (Node) + un lint de syntaxe PHP du plugin, à chaque push et pull request.

Inspecter le serveur : npx @modelcontextprotocol/inspector node dist/index.js.

Notes

• Version de référence : GestSup 3.2.55 (source = mirroir public DeltaForce53/gestsup-3.2.55). Pour suivre une montée de version, voir le runbook.

• Le serveur gomme les pièges de l'API : décodage HTML, pagination par numéro de page, gestion des erreurs 403/404/405, kill-switch d'écriture.

• La clé d'API n'est jamais journalisée.

Licence

MIT.