Cos'è un server MCP?

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

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.

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.

Controllare e revocare l'accesso

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

Queste guide riguardano Codex e Claude Code con accesso ai file locali. Non garantiscono il trasferimento degli allegati a ChatGPT, Claude web, Claude Desktop o Cowork.

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/")
))