Backup automatico script del 2026-08-23 12:04

2026-08-23 12:04:16 +02:00
1 parent 11823447a2
commit 795a15a7b6
@@ -0,0 +1,108 @@
+# Token Paperless per Loogle MCP
+
+## Cosa NON usare: token «Applicazione social»
+
+Nell'admin Django di Paperless (`/admin/socialaccount/socialtoken/`) compare il form **«Aggiungi token dell'applicazione social»** con campi Token, Token segreto, Scade il.
+
+Questi token servono a **django-allauth** per il login OAuth web (Google, Microsoft, ecc.) su Paperless. **Non** sono token dell'API REST di Paperless e **non** vanno usati per Loogle MCP.
+
+Non devi configurare nulla in quella schermata per il nostro hub MCP.
+
+---
+
+## Cosa usare: token API utente
+
+Paperless espone un'API REST autenticata con header:
+
+```
+Authorization: Token <token>
+```
+
+Ogni utente Paperless ha il proprio token, legato ai permessi di quell'account (documenti visibili, tag, ecc.).
+
+### Dove generarlo
+
+Per **ogni** familiare con account Paperless (daniele, lucia, davide, luca):
+
+1. Accedi a https://docs.loogle.it con quell'account
+2. Menu utente (in alto a destra) → **Profilo** / **Il mio profilo**
+3. Sezione **Token API** → pulsante freccia circolare (rigenera token)
+4. Copia il token nella riga corrispondente di `.env`
+
+Alternativa admin: Django admin → **Token** (app `authtoken`), associato all'utente.
+
+---
+
+## Configurazione in Loogle MCP
+
+Modifica `/home/daniely/docker/loogle-mcp/.env`:
+
+### Opzione consigliata — token per utente (4 familiari)
+
+```env
+PAPERLESS_URL=https://docs.loogle.it
+PAPERLESS_API_TOKEN_DANIELE=
+PAPERLESS_API_TOKEN_LUCIA=
+PAPERLESS_API_TOKEN_DAVIDE=
+PAPERLESS_API_TOKEN_LUCA=
+```
+
+| Utente MCP | Variabile `.env` | Account Paperless |
+|------------|------------------|-------------------|
+| Daniele | `PAPERLESS_API_TOKEN_DANIELE` | utente admin / superuser |
+| Lucia | `PAPERLESS_API_TOKEN_LUCIA` | utente Lucia |
+| Davide | `PAPERLESS_API_TOKEN_DAVIDE` | utente Davide |
+| Luca | `PAPERLESS_API_TOKEN_LUCA` | utente Luca |
+
+Righe vuote = utente saltato dall'indexer finché non inserisci il token.
+
+### Opzione alternativa — un solo token admin
+
+Se preferisci un unico account Paperless (es. Daniele superuser):
+
+```env
+PAPERLESS_API_TOKEN=<token-daniele>
+```
+
+Tutti gli utenti MCP useranno quel token in fallback.
+
+### Opzione C — mappa JSON
+
+```env
+PAPERLESS_API_TOKENS={"daniele":"...","lucia":"...","davide":"...","luca":"..."}
+```
+
+---
+
+## Comportamento nel sistema
+
+| Componente | Comportamento |
+|------------|---------------|
+| **Indexer** | Usa tutti i token configurati, unisce l'elenco documenti (deduplica per ID) |
+| **`search_knowledge`** | Cerca su tutto ciò che è stato indicizzato |
+| **`get_document`** | Usa il token dell'utente MCP loggato; se manca, fallback su `PAPERLESS_API_TOKEN` o token Daniele |
+
+Con token separati, ogni familiare può scaricare via MCP solo i documenti visibili al proprio account Paperless.
+
+---
+
+## Applicare le modifiche
+
+```bash
+cd /home/daniely/docker/loogle-mcp
+# modifica .env con i token reali
+docker compose restart loogle-mcp loogle-mcp-indexer
+docker logs loogle-mcp-indexer --tail 30
+```
+
+Log atteso: indicizzazione da `daniele`, `lucia`, `davide`, `luca` (solo utenti con token impostato).
+
+---
+
+## Checklist onboarding Paperless
+
+- [ ] Account Paperless creato per daniele, lucia, davide, luca (se non esistono)
+- [ ] Token API generato per ciascuno (Profilo → Token API)
+- [ ] Quattro righe compilate in `.env`
+- [ ] `docker compose restart loogle-mcp loogle-mcp-indexer`
+- [ ] Log indexer senza errori 401