GLPI MCP
GLPI MCP is an MCP server that lets an AI assistant query and manage a GLPI 10/11 instance through its REST API.
Tickets: list, get, search, create, update, delete, link/unlink view, and merge tickets, with status/type/priority/category/assignee filters and pagination.
Followups: list, get, add, update, and delete ticket followups, including public/private visibility.
Tasks: list, add, update, and delete ticket tasks with status, duration, assignee, and privacy controls.
Solutions: read and post ticket solutions, optionally specifying a solution type; posting may close the ticket per GLPI configuration.
Statistics: report tickets by status, type, priority, category, and assignee, plus average resolution time and SLA-overdue tickets.
Knowledge base: list/get/search articles, create/update articles, list KB categories, and read/add/update profile and group visibility rules.
Reference data: list ITIL categories, GLPI users, and GLPI groups.
Suppliers, contacts, contracts: list suppliers; create/update/delete suppliers, contacts, and contracts; optionally attach contacts/contracts to suppliers. Deletion trashes by default with optional permanent purge.
Session: gracefully close the active GLPI session.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@GLPI MCP Show me open high-priority tickets"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
GLPI MCP
Français
Serveur MCP (Model Context Protocol) permettant à un assistant IA — comme Claude — d'interagir directement avec votre instance GLPI via son API REST.
Compatible GLPI 10 (endpoint apirest.php) et GLPI 11 (endpoint api.php/v1).
Une fois configuré, Claude peut consulter, créer et mettre à jour des tickets, ajouter des suivis et des tâches, poster des solutions, gérer la base de connaissances, tenir le registre des fournisseurs, contacts et contrats, et produire des statistiques, le tout en langage naturel depuis votre conversation.
Prérequis
1. GLPI
GLPI 10.x ou 11.x (l'API REST est activée par défaut)
L'API REST doit être activée : Configuration → Générale → API → Activer l'API Rest → Oui
Un App-Token créé dans GLPI : Configuration → Générale → API → Ajouter un client API
Un User-Token associé à votre compte : Mon profil → API → Régénérer
⚠️ Le compte associé au User-Token doit avoir les droits suffisants sur les tickets dans GLPI (lecture, écriture, suppression selon l'usage souhaité).
2. Python
Python 3.12 ou supérieur
uv (recommandé)
# Vérifier la version Python
python --version
# Installer uv si nécessaire
pip install uv3. Claude Desktop
Claude Desktop installé sur votre machine
Un compte Claude avec accès aux intégrations MCP (plan Pro ou supérieur)
Related MCP server: mcp-otobo
Installation
1. Cloner le dépôt
git clone https://github.com/svtica/glpi-mcp.git
cd glpi-mcp2. Installer les dépendances
uv syncConfiguration (par utilisateur)
Le serveur lit ses credentials depuis un fichier config.json situé dans le même dossier que server.py. Ce fichier est individuel à chaque utilisateur et ne doit jamais être versionné (il est dans .gitignore).
Créer votre config.json
Copiez le fichier exemple et renseignez vos valeurs :
cp config.example.json config.jsonLes valeurs doivent être encodées en base64 :
PowerShell :
[Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes("https://glpi.monentreprise.ca"))Linux / macOS :
echo -n "https://glpi.monentreprise.ca" | base64Renseignez ensuite les champs dans config.json :
Champ | Description |
| URL de base de votre instance GLPI (sans |
| App-Token créé dans la configuration API GLPI |
| User-Token de votre compte GLPI |
| Langue des libellés : |
| Version GLPI : |
| Validation du certificat TLS de GLPI : |
Vous pouvez aussi utiliser des variables d'environnement (
GLPI_URL,GLPI_APP_TOKEN,GLPI_USER_TOKEN,GLPI_LANG,GLPI_VERSION,GLPI_VERIFY_TLS) à la place du fichierconfig.json.
⚠️
VERIFY_TLSvautfalsepar défaut, ce qui désactive la validation du certificat de votre instance GLPI. C'est le réglage prévu pour un GLPI intranet derrière un certificat auto-signé ou une AC privée absente du magasincertifide Python. Passez àtruedès que l'AC interne est distribuée àcertifi: sur un GLPI accessible hors du réseau interne, laisserfalseexpose la connexion — et donc vos jetons d'API — à une interception.
Versions GLPI supportées
Version | Endpoint API | Authentification |
GLPI 10 |
| App-Token + User-Token → Session-Token |
GLPI 11 |
| App-Token + User-Token → Session-Token (même mécanisme) |
Le champ GLPI_VERSION détermine quel préfixe d'endpoint est utilisé. Les deux versions utilisent la même authentification par session (initSession). Tous les outils sont compatibles avec les deux versions.
Intégration avec Claude Desktop
Méthode 1 — Claude Extensions (recommandée)
Copiez le contenu du projet dans votre dossier Claude Extensions :
%APPDATA%\Claude\Claude Extensions\ant.dir.svtica.glpi-mcp\Créez-y votre config.json personnel avec vos credentials (voir section précédente).
Le dossier doit contenir un fichier manifest.json :
{
"manifest_version": "0.2",
"name": "GLPI-MCP",
"version": "0.1.0",
"description": "Serveur MCP pour l'integration GLPI",
"author": { "name": "Votre Nom", "url": "" },
"server": {
"type": "python",
"entry_point": "server.py",
"mcp_config": {
"command": "uv",
"args": ["--directory", "${__dirname}", "run", "python", "server.py"]
}
}
}Redémarrez Claude Desktop. Chaque utilisateur de la machine copie ses propres fichiers dans son dossier %APPDATA% avec son propre config.json.
Méthode 2 — claude_desktop_config.json (manuelle)
Ouvrez le fichier de configuration de Claude Desktop :
Windows :
%APPDATA%\Claude\claude_desktop_config.jsonmacOS :
~/Library/Application Support/Claude/claude_desktop_config.json
Ajoutez la section mcpServers :
Windows
{
"mcpServers": {
"glpi": {
"command": "uv",
"args": [
"--directory",
"C:\\Chemin\\vers\\glpi-mcp",
"run",
"python",
"server.py"
]
}
},
"preferences": {
"coworkScheduledTasksEnabled": false,
"sidebarMode": "code"
}
}macOS / Linux
{
"mcpServers": {
"glpi": {
"command": "uv",
"args": [
"--directory",
"/chemin/vers/glpi-mcp",
"run",
"python",
"server.py"
]
}
}
}⚠️ Assurez-vous que le JSON est valide — une accolade ou une virgule manquante suffit à empêcher Claude Desktop de charger la configuration. Utilisez un validateur JSON si nécessaire.
Redémarrez Claude Desktop. Si la configuration est correcte, une icône 🔌 apparaîtra dans la barre d'outils de Claude indiquant que le serveur MCP est connecté.
Outils disponibles
🔐 Session
Outil | Description |
| Ferme proprement la session GLPI active |
🎫 Tickets
Outil | Description |
| Liste les tickets avec pagination et filtres (statut, type) |
| Détail complet d'un ticket avec libellés lisibles |
| Recherche avancée par mots-clés, statut, type, catégorie, assigné |
| Crée un nouveau ticket (option |
| Modifie les champs d'un ticket existant |
| Supprime un ticket |
| Lie deux tickets entre eux (lié, doublon, enfant, parent) |
| Liste tous les liens d'un ticket |
| Fusionne des tickets source vers un ticket cible (copie suivis, lie comme doublon, ferme les sources) |
💬 Suivis
Outil | Description |
| Liste tous les suivis d'un ticket |
| Détail d'un suivi |
| Ajoute un suivi (public ou privé) |
| Modifie un suivi existant (contenu, visibilité) |
| Supprime un suivi — destructif, retire la pièce de la piste d'audit |
✅ Tâches
Outil | Description |
| Liste les tâches d'un ticket |
| Crée une tâche sur un ticket |
| Modifie une tâche (statut, durée, assigné) |
| Supprime une tâche |
💡 Solutions
Outil | Description |
| Lit la solution d'un ticket |
| Poste une solution (clôture le ticket selon la config GLPI) |
📊 Statistiques
Outil | Description |
| Nombre de tickets par statut |
| Répartition Incidents / Demandes de service |
| Tickets ouverts par priorité |
| Nombre de tickets par catégorie ITIL |
| Tickets par technicien assigné |
| Délai moyen de résolution des tickets |
| Tickets en retard par rapport au SLA |
📚 Base de connaissances
Outil | Description |
| Liste les articles avec pagination. Si |
| Détail complet d'un article |
| Recherche par mots-clés (titre par défaut ; passer |
| Crée un nouvel article (titre, contenu HTML, catégorie, FAQ) |
| Met à jour un article existant |
| Liste les catégories de la base de connaissances |
| Lit les règles de visibilité d'un article (profils, groupes, utilisateurs, entités) |
| Ajoute un profil à la visibilité d'un article |
| Ajoute un groupe à la visibilité d'un article |
| Modifie une règle de visibilité par profil existante |
| Modifie une règle de visibilité par groupe existante |
Note : La suppression de règles de visibilité n'est pas exposée volontairement afin de conserver un historique des procédures même obsolètes.
📋 Référentiels
Outil | Description |
| Liste les catégories ITIL disponibles |
| Liste les utilisateurs GLPI |
| Liste les groupes GLPI |
🏢 Fournisseurs, contacts et contrats
Outil | Description |
| Liste les fournisseurs (filtre |
| Crée un fournisseur ( |
| Crée un contact ; rattachement optionnel à un fournisseur via |
| Crée un contrat ; rattachement optionnel à un fournisseur via |
| Met à jour un fournisseur ( |
| Met à jour un contact |
| Met à jour un contrat |
| Met un fournisseur à la corbeille ; |
| Met un contact à la corbeille ; |
| Met un contrat à la corbeille ; |
Note :
list_suppliersfiltre sur les fournisseurs actifs par défaut. Passeronly_active=Falsepour inclure les fournisseurs désactivés.
Note : Pour
create_contract, les champsduration,notice,periodicityetbillings'expriment en mois (convention GLPI), etbegin_dateau formatAAAA-MM-JJ.
Note : Quand
supplier_idest fourni, l'entrée de liaison (Contact_Supplier/Contract_Supplier) est créée dans un second appel et son résultat est retourné sous la clé_supplier_link. Si la création du contact ou du contrat échoue, aucune liaison n'est tentée.
⚠️ Suppression — corbeille par défaut, purge sur demande. Sans argument,
delete_*place l'élément à la corbeille GLPI (is_deleted = 1) : il reste rattaché à ses contrats, contacts, matériels et tickets, et se restaure avec l'outilupdate_*correspondant et{"is_deleted": 0}. Avecpurge=True, la suppression est définitive et irréversible et casse ces rattachements. Réserver la purge aux doublons et aux saisies erronées.
Exemples d'utilisation avec Claude
« Montre-moi tous les incidents ouverts en haute priorité »
« Crée un ticket de demande de service pour l'installation d'Adobe Acrobat pour Marie Tremblay »
« Ajoute un suivi sur le ticket #4521 pour informer l'utilisateur que le problème est en cours d'investigation »
« Fusionne les tickets #4530 et #4531 vers le ticket #4521 »
« Lie le ticket #4530 au ticket #4521 comme doublon »
« Quelles sont les statistiques de tickets par statut ? »
« Quel est le délai moyen de résolution des tickets ? »
« Montre-moi les tickets en retard par rapport au SLA »
« Cherche dans la base de connaissances une solution pour les problèmes VPN »
« Qui peut voir l'article #120 de la base de connaissances ? »
« Ajoute le groupe Techniciens à la visibilité de l'article #120 »
« Quels fournisseurs avons-nous pour la téléphonie ? »
« Ajoute Acme Télécom au registre des fournisseurs, puis crée le contrat d'entretien CT-2026-014 qui débute le 1er avril pour 36 mois »
« Désactive le fournisseur Acme Télécom — on ne fait plus affaire avec eux, mais garde l'historique des contrats »
« Clôture le ticket #4102 avec comme solution : redémarrage du service résolvant le problème »
Mappings de référence
Statuts
Code | Libellé |
1 | Nouveau |
2 | En cours (attribué) |
3 | En cours (planifié) |
4 | En attente |
5 | Résolu |
6 | Clos |
Types
Code | Libellé |
1 | Incident |
2 | Demande de service |
Priorités / Urgences / Impacts
Code | Libellé |
1 | Très basse |
2 | Basse |
3 | Moyenne |
4 | Haute |
5 | Très haute |
6 | Majeure |
Types de liens entre tickets
Code | Libellé |
1 | Lié à |
2 | Duplique |
3 | Enfant de |
4 | Parent de |
Dépannage
Le serveur n'apparaît pas dans Claude Desktop
Vérifiez la syntaxe JSON du fichier de configuration (pas de virgule manquante ou en trop, pas d'accolade en trop)
Vérifiez que le chemin vers le dossier est correct et absolu
Redémarrez complètement Claude Desktop
Assurez-vous que le dossier
%APPDATA%\Claude\connectors\existe (créez-le si nécessaire)
Erreur 401 à chaque appel
Vérifiez que
GLPI_APP_TOKENetGLPI_USER_TOKENsont corrects dans votreconfig.jsonVérifiez que l'API REST est bien activée dans GLPI
Vérifiez que le client API dans GLPI est actif et que l'IP est autorisée
Erreur de connexion / timeout
Vérifiez que
GLPI_URLest accessible depuis la machine qui exécute le serveurVérifiez qu'aucun pare-feu ne bloque la connexion
Toutes les requêtes HTTP ont un délai maximal de 30 secondes (10 s pour la connexion). Au-delà, l'outil retourne un dict structuré avec les clés
erroretdetail(libellés tirés de la tableLANG) au lieu de pendre — par défaut en français :{"error": "Timeout HTTP", "detail": "Requête > 30s — voir GLPI logs"}. Si vous obtenez ce message de façon répétée, vérifiez les logs PHP-FPM/MySQL côté GLPI : la requête sous-jacente est probablement trop coûteuse (souvent une recherche full-text sans index).
Environnement corporatif — Proxy SSL intercepteur (Zscaler, Forcepoint, etc.)
En environnement d'entreprise, un proxy SSL peut intercepter les connexions HTTPS et remplacer les certificats par un certificat interne. Cela provoque l'erreur suivante lors de l'installation des dépendances par uv :
× Failed to download `python-dotenv==X.X.X`
╰─▶ invalid peer certificate: UnknownIssuerSolution : Forcer uv à utiliser le magasin de certificats Windows avec la variable d'environnement UV_NATIVE_TLS.
Pour tester manuellement dans PowerShell :
$env:UV_NATIVE_TLS=1
uv run python server.pyPour que Claude Desktop passe automatiquement cette variable au démarrage du serveur, ajoutez une section env dans votre claude_desktop_config.json :
{
"mcpServers": {
"glpi": {
"command": "uv",
"args": [
"--directory",
"C:\\Chemin\\vers\\glpi-mcp",
"run",
"python",
"server.py"
],
"env": {
"UV_NATIVE_TLS": "1"
}
}
}
}Environnement corporatif — Antivirus / EDR bloquant uv (Riskware)
Certains antivirus ou solutions EDR d'entreprise peuvent catégoriser uv.exe comme Riskware car il télécharge des exécutables et des packages depuis Internet. Si uv est bloqué par votre solution de sécurité :
Contactez votre équipe TI pour qu'elle ajoute une exception pour
uv.exe(situé dans%USERPROFILE%\.local\bin\uv.exe)Demandez également d'autoriser les domaines :
pypi.org,files.pythonhosted.org,astral.sh
En alternative, demandez à un collègue ayant uv fonctionnel de vous transmettre le dossier .venv déjà généré, ce qui évite tout téléchargement.
Alléger les dépendances
Le projet dépend de mcp[cli] qui inclut l'extra [cli] (typer, rich, click, shellingham, pygments, markdown-it-py…). Cet extra fournit les commandes de développement mcp dev et mcp inspect, utiles pour le débogage.
Si vous souhaitez réduire l'empreinte en production (environ 8 packages en moins), modifiez pyproject.toml :
# Avant (avec outillage CLI)
dependencies = ["mcp[cli]>=1.9.4", "httpx>=0.27"]
# Après (sans outillage CLI — production allégée)
dependencies = ["mcp>=1.9.4", "httpx>=0.27"]Puis relancez uv sync pour mettre à jour l'environnement.
English
MCP (Model Context Protocol) server that allows an AI assistant — such as Claude — to interact directly with your GLPI instance via its REST API.
Compatible with GLPI 10 (endpoint apirest.php) and GLPI 11 (endpoint api.php/v1).
Once configured, Claude can view, create and update tickets, add followups and tasks, post solutions, manage the knowledge base, maintain the supplier, contact and contract registry, and generate statistics, all in natural language from your conversation.
Prerequisites
1. GLPI
GLPI 10.x or 11.x (REST API is enabled by default)
REST API must be enabled: Setup → General → API → Enable Rest API → Yes
An App-Token created in GLPI: Setup → General → API → Add an API client
A User-Token associated with your account: My profile → API → Regenerate
⚠️ The account associated with the User-Token must have sufficient permissions on tickets in GLPI (read, write, delete as needed).
2. Python
Python 3.12 or higher
uv (recommended)
# Check Python version
python --version
# Install uv if needed
pip install uv3. Claude Desktop
Claude Desktop installed on your machine
A Claude account with access to MCP integrations (Pro plan or higher)
Installation
1. Clone the repository
git clone https://github.com/svtica/glpi-mcp.git
cd glpi-mcp2. Install dependencies
uv syncConfiguration (per user)
The server reads its credentials from a config.json file located in the same folder as server.py. This file is individual to each user and must never be version-controlled (it is in .gitignore).
Create your config.json
Copy the example file and fill in your values:
cp config.example.json config.jsonValues must be encoded in base64:
PowerShell:
[Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes("https://glpi.mycompany.com"))Linux / macOS:
echo -n "https://glpi.mycompany.com" | base64Then fill in the fields in config.json:
Field | Description |
| Base URL of your GLPI instance (without trailing |
| App-Token created in GLPI API configuration |
| User-Token from your GLPI account |
| Label language: |
| GLPI version: |
| Validate the GLPI TLS certificate: |
You can also use environment variables (
GLPI_URL,GLPI_APP_TOKEN,GLPI_USER_TOKEN,GLPI_LANG,GLPI_VERSION,GLPI_VERIFY_TLS) instead of theconfig.jsonfile.
⚠️
VERIFY_TLSdefaults tofalse, which disables certificate validation for your GLPI instance. That is the intended setting for an intranet GLPI behind a self-signed certificate or a private CA missing from Python'scertifibundle. Switch it totrueas soon as the internal CA is distributed tocertifi: on a GLPI reachable from outside the internal network, leaving itfalseexposes the connection — and therefore your API tokens — to interception.
Supported GLPI versions
Version | API Endpoint | Authentication |
GLPI 10 |
| App-Token + User-Token → Session-Token |
GLPI 11 |
| App-Token + User-Token → Session-Token (same mechanism) |
The GLPI_VERSION field determines which endpoint prefix is used. Both versions use the same session-based authentication (initSession). All tools are compatible with both versions.
Integration with Claude Desktop
Method 1 — Claude Extensions (recommended)
Copy the project contents to your Claude Extensions folder:
%APPDATA%\Claude\Claude Extensions\ant.dir.svtica.glpi-mcp\Create your personal config.json with your credentials (see previous section).
The folder must contain a manifest.json file:
{
"manifest_version": "0.2",
"name": "GLPI-MCP",
"version": "0.1.0",
"description": "MCP server for GLPI integration",
"author": { "name": "Your Name", "url": "" },
"server": {
"type": "python",
"entry_point": "server.py",
"mcp_config": {
"command": "uv",
"args": ["--directory", "${__dirname}", "run", "python", "server.py"]
}
}
}Restart Claude Desktop. Each user on the machine copies their own files to their %APPDATA% folder with their own config.json.
Method 2 — claude_desktop_config.json (manual)
Open the Claude Desktop configuration file:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Add the mcpServers section:
Windows
{
"mcpServers": {
"glpi": {
"command": "uv",
"args": [
"--directory",
"C:\\Path\\to\\glpi-mcp",
"run",
"python",
"server.py"
]
}
},
"preferences": {
"coworkScheduledTasksEnabled": false,
"sidebarMode": "code"
}
}macOS / Linux
{
"mcpServers": {
"glpi": {
"command": "uv",
"args": [
"--directory",
"/path/to/glpi-mcp",
"run",
"python",
"server.py"
]
}
}
}⚠️ Make sure the JSON is valid — a missing brace or comma is enough to prevent Claude Desktop from loading the configuration. Use a JSON validator if needed.
Restart Claude Desktop. If the configuration is correct, a 🔌 icon will appear in the Claude toolbar indicating the MCP server is connected.
Available tools
🔐 Session
Tool | Description |
| Gracefully closes the active GLPI session |
🎫 Tickets
Tool | Description |
| List tickets with pagination and filters (status, type) |
| Full ticket details with readable labels |
| Advanced search by keywords, status, type, category, assignee |
| Create a new ticket (optional |
| Update fields of an existing ticket |
| Delete a ticket |
| Link two tickets (linked, duplicate, child, parent) |
| List all links for a ticket |
| Merge source tickets into a target (copies followups, links as duplicate, closes sources) |
💬 Followups
Tool | Description |
| List all followups for a ticket |
| Followup details |
| Add a followup (public or private) |
| Update an existing followup (content, visibility) |
| Delete a followup — destructive, removes it from the audit trail |
✅ Tasks
Tool | Description |
| List tasks for a ticket |
| Create a task on a ticket |
| Update a task (status, duration, assignee) |
| Delete a task |
💡 Solutions
Tool | Description |
| Read the solution for a ticket |
| Post a solution (closes the ticket per GLPI config) |
📊 Statistics
Tool | Description |
| Ticket count by status |
| Incidents vs Service Requests breakdown |
| Open tickets by priority |
| Ticket count by ITIL category |
| Tickets per assigned technician |
| Average ticket resolution time |
| Tickets overdue against SLA |
📚 Knowledge Base
Tool | Description |
| List articles with pagination. If |
| Full article details |
| Search by keywords (title only by default ; pass |
| Create a new article (title, HTML content, category, FAQ) |
| Update an existing article |
| List knowledge base categories |
| Read visibility rules for an article (profiles, groups, users, entities) |
| Add a profile to an article's visibility |
| Add a group to an article's visibility |
| Update an existing profile visibility rule |
| Update an existing group visibility rule |
Note: Deleting visibility rules is intentionally not exposed in order to preserve a history of procedures, even obsolete ones.
📋 Reference data
Tool | Description |
| List available ITIL categories |
| List GLPI users |
| List GLPI groups |
🏢 Suppliers, contacts and contracts
Tool | Description |
| List suppliers ( |
| Create a supplier ( |
| Create a contact; optionally attach it to a supplier via |
| Create a contract; optionally attach it to a supplier via |
| Update a supplier ( |
| Update a contact |
| Update a contract |
| Move a supplier to the trash; |
| Move a contact to the trash; |
| Move a contract to the trash; |
Note:
list_suppliersreturns active suppliers only by default. Passonly_active=Falseto include disabled ones.
Note: For
create_contract, theduration,notice,periodicityandbillingfields are expressed in months (GLPI convention), andbegin_dateuses theYYYY-MM-DDformat.
Note: When
supplier_idis provided, the junction entry (Contact_Supplier/Contract_Supplier) is created in a second call and its result is returned under the_supplier_linkkey. If the contact or contract creation fails, no link is attempted.
⚠️ Deletion — trash by default, purge on request. With no argument,
delete_*moves the item to the GLPI trash (is_deleted = 1): it stays attached to its contracts, contacts, assets and tickets, and can be restored with the matchingupdate_*tool and{"is_deleted": 0}. Withpurge=True, deletion is permanent and irreversible and breaks those attachments. Reserve purging for duplicates and data-entry mistakes.
Usage examples with Claude
"Show me all open high-priority incidents"
"Create a service request ticket for installing Adobe Acrobat for Jane Smith"
"Add a followup to ticket #4521 to inform the user that the issue is being investigated"
"Merge tickets #4530 and #4531 into ticket #4521"
"Link ticket #4530 to ticket #4521 as a duplicate"
"What are the ticket statistics by status?"
"What is the average ticket resolution time?"
"Show me tickets that are overdue against the SLA"
"Search the knowledge base for VPN troubleshooting solutions"
"Who can see knowledge base article #120?"
"Add the Technicians group to the visibility of article #120"
"Which suppliers do we have for telephony?"
"Add Acme Telecom to the supplier registry, then create maintenance contract CT-2026-014 starting April 1st for 36 months"
"Deactivate the Acme Telecom supplier — we no longer do business with them, but keep the contract history"
"Close ticket #4102 with the solution: service restart resolved the issue"
Reference mappings
Statuses
Code | Label (fr) | Label (en) |
1 | Nouveau | New |
2 | En cours (attribué) | In progress (assigned) |
3 | En cours (planifié) | In progress (planned) |
4 | En attente | Pending |
5 | Résolu | Solved |
6 | Clos | Closed |
Types
Code | Label (fr) | Label (en) |
1 | Incident | Incident |
2 | Demande de service | Service request |
Priorities / Urgencies / Impacts
Code | Label (fr) | Label (en) |
1 | Très basse | Very low |
2 | Basse | Low |
3 | Moyenne | Medium |
4 | Haute | High |
5 | Très haute | Very high |
6 | Majeure | Major |
Ticket link types
Code | Label (fr) | Label (en) |
1 | Lié à | Linked to |
2 | Duplique | Duplicates |
3 | Enfant de | Child of |
4 | Parent de | Parent of |
Troubleshooting
Server does not appear in Claude Desktop
Check the JSON syntax of the configuration file (no missing or extra commas/braces)
Verify the folder path is correct and absolute
Fully restart Claude Desktop
Make sure the
%APPDATA%\Claude\connectors\folder exists (create it if needed)
401 error on every call
Verify that
GLPI_APP_TOKENandGLPI_USER_TOKENare correct in yourconfig.jsonCheck that the REST API is enabled in GLPI
Verify that the API client in GLPI is active and the IP is authorized
Connection error / timeout
Verify that
GLPI_URLis reachable from the machine running the serverCheck that no firewall is blocking the connection
All HTTP requests have a hard ceiling of 30 seconds (10 s for connect). Beyond that, the tool returns a structured dict with
erroranddetail(labels taken from theLANGtable) instead of hanging — in English:{"error": "HTTP timeout", "detail": "Request > 30s — see GLPI logs"}. If you hit this repeatedly, inspect the PHP-FPM/MySQL logs on the GLPI side: the underlying query is likely too expensive (typically a full-text search without an index).
Corporate environment — SSL-intercepting proxy (Zscaler, Forcepoint, etc.)
In corporate environments, an SSL proxy may intercept HTTPS connections and replace certificates with an internal certificate. This causes the following error when installing dependencies with uv:
× Failed to download `python-dotenv==X.X.X`
╰─▶ invalid peer certificate: UnknownIssuerSolution: Force uv to use the Windows certificate store with the UV_NATIVE_TLS environment variable.
To test manually in PowerShell:
$env:UV_NATIVE_TLS=1
uv run python server.pyTo have Claude Desktop automatically pass this variable when starting the server, add an env section to your claude_desktop_config.json:
{
"mcpServers": {
"glpi": {
"command": "uv",
"args": [
"--directory",
"C:\\Path\\to\\glpi-mcp",
"run",
"python",
"server.py"
],
"env": {
"UV_NATIVE_TLS": "1"
}
}
}
}Corporate environment — Antivirus / EDR blocking uv (Riskware)
Some corporate antivirus or EDR solutions may categorize uv.exe as Riskware because it downloads executables and packages from the Internet. If uv is blocked by your security solution:
Contact your IT team to add an exception for
uv.exe(located at%USERPROFILE%\.local\bin\uv.exe)Also request authorization for the domains:
pypi.org,files.pythonhosted.org,astral.sh
As an alternative, ask a colleague with a working uv to share the .venv folder, which avoids any downloads.
Reducing dependencies
The project depends on mcp[cli] which includes the [cli] extra (typer, rich, click, shellingham, pygments, markdown-it-py…). This extra provides the development commands mcp dev and mcp inspect, useful for debugging.
If you want to reduce the footprint in production (about 8 fewer packages), modify pyproject.toml:
# Before (with CLI tooling)
dependencies = ["mcp[cli]>=1.9.4", "httpx>=0.27"]
# After (without CLI tooling — lightweight production)
dependencies = ["mcp>=1.9.4", "httpx>=0.27"]Then run uv sync again to update the environment.
Available Tools
40 toolsadd_followupA
Ajoute un suivi à un ticket.
is_private : True pour un suivi visible uniquement par les techniciens
Inputs: content (required), ticket_id (required), is_private.
add_kb_article_visibility_groupC
Ajoute un groupe dans la visibilite d'un article KB.
groups_id : ID du groupe GLPI
Inputs: groups_id (required), article_id (required), entities_id, is_recursive.
add_kb_article_visibility_profileA
Ajoute un profil dans la visibilite d'un article KB.
profiles_id : ID du profil GLPI
entities_id : 0 = entite racine
is_recursive : appliquer aux sous-entites
Inputs: article_id (required), profiles_id (required), entities_id, is_recursive.
add_solutionA
Poste une solution sur un ticket (le clôture automatiquement selon la config GLPI).
solution_type_id : ID du type de solution si applicable
Inputs: content (required), ticket_id (required), solution_type_id.
add_taskB
Crée une tâche sur un ticket.
status : 1=À faire 2=Terminée
duration_seconds : durée en secondes (ex. 3600 = 1h)
Inputs: content (required), ticket_id (required), status, is_private, +2 more.
create_kb_articleA
Cree un nouvel article dans la base de connaissances.
name : titre de l'article
answer : contenu / solution (HTML accepte)
category_id : ID de la categorie KB (optionnel)
is_faq : True pour publier dans la FAQ publique
Inputs: name (required), answer (required), is_faq, category_id.
create_ticketB
Crée un nouveau ticket.
type : 1=Incident 2=Demande de service
priority : 1 (très basse) → 6 (majeure)
Inputs: name (required), content (required), type, priority, +3 more.
delete_taskC
Supprime une tâche.
Inputs: task_id (required).
delete_ticketB
Supprime un ticket par son ID.
Inputs: ticket_id (required).
get_followupB
Retourne le détail d'un suivi spécifique.
Inputs: followup_id (required).
get_groupsA
Liste les groupes GLPI.
Inputs: no named parameters.
get_kb_articleB
Retourne le detail complet d'un article de la base de connaissances.
Inputs: article_id (required).
get_kb_article_visibilityA
Retourne les regles de visibilite d'un article KB : profils, groupes, utilisateurs et entites ayant acces.
Inputs: article_id (required). Returns: result
get_solutionC
Retourne la solution d'un ticket.
Inputs: ticket_id (required).
get_ticketB
Retourne le détail complet d'un ticket, avec libellés lisibles.
Inputs: ticket_id (required). Returns: result
get_usersB
Liste les utilisateurs GLPI.
Inputs: no named parameters.
kill_sessionA
Ferme proprement la session GLPI active.
Inputs: no named parameters. Returns: result
link_ticketsB
Crée un lien entre deux tickets.
link_type : 1=Lié à, 2=Duplique, 3=Enfant de, 4=Parent de
Inputs: ticket_id_1 (required), ticket_id_2 (required), link_type.
list_followupsB
Liste tous les suivis d'un ticket.
Inputs: ticket_id (required).
list_itil_categoriesA
Liste toutes les catégories ITIL disponibles (Incident, Demande, Changement, Problème).
Inputs: no named parameters.
list_kb_articlesA
List GLPI knowledge base articles with pagination.
Each KnowbaseItem returned by the API embeds the full HTML answer. On large KBs this makes the JSON response heavy: in production we observed that range_start > 60 combined with range_limit > 10 is enough to exceed PHP-FPM memory_limit on the GLPI side and the request fails. To stay below that ceiling, range_limit is auto-clamped to 10 when range_start > 60. When clamping kicks in the response is wrapped in a dict carrying _clamped_range_limit and _warning so callers can detect the change. Behaviour is unchanged for range_start <= 60.
Inputs: range_limit, range_start.
list_kb_categoriesA
Liste toutes les categories de la base de connaissances.
Inputs: no named parameters.
list_tasksA
Liste toutes les tâches d'un ticket.
Inputs: ticket_id (required).
list_ticket_linksB
Liste tous les liens d'un ticket avec d'autres tickets.
Inputs: ticket_id (required).
list_ticketsC
Liste les tickets avec pagination optionnelle.
status : 1=Nouveau 2=En cours(attribué) 3=En cours(planifié) 4=En attente 5=Résolu 6=Clos
type : 1=Incident 2=Demande de service
range_start / range_limit : pagination
Inputs: status, range_limit, range_start, ticket_type. Returns: result
merge_ticketsA
Fusionne un ou plusieurs tickets source vers un ticket cible.
Lie chaque ticket source au ticket cible comme doublon (link_type=2)
Copie les suivis des tickets source vers le ticket cible (si add_followups=True)
Ferme les tickets source avec un suivi explicatif (si close_source=True)
Paramètres :
target_ticket_id : ID du ticket cible (celui qui reste ouvert)
source_ticket_ids : liste des IDs de tickets à fusionner dans le cible
add_followups : copier les suivis des tickets source vers le cible
close_source : fermer les tickets source après la fusion
Inputs: target_ticket_id (required), source_ticket_ids (required), close_source, add_followups. Returns: result
search_kb_articlesA
Search knowledge base articles by keyword.
By default the search runs only against the title column, which is fast on any GLPI instance. Set search_content=True to also match against the full HTML body. On a GLPI instance that has no MySQL FULLTEXT index on knowbaseitems.answer, that branch produces a LIKE '%keyword%' scan on the answer column which routinely exceeds the 30 second client timeout on KBs with sizeable HTML payloads.
Field IDs are discovered at runtime via listSearchOptions/KnowbaseItem and looked up by column name ("name", "answer") so the tool works on both GLPI 10 and GLPI 11 (where numeric IDs may differ). When discovery fails the legacy GLPI 10 IDs (6 for title, 7 for body) are used as a fallback.
Parameters:
keywords: text to search for
range_start, range_limit: pagination
search_content: also match against the article body (default False). Only enable when the GLPI database has a FULLTEXT index on knowbaseitems.answer, otherwise the request will be slow.
Inputs: keywords (required), range_limit, range_start, search_content.
search_ticketsC
Recherche avancée de tickets via l'API GLPI /search/Ticket. Tous les paramètres sont optionnels et combinables.
Inputs: status, keywords, category_id, range_limit, +3 more.
stats_by_assigneeA
Retourne le nombre de tickets par technicien assigné.
Inputs: no named parameters. Returns: result
stats_by_categoryA
Retourne le nombre de tickets par catégorie ITIL.
Inputs: no named parameters. Returns: result
stats_by_priorityA
Retourne le nombre de tickets ouverts par priorité.
Inputs: no named parameters. Returns: result
stats_by_statusA
Retourne le nombre de tickets ouverts par statut.
Inputs: no named parameters. Returns: result
stats_by_typeA
Retourne le nombre de tickets par type (Incident / Demande de service).
Inputs: no named parameters. Returns: result
stats_overdueA
Retourne les tickets en retard (date d'échéance dépassée et non résolus). Utilise le champ time_to_resolve de GLPI.
Inputs: no named parameters. Returns: result
stats_resolution_timeA
Retourne le délai moyen de résolution des tickets résolus ou clos.
Inputs: no named parameters. Returns: result
update_kb_articleB
Met a jour un article de la base de connaissances. Exemples de champs : name, answer, is_faq, knowbaseitemcategories_id
Inputs: article_id (required), update_fields (required).
update_kb_article_visibility_groupA
Met a jour une regle de visibilite par groupe d'un article KB.
visibility_id : ID de l'entree KnowbaseItem_Group (obtenu via get_kb_article_visibility)
update_fields : champs a modifier, ex: {"entities_id": 1, "is_recursive": 1}
Inputs: update_fields (required), visibility_id (required).
update_kb_article_visibility_profileA
Met a jour une regle de visibilite par profil d'un article KB.
visibility_id : ID de l'entree KnowbaseItem_Profile (obtenu via get_kb_article_visibility)
update_fields : champs a modifier, ex: {"entities_id": 1, "is_recursive": 1}
Inputs: update_fields (required), visibility_id (required).
update_taskA
Met à jour une tâche. Exemples : state (1/2), content, actiontime, users_id_tech
Inputs: task_id (required), update_fields (required).
update_ticketA
Met à jour un ticket. Passer uniquement les champs à modifier. Exemples de champs : status, priority, name, content, itilcategories_id
Inputs: ticket_id (required), update_fields (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 40 tools
Most tools have clearly distinct purposes, such as ticket CRUD, task management, and KB operations. However, list_tickets and search_tickets overlap in functionality since search_tickets can replicate simple listing with filters, and link_tickets vs list_ticket_links are create vs read but names are close.
All tool names follow a consistent verb_noun pattern in snake_case, e.g., list_tickets, create_ticket, update_ticket. The stats_by_* tools form a coherent sub-pattern, and even kill_session fits the verb_noun convention.
40 tools is excessive according to the rubric (25+ is too many). The visibility management tools alone add 8 variations, and many tools handle niche edge cases that could be consolidated or omitted without losing core functionality.
The ticket lifecycle is well covered with CRUD, linking, merging, followups, and tasks. However, there are notable gaps: no delete for KB articles, no update/delete for followups or solutions, and no deletion of visibility rules, which could leave users unable to correct mistakes or remove obsolete data.
Maintenance
Related MCP Connectors
MCP server for GLPI: tickets, ITIL, assets, knowledge base. GLPI 10/11. Not affiliated with Teclib'.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
MCP server exposing klokin time-tracking operations (employees, time entries, stores) to AI clients.
Related MCP Servers
AlicenseBqualityBmaintenanceAn MCP server that exposes the Tickiti helpdesk API to AI assistants, enabling ticket management and helpdesk operations via natural language.11MIT- AlicenseAqualityDmaintenanceMCP server for Otobo ITSM enabling AI assistants to search, create, update, and manage tickets via the Generic Interface REST API.1011 npm1MIT
- AlicenseAqualityDmaintenanceMCP server to manage GestSup tickets via an LLM, with tools for creating, reading, commenting, and searching tickets.13MIT
- AlicenseCqualityDmaintenanceEnables AI assistants to manage GLPI inventory, tickets, and CIA security fields via its REST API.923 npm1ISC