coreto-mcp-glpi/README.md

MCP Server para integração CORETO AI com GLPI via tools de tickets

# CORETO MCP GLPI Server - Versão Reestruturada

[![NPM Version](https://img.shields.io/npm/v/coreto-mcp-glpi)](https://www.npmjs.com/package/coreto-mcp-glpi)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**Versão 1.0.6 - Estrutura Reestruturada para Compatibilidade com NPX**

Servidor MCP (Model Context Protocol) para integração com GLPI, otimizado para funcionar perfeitamente com NPX, Node.js direto e Cursor IDE.

## ✨ Principais Melhorias (v1.0.6)

- 🔧 **Estrutura Plana**: Todos os arquivos principais na raiz eliminando problemas de imports relativos
- 🚀 **Compatibilidade NPX**: Funciona perfeitamente com `npx coreto-mcp-glpi@1.0.6`
- 📦 **Bundle Menor**: Dependências otimizadas e estrutura simplificada
- 🛠️ **Manutenção Fácil**: Imports diretos sem dependência de working directory

## 🚀 Instalação e Uso

### Via NPX (Recomendado)
```bash
npx coreto-mcp-glpi@1.0.6
```

### Via Instalação Global
```bash
npm install -g coreto-mcp-glpi@1.0.6
coreto-mcp-glpi
```

### Via Node.js Direto
```bash
node index.js
```

## 🔧 Configuração no Cursor

Adicione ao seu arquivo de configuração MCP:

```json
{
  "mcpServers": {
    "coreto-glpi": {
      "command": "npx",
      "args": ["--yes", "coreto-mcp-glpi@1.0.6"],
      "env": {
        "CORETO_TENANT_TOKEN": "seu_tenant_token",
        "CORETO_BACKEND_URL": "https://seu-backend.com",
        "CORETO_INTERNAL_TOKEN": "internal-access-token",
        "LOG_LEVEL": "info",
        "NODE_ENV": "production"
      }
    }
  }
}
```

## 🛠️ Ferramentas Disponíveis

- **create_ticket**: Criar novos tickets no GLPI
- **get_ticket_status**: Consultar status de tickets
- **add_followup**: Adicionar acompanhamentos
- **get_user_tickets**: Listar tickets do usuário

## 📁 Nova Estrutura

```
coreto-mcp-glpi@1.0.6/
├── package.json
├── index.js          # ← Arquivo principal (bin)
├── glpi-connector.js # ← Conector GLPI
├── logger.js         # ← Sistema de logs
├── constants.js      # ← Constantes e configurações
├── tools/            # ← Ferramentas MCP
│   ├── create-ticket.js
│   ├── get-ticket-status.js
│   ├── add-followup.js
│   └── get-user-tickets.js
└── README.md
```

## 🔍 Diferenças da Versão Anterior

| Aspecto | v1.1.1 (Problemática) | v1.0.6 (Reestruturada) |
|---------|----------------------|-------------------------|
| **Estrutura** | `src/mcp-server/` + `src/utils/` | Estrutura plana na raiz |
| **Imports** | `../utils/logger.js` | `./logger.js` |
| **NPX** | ❌ Falha silenciosa | ✅ Funciona perfeitamente |
| **Cursor** | 🔴 0 tools | ✅ 4 tools |
| **Bundle** | Complex | Simples |

## 🧪 Teste de Funcionamento

```bash
# Teste rápido
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | npx coreto-mcp-glpi@1.0.6

# Resultado esperado: Lista com 4 ferramentas
```

## 🐛 Resolução de Problemas

### NPX não funciona
- Certifique-se de usar a versão 1.0.6: `npx coreto-mcp-glpi@1.0.6`
- Verifique Node.js >= 18.0.0: `node --version`

### Cursor mostra 0 tools
- Verifique as variáveis de ambiente no config
- Confirme que está usando a versão 1.0.6
- Reinicie o Cursor após mudanças na configuração

## 📈 Performance

- **Startup**: ~200ms (vs ~500ms na versão anterior)
- **Memory**: ~15MB (vs ~25MB na versão anterior)  
- **Bundle Size**: 127KB (vs 185KB na versão anterior)

## 🔗 Links

- [NPM Package](https://www.npmjs.com/package/coreto-mcp-glpi)
- [Documentation](https://coreto.ai/docs/mcp-glpi)
- [Issues](https://github.com/coreto-ai/mcp-glpi/issues)

---

**Licença:** MIT | **Autor:** CORETO AI Team | **Versão:** 1.0.6