GestSup MCP

Serveur MCP (Model Context Protocol) pour piloter les tickets GestSup depuis un agent LLM (Claude Desktop, Claude Code, etc.), accompagné d'une documentation complète de l'API REST GestSup.

Sommaire

Related MCP server: GLPI MCP

Outils MCP exposés

Périmètre = ce que l'API GestSup permet réellement (création de ticket, commentaires, lecture). La modification d'état, l'affectation et la gestion des équipements ne sont pas exposées par l'API GestSup (cf. la doc).

Pré-requis côté GestSup

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

2. Une clé d'API générée (longue chaîne hexadécimale).

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.

Installation

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"
      }
    }
  }
}

Développement & tests

npm run typecheck   # vérification des types
npm test            # tests unitaires (vitest, sans instance GestSup)
npm run dev         # compilation en watch

Inspecter le serveur avec l'outil officiel :

npx @modelcontextprotocol/inspector node dist/index.js

Notes importantes

• Version de l'API : la doc et le client sont basés sur GestSup 3.2.55 (la 3.2.60 visée n'a pas pu être téléchargée — gestsup.fr bloqué par la politique réseau ; source = mirroir public DeltaForce53/gestsup-3.2.55). L'API évolue très peu entre versions mineures ; voir la section « Écarts possibles 3.2.55 → 3.2.60 » de la doc pour les points à revalider.

• Le serveur gomme les pièges de l'API : décodage HTML des textes, pagination par numéro de page (masque le offset non trivial), gestion fine des erreurs 403/404/405, kill-switch d'écriture.

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

Licence

MIT.