Serverdocumentatie MCP Foliade

Je account verbinden in Codex

Het installeren van de plugin verbindt je account nog niet. Voer na de installatie deze opdracht uit in de terminal van je computer, buiten het Codex-gesprek:

codex mcp login foliade

Op de geopende Foliade-pagina logt u in, verifieert u het accountadres en autoriseert u de verbinding. Ga dan terug naar uw wizard.

Als de browser niet opent, open dan de link die in de terminal verschijnt. Deel deze aanmeldlink niet.

Wacht op de bevestiging in de terminal dat het aanmelden is gelukt voordat je verdergaat. Je hoeft geen API-sleutel te kopiëren.

De verbinding controleren en je eerste PDF versturen · Installatie Claude Code

Transport en authenticatie

MCP is gratis inbegrepen, met of zonder account. Codex en Claude Code volgen de rechten van je abonnement; hun eigen toegangsvoorwaarden staan daar los van.

Gratis account: 5 gepubliceerde catalogi, 50 MB en 100 pagina’s per pdf. De website en MCP delen 10 uploadpogingen per 24 uur, inclusief vervangingen en fouten, met één upload tegelijk. Weergaven blijven onbeperkt.

Zonder account, op de website of via MCP: 3 pdf’s per IP per 24 uur, 50 MB en 100 pagina’s per pdf, één upload tegelijk. Publicatie duurt 30 dagen, privébeheer 30 minuten. Bewaar de privélink om de catalogus vóór het verlopen aan een account te koppelen.

Bescherming van het gratis aanbod: maximaal 120 seconden verwerking, 512 MB per resultaat en 2 GB opslag per account. De totale capaciteit is beperkt; betaalde abonnementen hebben voorrang. Wacht bij een weigering de aangegeven tijd zonder automatisch opnieuw te proberen.

Voor elke overdracht controleert de assistent het account of de gastmodus en legt de limieten van Foliade uit. Het concept blijft privé totdat je om publicatie vraagt.

https://foliade.gekkode.com/mcp

OAuth-aanmelding is optioneel voor een gastupload en vereist voor toegang tot je account, ook een gratis account. De server controleert de rechten bij elke actie; een verlopen verbinding wordt nooit gasttoegang.

Het toegangstoken duurt één uur. De verlengingstokens rouleren bij elk gebruik, zonder dat de verbinding langer dan 30 dagen wordt verlengd. Een hergebruikt verlengingstoken trekt de gehele verbinding in.

Klanten kunnen gebruik maken van dynamische registratie- of klantidentiteitsdocumenten OpenAI en Anthropic. Metagegevens zijn openbaar:

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

De machtigingen zijn gescheiden:

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

Tools voor uploaden en publiceren

Foliade aanpassen met een assistent

De server biedt 35 tools. De 26 configuratietools vereisen een gekoppeld account en respecteren de rechten van uw abonnement.

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.

Een lokale PDF overbrengen

De externe server kan een pad op uw computer niet lezen. De plug-in berekent de grootte en SHA-256-vingerafdruk van het gekozen bestand, bereidt een storting voor, verzendt de bytes via HTTPS en voltooit vervolgens het concept.

Het ticket verloopt na 10 minuten en staat alleen overdracht van de opgegeven pdf toe, binnen 120 seconden. Het gratis aanbod staat één upload tegelijk toe; betaalde accounts kunnen vijf overdrachten openen.

De conversie is asynchroon. De assistent controleert het resultaat voordat hij het succes aankondigt. Publieke publicatie vereist een aparte actie; het concept blijft standaard privé.

De pdf moet leesbaar en zonder wachtwoord zijn en binnen de limiet liggen die wordt weergegeven door de accountverificatietool.

Fouten en intrekking

• 401: verbinding ontbreekt, verlopen of ingetrokken. Koppel het account opnieuw.
• 403 geretourneerd door Foliade: onvoldoende toestemming. Controleer de verleende machtigingen. Voor een Cloudflare 403/1010-afwijzing, zie het onderstaande gedeelte over het oplossen van problemen.
• 413: bestand te groot. Verklein de PDF.
• 422: bestand ontvangen dat verschilt van het aangekondigde bestand. Herhaal de overdracht.
• 429: te veel verzoeken. Respecteer de time-out voor opnieuw proberen.

Gereedschapsfouten worden gerapporteerd in hun MCP-resultaat. Een catalogus van een ander account blijft ontoegankelijk. Een beschadigde PDF of mislukte conversie mag nooit als succesvol worden gepresenteerd.

In Foliade → API → Verbonden assistenten kunt u elke verbinding intrekken. De toegang stopt onmiddellijk, zonder uw catalogi te verwijderen.

Plug-in ingeschakeld, maar MCP-tools niet beschikbaar

Het kan zijn dat een ingeschakelde plug-in nog steeds geen verbinding kan maken met de server. Controleer de MCP-status en foutmelding voordat u de plug-in opnieuw installeert of uw account opnieuw koppelt.

1. Als de server niet kan worden gevonden, controleer dan of de plug-in is geïnstalleerd en ingeschakeld.
2. Als de verbinding de opstarttime-out overschrijdt, controleer dan de MCP-logboeken. Een time-out na 30 seconden bewijst niet dat uw OAuth-verbinding is verlopen.
3. Als een Cloudflare 403-antwoord fout 1010 of browser_signature_banned meldt, blokkeert Browser Integrity Check de HTTP-client voordat deze Foliade bereikt. Het verhogen van de opstarttime-out lost deze afwijzing niet op.
4. Als Foliade 401 of invalid_token retourneert, koppelt u uw account opnieuw via OAuth. Vervang deze verbinding niet door gasttoegang.

Wat moet ik doen als Cloudflare de verbinding blokkeert?

Neem voor de gehoste Foliade-service contact op met ons ondersteuningsteam en geef de tijd en tijdzone, de betreffende URL, de foutcode en Cloudflare Ray ID door, indien weergegeven. Stuur geen tokens, cookies, inloglinks of privédocumenten. Er zijn geen Cloudflare-instellingen die u op uw computer kunt wijzigen.

Servicestatus · Neem contact op met Foliade-ondersteuning

Nadat de server is gerepareerd, start u uw assistent opnieuw op om de MCP-tools opnieuw te laden en vraagt u hem vervolgens om het verbonden Foliade-account te controleren. Verstuur de PDF pas zodra de tools beschikbaar zijn en het account-e-mailadres is bevestigd.

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