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 dosearch_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. Proponhaurgencyeimpact(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 viaupdate_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 prompttriage_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