From f69979e1a7fed094cb5a4778668d578a29234c38 Mon Sep 17 00:00:00 2001 From: Eduardo Fraga Date: Wed, 14 Oct 2026 02:56:56 -0300 Subject: [PATCH] feat(content): add mcp-glpi product page --- content/en/produtos/_index.md | 4 ++ content/en/produtos/mcp-glpi.md | 75 ++++++++++++++++++++++++++++++ content/pt-br/produtos/_index.md | 4 ++ content/pt-br/produtos/mcp-glpi.md | 75 ++++++++++++++++++++++++++++++ 4 files changed, 158 insertions(+) create mode 100644 content/en/produtos/mcp-glpi.md create mode 100644 content/pt-br/produtos/mcp-glpi.md diff --git a/content/en/produtos/_index.md b/content/en/produtos/_index.md index 536f456..0e1d920 100644 --- a/content/en/produtos/_index.md +++ b/content/en/produtos/_index.md @@ -15,4 +15,8 @@ GLPI is an open-source IT asset management and ITIL service desk software. EF-TE WireGuard is a modern, containerized, and secure corporate VPN. EF-TECH offers deployment via Docker with Alpine Linux, automated health checks, and production-ready monitoring. +### [mcp-glpi](/en/produtos/mcp-glpi/) + +mcp-glpi v3.4 connects MCP-compatible AI assistants to GLPI with 88 tools for tickets, ITIL, assets, multi-criteria search, statistics, and service desk operations. EF-TECH can support evaluation, deployment, and operations. + Ready to get started? [Contact us](/en/contato/) and schedule a consultation. diff --git a/content/en/produtos/mcp-glpi.md b/content/en/produtos/mcp-glpi.md new file mode 100644 index 0000000..7dcf926 --- /dev/null +++ b/content/en/produtos/mcp-glpi.md @@ -0,0 +1,75 @@ +--- +title: "mcp-glpi" +description: "mcp-glpi v3.4: MCP server connecting AI assistants to GLPI with OAuth2, 88 tools, and GLPI 11 and 12 support." +summary: "Connect AI assistants to GLPI with 88 tools for tickets, ITIL, assets, RSQL search, and statistics. EF-TECH supports evaluation, deployment, and operations." +date: 2026-10-14 +tags: ["mcp-glpi", "glpi", "mcp", "ai", "service-desk", "open-source"] +categories: ["produtos"] +--- +## mcp-glpi + +**mcp-glpi v3.4** is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that connects MCP-compatible AI assistants to GLPI. It exposes standardized tools for querying and operating tickets, assets, problems, changes, and other GLPI resources, bringing AI closer to the daily work of service desk and operations teams. + +The project uses the stable **High-Level API v2.3** path, compatible with GLPI 11 and GLPI 12. EF-TECH can support use-case evaluation, deployment, and operation of the integration according to the organization's environment and requirements. + +### Coverage for service desk and operations + +mcp-glpi provides **88 MCP tools** across the main operational areas of GLPI: + +- Tickets, followups, tasks, solutions, validations, and SLA tracking +- Problems and changes +- Computers, software, network equipment, printers, monitors, and phones +- Knowledge base, contracts, suppliers, locations, and projects +- Users, groups, categories, entities, and documents +- Multi-criteria search, counts, and statistics + +Ticket tools include chronological timelines, user or group assignment, ticket linking, validation requests, and task lifecycle management with time tracking. This lets AI assistants query operational context and perform GLPI actions while respecting the permissions and configuration of the GLPI instance. + +### Search and operational visibility + +Multi-criteria search accepts RSQL filters with `AND`, `OR`, `AND NOT`, and `OR NOT`, together with field selection, pagination, full-result retrieval, and a dedicated count probe. Dynamic searchable-field mapping helps keep the integration valid across GLPI versions. Ticket search provides direct parameters for status, assignee, requester, and date ranges. + +The server can report ticket statistics by status, category, technician, entity, or month, asset totals by type, and tickets past their SLA deadline. Detail responses can resolve foreign keys and return both the related ID and readable name. + +### OAuth2 authentication and safety signals + +Tools include MCP safety annotations to distinguish read and write operations. Listing, get, search, count, and statistics tools receive `readOnlyHint`; update, delete, set, and assignment operations receive `destructiveHint`. Ticket tools also validate runtime inputs with Zod and return structured `InvalidParams` errors when parameters are invalid. + +mcp-glpi v3 uses OAuth2 with `password`, `client_credentials`, or a `bearer` token. The v2 API `app_token` and `user_token` authentication is **not supported in v3**. An OAuth2 client with the appropriate grant must be configured in GLPI; credentials are supplied through environment variables or the HTTP session configuration. See the project README for the complete variable table and requirements for each method. + +### Transport: stdio or Streamable HTTP + +With **stdio** transport, the MCP client starts the server as a subprocess and exchanges messages through stdin/stdout. This is suitable for local integrations such as `bunx` or a container started by the client. With Docker, keep `-i` to preserve stdin and **do not use `-t`**, because a TTY can corrupt the protocol stream: + +```bash +docker pull ghcr.io/eftechcombr/mcp-glpi:latest +docker run -i --rm --env-file /absolute/path/.env \ + ghcr.io/eftechcombr/mcp-glpi:latest +``` + +With **Streamable HTTP** transport, the server accepts network connections. Set `MCP_TRANSPORT=http` and publish the service port: + +```bash +docker run -d --name mcp-glpi-http -p 3000:3000 \ + -e MCP_TRANSPORT=http -e PORT=3000 \ + ghcr.io/eftechcombr/mcp-glpi:latest +``` + +The default MCP endpoint is `/mcp`; `/health` and `/` provide health endpoints. When using a reverse proxy, the `/mcp` path must forward streaming without SSE buffering. + +Streamable HTTP supports two operating models: + +- **Single-tenant:** `GLPI_URL` and the authentication variables define one instance for sessions. +- **Multi-tenant:** leave `GLPI_URL` unset and let each session configure its own connection with `glpi_configure_connection`. Credentials remain in memory and are removed when the session ends or expires. + +In multi-tenant mode, the client checks `glpi_connection_status`, calls `glpi_configure_connection` with the URL, OAuth2 method, and matching credentials, and then uses the tools normally. + +### How EF-TECH can help + +EF-TECH can support AI use-case assessment for service desk, GLPI and MCP client configuration, containerized execution, and service operations. The scope is defined according to the environment's architecture, permissions, and security requirements. + +The source code is available on [GitHub](https://github.com/eftechcombr/mcp-glpi), with a package published on [npm](https://www.npmjs.com/package/mcp-glpi). See the README for the complete configuration, tool catalogue, and development details. + +--- + +Want to connect AI to your company's GLPI? [Contact us](/en/contato/) to speak with our team. diff --git a/content/pt-br/produtos/_index.md b/content/pt-br/produtos/_index.md index 56d572a..4b9f2fa 100644 --- a/content/pt-br/produtos/_index.md +++ b/content/pt-br/produtos/_index.md @@ -15,4 +15,8 @@ GLPI é um software livre de gestão de ativos de TI e service desk ITIL. A EF-T WireGuard é uma VPN corporativa moderna, containerizada e segura. A EF-TECH oferece deploy via Docker com Alpine Linux, health check automatizado e monitoramento pronto para produção. +### [mcp-glpi](/pt-br/produtos/mcp-glpi/) + +mcp-glpi v3.4 conecta assistentes de IA compatíveis com MCP ao GLPI com 88 ferramentas para tickets, ITIL, ativos, busca multicritério, estatísticas e operações de service desk. A EF-TECH pode apoiar avaliação, implantação e operação. + Pronto para começar? [Fale conosco](/pt-br/contato/) e agende uma consultoria. diff --git a/content/pt-br/produtos/mcp-glpi.md b/content/pt-br/produtos/mcp-glpi.md new file mode 100644 index 0000000..2d535c7 --- /dev/null +++ b/content/pt-br/produtos/mcp-glpi.md @@ -0,0 +1,75 @@ +--- +title: "mcp-glpi" +description: "mcp-glpi v3.4: servidor MCP para conectar assistentes de IA ao GLPI com OAuth2, 88 ferramentas e suporte a GLPI 11 e 12." +summary: "Conecte assistentes de IA ao GLPI com 88 ferramentas para tickets, ITIL, ativos, busca RSQL e estatísticas. A EF-TECH apoia avaliação, implantação e operação." +date: 2026-10-14 +tags: ["mcp-glpi", "glpi", "mcp", "ia", "service-desk", "open-source"] +categories: ["produtos"] +--- +## mcp-glpi + +O **mcp-glpi v3.4** é um servidor do [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) que conecta assistentes de IA compatíveis ao GLPI. Ele expõe ferramentas padronizadas para consultar e operar tickets, ativos, problemas, mudanças e outros recursos do GLPI, aproximando a IA do trabalho diário de equipes de service desk e operações. + +O projeto utiliza o caminho estável da **High-Level API v2.3**, compatível com GLPI 11 e GLPI 12. A EF-TECH pode apoiar a avaliação do caso de uso, a implantação e a operação da integração, de acordo com o ambiente e os requisitos da organização. + +### Cobertura para service desk e operações + +São **88 ferramentas MCP** para as principais áreas operacionais do GLPI: + +- Tickets, acompanhamentos, tarefas, soluções, validações e SLA +- Problemas e mudanças +- Computadores, softwares, equipamentos de rede, impressoras, monitores e telefones +- Base de conhecimento, contratos, fornecedores, locais e projetos +- Usuários, grupos, categorias, entidades e documentos +- Busca multicritério, contagens e estatísticas + +As ferramentas de tickets incluem timeline cronológica, atribuição a usuários ou grupos, vínculo entre tickets, solicitações de validação e ciclo de vida de tarefas com apontamento de horas. Isso permite usar assistentes de IA para consultar contexto operacional e executar ações no GLPI, respeitando as permissões e a configuração da instância. + +### Busca e visibilidade operacional + +A busca multicritério aceita filtros RSQL com operadores `AND`, `OR`, `AND NOT` e `OR NOT`, além de seleção de campos, paginação, busca de todos os resultados e uma consulta dedicada de contagem. O mapeamento dinâmico dos campos pesquisáveis ajuda a manter a integração válida entre versões do GLPI. A busca de tickets possui parâmetros diretos para status, responsável, solicitante e período. + +O servidor também pode apresentar estatísticas por status, categoria, técnico, entidade ou mês, totais de ativos por tipo e tickets cujo prazo de SLA foi ultrapassado. Nas respostas de detalhe, chaves estrangeiras podem retornar tanto o ID quanto o nome legível relacionado. + +### Segurança e autenticação OAuth2 + +As ferramentas incluem anotações MCP de segurança para distinguir operações de leitura e alteração. Listagens, consultas, buscas, contagens e estatísticas recebem `readOnlyHint`; operações de atualização, exclusão, definição e atribuição recebem `destructiveHint`. As ferramentas de tickets também usam validação de entrada em tempo de execução com Zod e retornam erros `InvalidParams` estruturados quando os parâmetros são inválidos. + +O mcp-glpi v3 usa OAuth2 com `password`, `client_credentials` ou token `bearer`. A autenticação baseada em `app_token` e `user_token` da API v2 **não é suportada na v3**. É necessário configurar no GLPI um cliente OAuth2 com o grant apropriado e fornecer as credenciais por variáveis de ambiente ou pela configuração da sessão HTTP. A página do projeto contém a tabela completa de variáveis e os requisitos de cada método. + +### Transporte: stdio ou Streamable HTTP + +No modo **stdio**, o cliente MCP inicia o servidor como subprocesso e troca mensagens pelo stdin/stdout. É o modo adequado para integrações locais, como `bunx` ou um container iniciado pelo próprio cliente. Com Docker, mantenha `-i` para preservar o stdin e **não use `-t`**, pois um TTY pode corromper o fluxo do protocolo: + +```bash +docker pull ghcr.io/eftechcombr/mcp-glpi:latest +docker run -i --rm --env-file /caminho/absoluto/.env \ + ghcr.io/eftechcombr/mcp-glpi:latest +``` + +No modo **Streamable HTTP**, o servidor atende conexões de rede. Configure `MCP_TRANSPORT=http` e publique a porta do serviço: + +```bash +docker run -d --name mcp-glpi-http -p 3000:3000 \ + -e MCP_TRANSPORT=http -e PORT=3000 \ + ghcr.io/eftechcombr/mcp-glpi:latest +``` + +O endpoint MCP padrão é `/mcp`; `/health` e `/` fornecem endpoints de saúde. Em um proxy reverso, o caminho `/mcp` precisa encaminhar o streaming sem buffering de SSE. + +O Streamable HTTP pode operar em dois modelos: + +- **Single-tenant:** `GLPI_URL` e as variáveis de autenticação definem uma instância para as sessões. +- **Multi-tenant:** `GLPI_URL` fica sem definição e cada sessão configura sua própria conexão com `glpi_configure_connection`. As credenciais ficam somente em memória e são removidas quando a sessão termina ou expira. + +No modo multi-tenant, o cliente consulta `glpi_connection_status`, chama `glpi_configure_connection` com a URL, o método OAuth2 e as credenciais correspondentes, e então usa as ferramentas normalmente. + +### Como a EF-TECH pode apoiar + +A EF-TECH pode apoiar a avaliação do uso de IA no service desk, a configuração do GLPI e do cliente MCP, a execução containerizada e a operação do serviço. O escopo é definido conforme a arquitetura, as permissões e os requisitos de segurança do ambiente. + +O código-fonte está disponível no [GitHub](https://github.com/eftechcombr/mcp-glpi), com pacote publicado no [npm](https://www.npmjs.com/package/mcp-glpi). Consulte o README para a configuração completa, catálogo de ferramentas e detalhes de desenvolvimento. + +--- + +Quer conectar IA ao GLPI da sua empresa? [Entre em contato](/pt-br/contato/) para conversar com nossa equipe.