Foliade MCP server documentation

Connect your account in Codex

Installing the plugin does not connect your account yet. After installation, run this command in your computer's terminal, outside the Codex conversation:

codex mcp login foliade

On the Foliade page that opens, sign in, check the account email and authorize the connection. Then return to your assistant.

If the browser does not open, open the link shown in the terminal. Do not share this sign-in link.

Wait for the terminal to confirm that login succeeded before continuing. There is no API key to copy.

Check the connection and send your first PDF · Install in Claude Code

Transport and authentication

MCP is included for free, with or without an account. Codex and Claude Code follow your plan permissions; their own access terms remain separate.

Free account: 5 published catalogues, 50 MB and 100 pages per PDF. The website and MCP share 10 upload attempts per 24 hours, including replacements and failures, with only one upload in progress. Views remain unlimited.

Without an account, on the website or through MCP: 3 PDFs per IP per 24 hours, 50 MB and 100 pages per PDF, one upload in progress. Publication lasts 30 days; private management lasts 30 minutes. Keep the private link to attach the catalogue to an account before it expires.

Free tier protection: processing is limited to 120 seconds, 512 MB per result and 2 GB of storage per account. Overall capacity is limited; paid plans have priority. If a request is refused, wait for the stated delay without automatic retries.

Before each transfer, the assistant checks the account or guest mode and explains the limits returned by Foliade. The draft remains private until you request publication.

https://foliade.gekkode.com/mcp

OAuth sign-in is optional for a guest upload and required to access your account, including a free account. The server checks permissions for every action; an expired connection never becomes guest access.

Access tokens last one hour. Refresh tokens rotate on each use without extending the connection beyond 30 days. Reusing a refresh token revokes the entire connection.

Customers can use dynamic registration or customer identity documents OpenAI and Anthropic. Metadata is public:

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

The permissions are separated:

• 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.

Upload and publication tools

Customize Foliade from an assistant

The server provides 35 tools. The 26 configuration tools require a connected account and respect your plan permissions.

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.

Transferring a local PDF

The remote server cannot read files from a path on your computer. The plugin computes the selected file's size and SHA-256 digest, prepares an upload, transfers its bytes over HTTPS, then finalizes the draft.

The ticket expires after 10 minutes and only allows transfer of the declared PDF, within 120 seconds. The free tier allows one upload in progress; paid accounts can open five transfers.

The conversion is asynchronous. The assistant checks its result before announcing success. Public publication requires a separate action; the draft remains private by default.

The PDF must be readable, password-free, and within the limit displayed by the account verification tool.

Errors and revocation

• 401: connection missing, expired or revoked. Reconnect the account.
• 403 returned by Foliade: insufficient permission. Check the granted permissions. For a Cloudflare 403/1010 rejection, see the troubleshooting section below.
• 413: file too large. Reduce the PDF.
• 422: the received file differs from the declared file. Start a new upload.
• 429: too many requests. Respect the retry timeout.

Tool errors are reported in their MCP result. A catalog from another account remains inaccessible. A corrupted PDF or failed conversion should never be presented as successful.

In Foliade → API → Connected assistants, you can revoke each connection. Access ends immediately without deleting your catalogues.

Plugin enabled, but MCP tools unavailable

An enabled plugin may still fail to connect to the server. Check the MCP status and error message before reinstalling the plugin or reconnecting your account.

1. If the server cannot be found, check that the plugin is installed and enabled.
2. If the connection exceeds the startup timeout, check the MCP logs. A timeout after 30 seconds does not prove that your OAuth connection has expired.
3. If a Cloudflare 403 response reports error 1010 or browser_signature_banned, Browser Integrity Check is blocking the HTTP client before it reaches Foliade. Increasing the startup timeout does not fix this rejection.
4. If Foliade returns 401 or invalid_token, reconnect your account through OAuth. Do not replace this connection with guest access.

What should I do if Cloudflare blocks the connection?

For the hosted Foliade service, contact our support team with the time and time zone, affected URL, error code and Cloudflare Ray ID if shown. Do not send tokens, cookies, login links or private documents. There are no Cloudflare settings to change on your computer.

Service Status · Contact Foliade support

After the server has been fixed, restart your assistant to reload the MCP tools, then ask it to check the connected Foliade account. Send the PDF only once the tools are available and the account email has been confirmed.

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