# hub-mcp

Il collegamento fra il tuo assistente AI (Claude Desktop, Claude Code o un altro client MCP) e **Vortice Hub**, il portale delle applicazioni interne di Vortice S.p.A.

Con `hub-mcp` l'assistente può, **con i tuoi permessi e in sola lettura**:

| Strumento | Cosa fa |
|---|---|
| `mie_applicazioni` | Elenca le applicazioni dell'Hub che puoi aprire |
| `cerca_prodotti`, `prodotto` | Cerca prodotti Vortice e ne legge la scheda, con immagini e documenti |
| `listino` | Prezzo di listino in vigore (serve il permesso «listini») |
| `dati_catalogo`, `dati_colonne`, `dati_query` | Interroga le viste approvate del data warehouse (serve il permesso «dati») |
| `calcolo` | Esegue il calcolo di un configuratore, per esempio la VMC |

In più contiene una **guida allo sviluppo** delle applicazioni dell'Hub (risorse `guida://…` e prompt `nuova_applicazione`), che funziona anche senza collegamento.

## Sicurezza

- **Nessuna chiave sul PC.** Il programma non contiene credenziali e non parla con i sistemi aziendali: solo con l'Hub, in HTTPS.
- **Token personale.** Lo crei tu nel portale dell'Hub, vale al massimo 90 giorni e lo revochi quando vuoi. Sul PC sta nel portachiavi del sistema (Portachiavi di macOS, Gestione credenziali di Windows).
- **Sola lettura**, con i tuoi permessi: ogni richiesta è registrata nell'Hub.

## Installazione

1. Installa [uv](https://docs.astral.sh/uv/getting-started/installation/), una volta sola.
2. Collega il PC all'Hub. Il comando chiede l'indirizzo dell'Hub e il token personale, che non viene mostrato:
   ```bash
   uvx --from git+https://github.com/VorticeIta/hub-mcp@v0.1.2 hub-mcp accedi
   ```
3. Aggiungi l'MCP all'assistente. Per Claude Desktop, nel file di configurazione (`claude_desktop_config.json`):
   ```json
   {
     "mcpServers": {
       "vortice-hub": {
         "command": "uvx",
         "args": ["--from", "git+https://github.com/VorticeIta/hub-mcp@v0.1.2", "hub-mcp"]
       }
     }
   }
   ```
   Per Claude Code: `claude mcp add vortice-hub -- uvx --from git+https://github.com/VorticeIta/hub-mcp@v0.1.2 hub-mcp`.
4. Riavvia l'assistente e chiedi, per esempio: «quali applicazioni dell'Hub posso usare?».

Altri comandi: `hub-mcp stato` (a chi sei collegato), `hub-mcp esci` (rimuove il collegamento). Se l'Hub usa un certificato interno, indica la sua CA con la variabile `HUB_MCP_CA_FILE`.

## Sviluppo

```bash
uv sync --group prove
uv run pytest
```

Licenza MIT.