Documentazione del server MCP Foliade

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 — lire le compte, les réglages, les links de suivi et les statistiques ;
• foliade:write — transférer un PDF et configurer les catalogues, thèmes, enrichissements et étagères ;
• foliade:publish — gérer les publications, les protections et les adresses publiques.

Strumenti di caricamento e pubblicazione

Personalizzare Foliade con un assistente

Il server offre 35 strumenti. I 26 strumenti di configurazione richiedono un account connesso e rispettano i permessi del tuo piano.

Commencez par découvrir les capacités, puis lisez les réglages de la cible. Envoyez seulement les champs à modifier avec la révision reçue. Un conflit impose une nouvelle lecture ; les champs inconnus, valeurs nulles et valeurs invalides sont refusés.

Un aperçu avec dry_run ne sauvegarde rien. Pour enregistrer, utilisez la révision initiale, pas celle de l’aperçu. Les réglages d’un catalogue publié sont visibles immédiatement ; les enrichissements disposent d’un brouillon et d’une publication distincte.

Le lecteur expose ses couleurs, fonds, barre, contrôles, effets, sens de lecture, son, page de départ, disposition, link et position du logo, langue et téléchargement PDF. Les éléments interactifs utilisent les 13 types de l’éditeur, avec coordonnées en pourcentage de page.

Les listes sont paginées. Les links de suivi ne déclenchent aucun envoi de message. Modifier la marque du compte peut affecter plusieurs catalogues ; pour un seul PDF, préférez ses réglages propres.

Exemple : harmoniser les couleurs du lecteur

foliade_get_catalogue_settings({"catalogue_id": "IDENTIFIANT"})
foliade_update_catalogue({
  "catalogue_id": "IDENTIFIANT",
  "expected_revision": "REVISION_RENVOYEE_PAR_LA_LECTURE",
  "patch": {
    "fond": "#f7f5f0",
    "barre_fond": "#111111",
    "barre_icones": "#f7f5f0",
    "progression": "#ad935a"
  },
  "dry_run": true
})

Les imports de médias binaires, le remplacement du PDF, la synchronisation des produits, la gestion des clés API, des webhooks, de l’équipe et de la facturation restent accessibles par l’espace web ou l’API REST selon la fonction. Le MCP ne configure pas le DNS ou les certificats TLS.

Si votre assistant ne voit encore que neuf outils, actualisez la liste des outils dans son interface MCP ou relancez la session. Une réinstallation ne doit pas être la première réponse à un cache ancien. Vérifiez ensuite la présence de foliade_capabilities.

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 restituito da Foliade: permesso insufficiente. Controlla i permessi concessi. Per un rifiuto Cloudflare 403/1010, vedere la sezione di risoluzione dei problemi di seguito.
• 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.

Plugin abilitato, ma strumenti MCP non disponibili

Un plugin abilitato potrebbe comunque non riuscire a connettersi al server. Controlla lo stato di MCP e il messaggio di errore prima di reinstallare il plug-in o riconnettere il tuo account.

1. Se non è possibile trovare il server, controlla che il plug-in sia installato e abilitato.
2. Se la connessione supera il timeout di avvio, controllare i registri MCP. Un timeout dopo 30 secondi non dimostra che la connessione OAuth è scaduta.
3. Se una risposta Cloudflare 403 riporta l’errore 1010 o browser_signature_banned, Browser Integrity Check blocca il client HTTP prima che raggiunga Foliade. Aumentare il timeout di avvio non risolve questo rifiuto.
4. Se Foliade restituisce 401 o invalid_token, ricollega il tuo account tramite OAuth. Non sostituire questa connessione con l'accesso ospite.

Cosa devo fare se Cloudflare blocca la connessione?

Per il servizio Foliade in hosting, contatta il nostro team di supporto con l'ora e il fuso orario, l'URL interessato, il codice di errore e Cloudflare Ray ID se mostrato. Non inviare token, cookie, link di accesso o documenti privati. Non ci sono impostazioni Cloudflare da modificare sul tuo computer.

Stato di servizio · Contatta l'assistenza Foliade

Dopo che il server è stato riparato, riavvia il tuo assistente per ricaricare gli strumenti MCP, quindi chiedigli di controllare l'account Foliade connesso. Invia il PDF solo quando gli strumenti sono disponibili e l'e-mail dell'account è stata confermata.

(http.host eq "foliade.gekkode.com" and (
  http.request.uri.path in {
    "/mcp" "/authorize" "/token" "/register" "/revoke"
    "/.well-known/oauth-authorization-server"
    "/.well-known/oauth-protected-resource"
    "/.well-known/oauth-protected-resource/mcp"
  }
  or starts_with(http.request.uri.path, "/mcp/uploads/")
))