MCP · 1.1.0

Documentazione del server MCP Foliade

Lo stesso server ospitato collega Codex e Claude Code al tuo account. Entrambi i plugin forniscono istruzioni per trasferire un PDF locale in modo sicuro.

Installazione Codex · Installazione Claude Code

Collega il tuo account in Codex

L'installazione del plugin non collega ancora il tuo account. Dopo averlo installato, esegui questo comando nel terminale del computer, fuori dalla conversazione con Codex:

codex mcp login foliade

Nella pagina Foliade che si apre, effettua il login, verifica l'indirizzo dell'account e autorizza la connessione. Quindi torna dal tuo mago.

Se il browser non si apre, apri il link visualizzato nel terminale. Non condividere questo link di accesso.

Prima di continuare, attendi che il terminale confermi l'accesso. Non devi copiare alcuna chiave API.

Verifica la connessione e invia il primo PDF · Installazione Claude Code

Trasporto e autenticazione

MCP è incluso gratis, con o senza account. Codex e Claude Code rispettano i diritti del tuo piano; le loro condizioni di accesso restano separate.

Account gratuito: 5 cataloghi pubblicati, 50 MB e 100 pagine per PDF. Sito e MCP condividono 10 tentativi di caricamento ogni 24 ore, incluse sostituzioni ed errori, con un solo caricamento in corso. Le visualizzazioni restano illimitate.

Senza account, sul sito o tramite MCP: 3 PDF per IP ogni 24 ore, 50 MB e 100 pagine per PDF, un caricamento in corso. Pubblicazione per 30 giorni, gestione privata per 30 minuti. Conserva il link privato per collegare il catalogo a un account prima della scadenza.

Protezione del piano gratuito: elaborazione limitata a 120 secondi, 512 MB per risultato e 2 GB di spazio per account. La capacità globale è limitata; i piani a pagamento hanno priorità. In caso di rifiuto, attendi il tempo indicato senza nuovi tentativi automatici.

Prima di ogni trasferimento, l’assistente verifica l’account o la modalità ospite e spiega i limiti restituiti da Foliade. La bozza resta privata finché non ne richiedi la pubblicazione.

https://foliade.gekkode.com/mcp

La connessione OAuth è facoltativa per un caricamento ospite e necessaria per accedere al tuo account, anche gratuito. Il server verifica i diritti a ogni azione; una connessione scaduta non diventa mai un accesso ospite.

Il token di accesso dura un'ora. I token di rinnovo ruotano ad ogni utilizzo, senza estendere la connessione oltre i 30 giorni. Un token di rinnovo riutilizzato revoca l'intera connessione.

I clienti possono utilizzare la registrazione dinamica o i documenti di identità del cliente OpenAI e Anthropic. I metadati sono pubblici:

/.well-known/oauth-authorization-server
/.well-known/oauth-protected-resource/mcp

I permessi sono separati:

foliade:read — leggere la contabilità, i cataloghi e le statistiche;
foliade:write — trasferire un PDF e creare una bozza;
foliade:publish — pubblicare o annullare la pubblicazione di un catalogo.

Gli otto strumenti

Strumento	Impostazioni	Risultato
`foliade_account`	—	Indirizzo dell'account, offerta e dimensione massima del PDF.
`foliade_list_catalogues`	`limit=25 (1–100), offset=0`	Cataloghi degli account e dispositivo di scorrimento dell'impaginazione.
`foliade_prepare_upload`	`filename, size_bytes, sha256, notice_version, guest_mode=false, title="", language="fr"`	ID repository, URL HTTPS e intestazione temporanea per caricare il PDF.
`foliade_finalize_upload`	`upload_id, guest_token=""`	Bozza privata e stato di conversione. Una ripetizione mantiene lo stesso catalogo.
`foliade_catalogue_status`	`catalogue_id, guest_token=""`	Stato del catalogo, pagine e avanzamento della conversione.
`foliade_publish_catalogue`	`catalogue_id, guest_token=""`	Pubblicazione del catalogo esistente, senza riconversione.
`foliade_catalogue_stats`	`catalogue_id, days=30 (1–3650)`	Statistiche aggregate, senza dettagli di contatto.
`foliade_unpublish_catalogue`	`catalogue_id, guest_token=""`	Chiusura del collegamento pubblico, senza cancellare i dati.

Trasferimento di un PDF locale

Il server remoto non può leggere un percorso sul tuo computer. Il plugin calcola la dimensione e l'impronta digitale SHA-256 del file scelto, prepara un deposito, invia i suoi byte tramite HTTPS quindi finalizza la bozza.

Il ticket scade dopo 10 minuti e consente di trasferire solo il PDF dichiarato, entro 120 secondi. Il piano gratuito consente un caricamento in corso; gli account a pagamento possono aprire cinque trasferimenti.

La conversione è asincrona. L'assistente ne controlla il risultato prima di annunciare il successo. La pubblicazione pubblica richiede un'azione separata; la bozza rimane privata per impostazione predefinita.

Il PDF deve essere leggibile, privo di password ed entro il limite visualizzato dallo strumento di verifica dell'account.

Errori e revoca

401: connessione mancante, scaduta o revocata. Ricollegare l'account.
403: permesso insufficiente. Controlla l'offerta e i diritti autorizzati.
413: file troppo grande. Riduci il PDF.
422: file ricevuto diverso da quello annunciato. Ripeti il trasferimento.
429: troppe richieste. Rispettare il timeout del nuovo tentativo.

Gli errori dello strumento vengono riportati nel risultato MCP. Un catalogo di un altro account rimane inaccessibile. Un PDF danneggiato o una conversione non riuscita non dovrebbero mai essere presentati come riusciti.

In Foliade → API → Assistenti connessi puoi revocare ogni connessione. L’accesso termina immediatamente, senza eliminare i tuoi cataloghi.

Fonti e distribuzione

Repository del connettore pubblico · LEGGIMI · Abilità Foliade

Plug-in ZIP · CAP di abilità · SHA-256

Questo catalogo pubblico è gestito da Foliade. Non costituisce una presenza nelle directory ufficiali OpenAI o Anthropic, che richiedono una convalida separata.

Compatibilità con la vecchia installazione

Lo script Python locale rimane disponibile come soluzione avanzata con una chiave API e i suoi cinque strumenti storici. Non viene più avviato dai plugin 1.1.0. Le sue chiavi e impostazioni sono indipendenti dalla connessione OAuth.

Scrittura storica STDIO · Documentazione API REST