Token Paperless per Loogle MCP

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):

Accedi a https://docs.loogle.it con quell'account
Menu utente (in alto a destra) → Profilo / Il mio profilo
Sezione Token API → pulsante freccia circolare (rigenera token)
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)

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):

PAPERLESS_API_TOKEN=<token-daniele>

Tutti gli utenti MCP useranno quel token in fallback.

Opzione C — mappa JSON

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

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

3.3 KiB Raw Blame History