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
1---2name: glpi3description: Gerencia chamados, ativos, projetos e base de conhecimento no GLPI via MCP, com triagem, followups, solução e validações.4---56# GLPI78Você gerencia o GLPI (ITSM) do usuário via servidor MCP `glpi`.910## Pré-requisito e degradação1112**Path A — MCP `glpi` conectado e configurado**: use as tools diretamente.1314**Path B — tools falhando ou MCP ausente**: não simule. O servidor sobe mesmo15sem configuração (modo placeholder: tools listam, invocação falha) — portanto16"connected" no `/mcp` não garante config. Diagnostique com17`${CLAUDE_PLUGIN_ROOT}/scripts/check-setup.sh` e aponte `/pwdev-glpi:init`.18Env var nova só vale após reiniciar a sessão. Não há fallback REST operacional19— a API direta é usada apenas para diagnóstico.2021## Mapa de intenção → tool2223| Intenção | Tool |24|---|---|25| Buscar chamados | `search_tickets` (filtros; `q` para texto livre) |26| Detalhar chamado | `get_ticket` (traz followups, tasks, validations, documents) |27| Abrir chamado | `create_ticket` (content em Markdown) |28| Atualizar campos | `update_ticket` — **não aceita `status: "closed"`** |29| Acompanhar/comentar | `add_ticket_followup` |30| Solucionar/fechar | `close_ticket` — **exige texto de solução**; `force_close` opt-in pula aprovação do solicitante e vai direto para CLOSED |31| Anexar arquivo | `upload_document` (envia o arquivo) + `link_document` (vincula ao ticket/followup/task) |32| Pedir validação | `request_ticket_validation` |33| Aprovar/recusar validação | `answer_ticket_validation` |34| Pessoas | `search_users` · `get_user` |35| Grupos | `search_groups` · `get_group` |36| Ativos | `search_assets` · `get_asset` — só `Computer`, `Monitor`, `Phone`, `NetworkEquipment` |37| Projetos | `search_projects` · `get_project` |38| Base de conhecimento | `search_kb` · `get_kb_article` |3940Filtros exatos e pegadinhas: `${CLAUDE_PLUGIN_ROOT}/references/mcp-tools.md`.4142## Prompts e resources do servidor4344- Triagem de um chamado: prompt MCP `triage_ticket {ticket_id}` (categoria,45 prioridade justificada, próximas ações, duplicatas).46- Panorama da fila: prompt `summarize_tickets {filter?, limit?}` — `filter` é47 JSON no schema do `search_tickets`.48- Leitura de contexto: resources `glpi://ticket/{id}`,49 `glpi://asset/{itemtype}/{id}`, `glpi://kb/{id}`.5051## Regras ITSM5253- **Mutação só com confirmação** — create, update, followup, close, anexar54 arquivo, pedir/responder validação: mostre o que vai fazer antes de fazer.55- **Nunca defina `priority`** — o GLPI calcula pela matriz urgency×impact.56 Proponha `urgency` e `impact` (1–5); conceitos em57 `${CLAUDE_PLUGIN_ROOT}/references/glpi-api.md`.58- **Fechar chamado é fluxo próprio**: redigir a solução, aprovar com o59 usuário, então `close_ticket`. Nunca tente fechar via `update_ticket`.60- Conteúdo aceita Markdown (o servidor converte para o HTML do GLPI).61- Comunique-se pelo ID numérico do chamado.62- Leia `.claude/pwdev-glpi-context.md` (entidade, grupos, categorias padrão)63 antes de perguntar o que já está registrado.64- Texto criado no GLPI segue o idioma da instância/time do usuário.6566## Fluxos recomendados6768- **Abrir chamado**: coletar título, descrição, urgency/impact → montar69 proposta → confirmar → `create_ticket`.70- **Triagem de fila**: ver `/pwdev-glpi:triagem` (usa o prompt `triage_ticket`).71- **Panorama/relatório**: ver `/pwdev-glpi:relatorio`.7273## Limites7475- Sem Problems/Changes, SLA/OLA, administração da instância76- Escrita apenas em tickets (CRUD, followups, documentos anexados,77 validações) — usuários, grupos, ativos, projetos e KB são somente leitura78- Relatórios agregados e persistidos → `/pwdev-glpi:relatorio`
pwdev-solucoes