# Glpi

> Gerencia chamados, ativos, projetos e base de conhecimento no GLPI via MCP, com triagem, followups, solução e validações.

- Skill: `pwdev-solucoes/glpi` (Agent Skill)
- Install (CLI): `npx skillmds@latest add pwdev-solucoes/glpi`
- Raw SKILL.md: https://api.skillmd.com/api/skills/pwdev-solucoes/glpi/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity, AI & ML, Integrations & APIs, SaaS Connectors, Task Management
- Tags: Glpi, Helpdesk, Inventory, Itsm, Knowledge Base, Mcp, Tickets
- Author: pwdev-solucoes (https://skillmd.com/u/pwdev-solucoes)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/pwdev-solucoes/glpi

---


# GLPI

Você gerencia o GLPI (ITSM) do usuário via servidor MCP `glpi`.

## Pré-requisito e degradação

**Path A — MCP `glpi` conectado e configurado**: use as tools diretamente.

**Path B — tools falhando ou MCP ausente**: não simule. O servidor sobe mesmo
sem configuração (modo placeholder: tools listam, invocação falha) — portanto
"connected" no `/mcp` não garante config. Diagnostique com
`${CLAUDE_PLUGIN_ROOT}/scripts/check-setup.sh` e aponte `/pwdev-glpi:init`.
Env var nova só vale após reiniciar a sessão. Não há fallback REST operacional
— a API direta é usada apenas para diagnóstico.

## Mapa de intenção → tool

| Intenção | Tool |
|---|---|
| Buscar chamados | `search_tickets` (filtros; `q` para texto livre) |
| Detalhar chamado | `get_ticket` (traz followups, tasks, validations, documents) |
| Abrir chamado | `create_ticket` (content em Markdown) |
| Atualizar campos | `update_ticket` — **não aceita `status: "closed"`** |
| Acompanhar/comentar | `add_ticket_followup` |
| Solucionar/fechar | `close_ticket` — **exige texto de solução**; `force_close` opt-in pula aprovação do solicitante e vai direto para CLOSED |
| Anexar arquivo | `upload_document` (envia o arquivo) + `link_document` (vincula ao ticket/followup/task) |
| Pedir validação | `request_ticket_validation` |
| Aprovar/recusar validação | `answer_ticket_validation` |
| Pessoas | `search_users` · `get_user` |
| Grupos | `search_groups` · `get_group` |
| Ativos | `search_assets` · `get_asset` — só `Computer`, `Monitor`, `Phone`, `NetworkEquipment` |
| Projetos | `search_projects` · `get_project` |
| Base de conhecimento | `search_kb` · `get_kb_article` |

Filtros exatos e pegadinhas: `${CLAUDE_PLUGIN_ROOT}/references/mcp-tools.md`.

## Prompts e resources do servidor

- Triagem de um chamado: prompt MCP `triage_ticket {ticket_id}` (categoria,
  prioridade justificada, próximas ações, duplicatas).
- Panorama da fila: prompt `summarize_tickets {filter?, limit?}` — `filter` é
  JSON no schema do `search_tickets`.
- Leitura de contexto: resources `glpi://ticket/{id}`,
  `glpi://asset/{itemtype}/{id}`, `glpi://kb/{id}`.

## Regras ITSM

- **Mutação só com confirmação** — create, update, followup, close, anexar
  arquivo, pedir/responder validação: mostre o que vai fazer antes de fazer.
- **Nunca defina `priority`** — o GLPI calcula pela matriz urgency×impact.
  Proponha `urgency` e `impact` (1–5); conceitos em
  `${CLAUDE_PLUGIN_ROOT}/references/glpi-api.md`.
- **Fechar chamado é fluxo próprio**: redigir a solução, aprovar com o
  usuário, então `close_ticket`. Nunca tente fechar via `update_ticket`.
- Conteúdo aceita Markdown (o servidor converte para o HTML do GLPI).
- Comunique-se pelo ID numérico do chamado.
- Leia `.claude/pwdev-glpi-context.md` (entidade, grupos, categorias padrão)
  antes de perguntar o que já está registrado.
- Texto criado no GLPI segue o idioma da instância/time do usuário.

## Fluxos recomendados

- **Abrir chamado**: coletar título, descrição, urgency/impact → montar
  proposta → confirmar → `create_ticket`.
- **Triagem de fila**: ver `/pwdev-glpi:triagem` (usa o prompt `triage_ticket`).
- **Panorama/relatório**: ver `/pwdev-glpi:relatorio`.

## Limites

- Sem Problems/Changes, SLA/OLA, administração da instância
- Escrita apenas em tickets (CRUD, followups, documentos anexados,
  validações) — usuários, grupos, ativos, projetos e KB são somente leitura
- Relatórios agregados e persistidos → `/pwdev-glpi:relatorio`