MCP · 1.1.0

Serverdocumentatie MCP Foliade

Dezelfde gehoste server verbindt Codex en Claude Code met uw account. Beide plug-ins bieden instructies voor het veilig overbrengen van een lokale PDF.

Installatie Codex · Installatie Claude Code

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 — lees het account, catalogi en statistieken;
foliade:write — een PDF overbrengen en een concept maken;
foliade:publish — een catalogus publiceren of de publicatie ervan ongedaan maken.

De acht instrumenten

Gereedschap	Instellingen	Resultaat
`foliade_account`	—	Accountadres, aanbieding en maximale PDF-grootte.
`foliade_list_catalogues`	`limit=25 (1–100), offset=0`	Accountcatalogi en pagineringsschuifregelaar.
`foliade_prepare_upload`	`filename, size_bytes, sha256, notice_version, guest_mode=false, title="", language="fr"`	Repository-ID, HTTPS-URL en tijdelijke header om de PDF te uploaden.
`foliade_finalize_upload`	`upload_id, guest_token=""`	Privéconcept en conversiestatus. Een herhaling behoudt dezelfde catalogus.
`foliade_catalogue_status`	`catalogue_id, guest_token=""`	Catalogusstatus, pagina's en conversievoortgang.
`foliade_publish_catalogue`	`catalogue_id, guest_token=""`	Publicatie van de bestaande catalogus, zonder herconversie.
`foliade_catalogue_stats`	`catalogue_id, days=30 (1–3650)`	Geaggregeerde statistieken, zonder contactgegevens.
`foliade_unpublish_catalogue`	`catalogue_id, guest_token=""`	Het sluiten van de publieke link, zonder de gegevens te verwijderen.

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: onvoldoende toestemming. Controleer het aanbod en de geautoriseerde rechten.
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.

Bronnen en distributie

Openbare connectoropslagplaats · LEESMIJ · Vaardigheid Foliade

ZIP-plug-in · Vaardigheid ZIP · SHA-256

Deze openbare catalogus wordt onderhouden door Foliade. Het vormt geen aanwezigheid in de officiële mappen OpenAI of Anthropic, waarvoor afzonderlijke validatie vereist is.

Compatibiliteit met de oude installatie

Het lokale Python-script blijft beschikbaar als geavanceerde oplossing met een API-sleutel en de vijf historische tools. Het wordt niet langer gelanceerd door plug-ins 1.1.0. De sleutels en instellingen zijn onafhankelijk van de OAuth-verbinding.

Historisch STDIO-script · API-documentatie REST