GLPI MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
GLPI MCP Server
Servidor MCP desenvolvido em Python que integra assistentes de IA ao GLPI por meio da API REST legada (apirest.php). Com ele, um cliente compatível com o Model Context Protocol (MCP) pode pesquisar registros, consultar itens e gerenciar chamados, respeitando as permissões da conta configurada no GLPI.
Índice
Related MCP server: glpi-mcp
Como funciona
O GLPI MCP Server funciona como uma ponte entre o cliente MCP (por exemplo, Claude Desktop) e a API REST do GLPI:
Assistente/cliente MCP <--> GLPI MCP Server <--> API REST do GLPIO servidor oferece dois modos de transporte:
stdio: recomendado quando o cliente MCP inicia o servidor como um processo local.
Streamable HTTP: recomendado para execução como serviço, acessível por um cliente remoto ou por um proxy reverso.
Pré-requisitos
Para execução local:
Python 3.11 ou superior.
Acesso de rede à instância GLPI.
API REST legada habilitada no GLPI.
Token de aplicação e credenciais/token de usuário com as permissões necessárias.
Para execução em contêiner:
Docker Engine e o comando
docker.Docker Compose não é necessário: os exemplos abaixo usam diretamente
docker buildedocker run.
Compatibilidade: este projeto utiliza a API REST legada do GLPI (
apirest.php). Verifique se ela está habilitada e disponível na sua instalação. A API REST v2 de versões recentes pode ter fluxo de autenticação diferente e não é o alvo desta implementação.
Preparar o GLPI
Entre no GLPI com uma conta administradora.
Habilite e configure a API REST legada nas configurações de API da sua instalação.
Gere um App-Token (token da aplicação).
Gere um User Token para a conta de integração ou prepare um usuário e senha dedicados.
Conceda à conta somente as permissões necessárias para as operações que pretende executar.
Os nomes dos menus podem variar conforme a versão e o idioma do GLPI. Consulte a documentação correspondente à sua versão para habilitar a API e gerar os tokens.
Você precisará da URL base do GLPI, por exemplo https://glpi.suaempresa.com. Não inclua /apirest.php no valor de GLPI_URL; o caminho da API é configurado separadamente.
Configuração
Clone o repositório e entre na pasta:
git clone https://github.com/efssantos/glpi-mcp.git
cd glpi-mcpCrie um arquivo .env na raiz do projeto usando .env.example como referência. Exemplo:
GLPI_URL=https://glpi.suaempresa.com
GLPI_API_PATH=/apirest.php
GLPI_APP_TOKEN=COLOQUE_SEU_APP_TOKEN
# Use GLPI_USER_TOKEN ou, alternativamente, GLPI_USERNAME + GLPI_PASSWORD.
GLPI_USER_TOKEN=COLOQUE_SEU_USER_TOKEN
# GLPI_USERNAME=usuario-integracao
# GLPI_PASSWORD=sua-senha
GLPI_TIMEOUT=30
GLPI_VERIFY_TLS=true
# Para cliente local iniciado como processo:
MCP_TRANSPORT=stdio
MCP_HOST=127.0.0.1
MCP_PORT=8000
LOG_LEVEL=INFOAjuste os valores de acordo com seu ambiente:
Variável | Obrigatória | Descrição |
| Sim | URL base da instalação GLPI, sem o caminho da API. |
| Não | Caminho da API. Padrão: |
| Conforme GLPI | Token da aplicação, quando exigido pela configuração da API. |
| Uma forma de autenticação | Token do usuário. Alternativamente, use usuário e senha. |
| Uma forma de autenticação | Usuário da conta de integração. |
| Uma forma de autenticação | Senha da conta de integração. |
| Não | Tempo limite das requisições em segundos. Padrão: |
| Não | Valida o certificado TLS. Padrão: |
| Não |
|
| Não | Interface de escuta HTTP. Padrão: |
| Não | Porta HTTP. Padrão: |
Não compartilhe o arquivo .env, tokens ou senhas. O arquivo já deve permanecer fora do Git por meio do .gitignore.
Executar localmente com Python
Windows (PowerShell)
Crie e ative um ambiente virtual:
py -3.12 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
pip install -r requirements.txtSe o PowerShell bloquear a ativação do ambiente virtual, consulte as políticas de execução da sua organização ou execute os comandos usando o Python do ambiente virtual diretamente.
Configure as variáveis de ambiente a partir do arquivo .env ou defina-as na sessão do PowerShell. Para definir manualmente:
$env:GLPI_URL = "https://glpi.suaempresa.com"
$env:GLPI_API_PATH = "/apirest.php"
$env:GLPI_APP_TOKEN = "COLOQUE_SEU_APP_TOKEN"
$env:GLPI_USER_TOKEN = "COLOQUE_SEU_USER_TOKEN"
$env:MCP_TRANSPORT = "stdio"
python -m serverLinux e macOS
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
pip install -r requirements.txtDefina as variáveis de ambiente (ou carregue-as com uma ferramenta local apropriada) e inicie:
export GLPI_URL="https://glpi.suaempresa.com"
export GLPI_API_PATH="/apirest.php"
export GLPI_APP_TOKEN="COLOQUE_SEU_APP_TOKEN"
export GLPI_USER_TOKEN="COLOQUE_SEU_USER_TOKEN"
export MCP_TRANSPORT="stdio"
python -m serverQuando o servidor estiver no modo stdio, ele é iniciado pelo cliente MCP. Não é necessário abrir uma porta de rede nem manter um terminal separado executando o processo.
Executar com Docker
Certifique-se de que o arquivo .env esteja preenchido. Construa a imagem na raiz do repositório:
docker build -t glpi-mcp:local .Modo stdio (cliente local)
O cliente MCP deve iniciar o contêiner e manter a entrada padrão aberta:
docker run --rm -i --env-file .env glpi-mcp:localEsse comando é apropriado para ser usado como processo iniciado pelo cliente MCP. Não acrescente -t nessa configuração.
Modo Streamable HTTP (serviço)
Para executar o servidor como serviço HTTP, configure MCP_TRANSPORT=streamable-http e faça o processo escutar em 0.0.0.0 dentro do contêiner. Exemplo:
docker run -d \
--name glpi-mcp \
--restart unless-stopped \
--env-file .env \
-e MCP_TRANSPORT=streamable-http \
-e MCP_HOST=0.0.0.0 \
-p 127.0.0.1:8000:8000 \
glpi-mcp:localO mapeamento acima disponibiliza a porta somente no loopback do host. Para acesso remoto, coloque um proxy reverso na frente do serviço, configure HTTPS e autenticação/autorização no proxy. O endpoint MCP é:
https://SEU-DOMINIO/mcpConsulte os logs e pare o contêiner com:
docker logs -f glpi-mcp
docker stop glpi-mcpSe alterar o código ou as dependências, reconstrua a imagem e recrie o contêiner.
Conectar a um cliente MCP
Claude Desktop — execução local com Python
No arquivo de configuração do Claude Desktop, adicione uma entrada em mcpServers. Ajuste o caminho absoluto do repositório e o caminho do arquivo .env:
{
"mcpServers": {
"glpi": {
"command": "C:\\CAMINHO\\PARA\\glpi-mcp\\.venv\\Scripts\\python.exe",
"args": ["-m", "server"],
"cwd": "C:\\CAMINHO\\PARA\\glpi-mcp",
"env": {
"GLPI_URL": "https://glpi.suaempresa.com",
"GLPI_API_PATH": "/apirest.php",
"GLPI_APP_TOKEN": "SEU_APP_TOKEN",
"GLPI_USER_TOKEN": "SEU_USER_TOKEN",
"MCP_TRANSPORT": "stdio"
}
}
}
}Substitua os caminhos e credenciais pelos valores do seu ambiente. Alternativamente, use um pequeno script de inicialização que carregue o arquivo .env e inicie python -m server; não presuma que o cliente MCP carregará automaticamente o arquivo .env.
Claude Desktop — execução local com Docker
Se a imagem já foi construída e o arquivo .env está em um caminho conhecido, a configuração pode iniciar o contêiner:
{
"mcpServers": {
"glpi": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"--env-file", "C:\\CAMINHO\\PARA\\glpi-mcp\\.env",
"glpi-mcp:local"
]
}
}
}Cliente remoto via Streamable HTTP
Quando o servidor estiver publicado com HTTPS e protegido por autenticação, configure o cliente MCP para usar o endpoint remoto https://SEU-DOMINIO/mcp. A forma exata de cadastrar um servidor HTTP varia conforme o cliente. Não use HTTP sem TLS em redes não confiáveis.
Após conectar, confirme no cliente se as ferramentas do GLPI foram carregadas. Reinicie o cliente após alterar sua configuração.
Ferramentas disponíveis
Ferramenta | Finalidade |
| Pesquisa registros por tipo de item, critérios e limite de resultados. O limite máximo é 100. |
| Consulta um registro pelo tipo e ID. |
| Cria um chamado no GLPI. |
| Atualiza campos de um chamado existente. |
Os tipos de item, critérios de pesquisa e campos aceitos seguem as regras da API GLPI e as permissões da conta utilizada.
Testes automatizados
Os testes usam unittest e mocks para isolar as chamadas HTTP. Não é necessário ter uma instância GLPI nem fornecer credenciais reais.
python -m pip install -r requirements.txt
python -m unittest discover -s tests -vO GitHub Actions executa a suíte em Python 3.11 e 3.12 nos eventos configurados no workflow do repositório.
Solução de problemas
Sintoma | O que verificar |
Erro de conexão com o GLPI | Confirme |
HTTP 401 ou 403 | Confira App-Token, token/credenciais do usuário, configuração da API e permissões da conta no GLPI. |
Erro de certificado TLS | Instale/configure a cadeia de certificados confiável. Use |
Cliente não encontra o servidor | Em stdio, valide comando, argumentos, diretório de trabalho e caminhos absolutos. Reinicie o cliente depois de editar a configuração. |
Contêiner HTTP inicia, mas não aceita conexões | Confirme |
Ferramentas não aparecem | Consulte os logs do processo MCP e confirme que o cliente suporta o transporte configurado. |
Segurança
Use uma conta técnica dedicada no GLPI e aplique o princípio do menor privilégio.
Nunca versione
.env, tokens, senhas ou arquivos com credenciais.Mantenha a validação TLS habilitada em produção.
Não exponha o endpoint MCP diretamente à Internet sem uma camada de autenticação e autorização.
HTTPS protege o tráfego, mas, por si só, não identifica nem autoriza quem pode invocar as ferramentas.
Revogue e gere novamente qualquer token que tenha sido exposto.
Licença
Este projeto é distribuído sob a licença MIT. Consulte o arquivo LICENSE para ver os termos completos.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for GLPI: tickets, ITIL, assets, knowledge base. GLPI 10/11. Not affiliated with Teclib'.
Manage tickets, run agents and workflows, query tables, and search workspace knowledge.
Helpdesk tickets from your AI: find, reply, take, hold, complete — within your own role. OAuth.
Search tickets, people, organizations and KB articles in Deskpro, and create tickets and replies.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to GLPI IT Service Management, enabling ticket management, asset search, and ITIL processes via natural language.9 npm3MIT
- AlicenseCqualityDmaintenanceEnables AI assistants to manage GLPI inventory, tickets, and CIA security fields via its REST API.923 npm1ISC
- AlicenseBqualityCmaintenanceEnables AI assistants to interact with a GLPI instance through its REST API, allowing natural-language consultation, creation, and updating of tickets, followups, tasks, solutions, knowledge base articles, suppliers, contacts, contracts, and statistics.52-
- AlicenseNot gradedqualityBmaintenanceConnects AI assistants to GLPI through the Model Context Protocol, enabling management of tickets, ITIL objects, assets, projects, tasks, documents, sessions, entities and massive actions via the legacy REST API. It supports GLPI 10 and 11 with safe defaults such as read-only mode, disabled destructive operations and masked secrets.MIT