GLPI MCP

Déploiement distant : Render gratuit avec MCP Streamable HTTP authentifié.

🇫🇷 Français | 🇬🇧 English

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 uv

3. 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: glpi-mcp

Installation

1. Cloner le dépôt

git clone https://github.com/svtica/glpi-mcp.git
cd glpi-mcp

2. Installer les dépendances

uv sync

Configuration (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.json

Les 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" | base64

Renseignez ensuite les champs dans config.json :

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 fichier config.json.

⚠️ VERIFY_TLS vaut false par 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 magasin certifi de Python. Passez à true dès que l'AC interne est distribuée à certifi : sur un GLPI accessible hors du réseau interne, laisser false expose la connexion — et donc vos jetons d'API — à une interception.

Versions GLPI supportées

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.json

• macOS : ~/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

🎫 Tickets

💬 Suivis

✅ Tâches

💡 Solutions

📊 Statistiques

📚 Base de connaissances

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

🏢 Fournisseurs, contacts et contrats

Note : list_suppliers filtre sur les fournisseurs actifs par défaut. Passer only_active=False pour inclure les fournisseurs désactivés.

Note : Pour create_contract, les champs duration, notice, periodicity et billing s'expriment en mois (convention GLPI), et begin_date au format AAAA-MM-JJ.

Note : Quand supplier_id est 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'outil update_* correspondant et {"is_deleted": 0}. Avec purge=True, la suppression est définitive et irréversible et casse ces rattachements. Réserver la purge aux doublons et aux saisies erronées.

🖥️ Matériel / Assets

Types pris en charge : Computer, Monitor, NetworkEquipment, Printer, Peripheral, Phone. Le type AllAssets est disponible en lecture/recherche uniquement.

Sécurité : utilisez purge=True uniquement lorsqu'une suppression définitive et irréversible est explicitement demandée. Pour les créations et modifications, les dictionnaires fields sont transmis comme champs GLPI : n'inventez pas les IDs de références (locations_id, states_id, manufacturers_id, users_id, etc.).

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

Types

Priorités / Urgences / Impacts

Types de liens entre tickets

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_TOKEN et GLPI_USER_TOKEN sont corrects dans votre config.json

• Vé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_URL est accessible depuis la machine qui exécute le serveur

• Vé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 error et detail (libellés tirés de la table LANG) 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: UnknownIssuer

Solution : 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.py

Pour 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 uv

3. 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-mcp

2. Install dependencies

uv sync

Configuration (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.json

Values 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" | base64

Then fill in the fields in config.json:

You can also use environment variables (GLPI_URL, GLPI_APP_TOKEN, GLPI_USER_TOKEN, GLPI_LANG, GLPI_VERSION, GLPI_VERIFY_TLS) instead of the config.json file.

⚠️ VERIFY_TLS defaults to false, 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's certifi bundle. Switch it to true as soon as the internal CA is distributed to certifi: on a GLPI reachable from outside the internal network, leaving it false exposes the connection — and therefore your API tokens — to interception.

Supported GLPI versions

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.json

• macOS: ~/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

🎫 Tickets

💬 Followups

✅ Tasks

💡 Solutions

📊 Statistics

📚 Knowledge Base

Note: Deleting visibility rules is intentionally not exposed in order to preserve a history of procedures, even obsolete ones.

📋 Reference data

🏢 Suppliers, contacts and contracts

Note: list_suppliers returns active suppliers only by default. Pass only_active=False to include disabled ones.

Note: For create_contract, the duration, notice, periodicity and billing fields are expressed in months (GLPI convention), and begin_date uses the YYYY-MM-DD format.

Note: When supplier_id is provided, the junction entry (Contact_Supplier / Contract_Supplier) is created in a second call and its result is returned under the _supplier_link key. 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 matching update_* tool and {"is_deleted": 0}. With purge=True, deletion is permanent and irreversible and breaks those attachments. Reserve purging for duplicates and data-entry mistakes.

🖥️ Hardware / Assets

Supported itemtypes: Computer, Monitor, NetworkEquipment, Printer, Peripheral, Phone. AllAssets is available for read/search only.

Safety: use purge=True only when permanent, irreversible deletion was explicitly requested. The fields dictionaries are passed through as GLPI fields, so do not invent reference IDs such as locations_id, states_id, manufacturers_id or users_id.

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

Types

Priorities / Urgencies / Impacts

Ticket link types

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_TOKEN and GLPI_USER_TOKEN are correct in your config.json

• Check 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_URL is reachable from the machine running the server

• Check 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 error and detail (labels taken from the LANG table) 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: UnknownIssuer

Solution: 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.py

To 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.