MCP · 1.1.0

Documentation du serveur MCP Foliade

Le même serveur hébergé relie Codex et Claude Code à votre compte. Les deux plugins fournissent les instructions pour transférer un PDF local en sécurité.

Installation Codex · Installation Claude Code

Connecter votre compte dans Codex

Installer le plugin ne connecte pas encore votre compte. Après l'installation, lancez cette commande dans le terminal de votre ordinateur, en dehors de la conversation Codex :

codex mcp login foliade

Dans la page Foliade qui s'ouvre, connectez-vous, vérifiez l'adresse du compte et autorisez la connexion. Revenez ensuite dans votre assistant.

Si le navigateur ne s'ouvre pas, ouvrez le lien affiché dans le terminal. Ne partagez pas ce lien de connexion.

Attendez la confirmation de connexion dans le terminal avant de continuer. Aucune clé API n'est à copier.

Vérifier la connexion et envoyer un premier PDF · Installation Claude Code

Transport et authentification

Le MCP est inclus gratuitement, avec ou sans compte. Codex et Claude Code appliquent les droits de votre offre ; leurs propres conditions d’accès restent distinctes.

Compte gratuit : 5 catalogues publiés, 50 Mo et 100 pages par PDF. Site et MCP partagent 10 tentatives de dépôt sur 24 heures, remplacements et échecs compris, avec un seul dépôt en cours. Les vues restent illimitées.

Sans compte, sur le site ou par MCP : 3 PDF par IP sur 24 heures, 50 Mo et 100 pages par PDF, un seul dépôt en cours. Publication pendant 30 jours, gestion privée pendant 30 minutes. Conservez le lien privé pour rattacher le catalogue à un compte avant son expiration.

Protection du gratuit : traitement limité à 120 secondes, 512 Mo par résultat et 2 Go de stockage par compte. La capacité globale est limitée ; les offres payantes sont prioritaires. En cas de refus, attendez le délai indiqué sans relance automatique.

Avant chaque transfert, l’assistant vérifie le compte ou le mode invité et vous explique les limites renvoyées par Foliade. Le brouillon reste privé jusqu’à votre demande de publication.

https://foliade.gekkode.com/mcp

La connexion OAuth est facultative pour un dépôt invité et nécessaire pour accéder à votre compte, y compris gratuit. Le serveur vérifie vos droits à chaque action ; une connexion expirée ne devient jamais un accès invité.

Le jeton d'accès dure une heure. Les jetons de renouvellement tournent à chaque usage, sans prolonger la connexion au-delà de 30 jours. Un jeton de renouvellement réutilisé révoque toute la connexion.

Les clients peuvent utiliser l'enregistrement dynamique ou les documents d'identité des clients OpenAI et Anthropic. Les métadonnées sont publiques :

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

Les permissions sont séparées :

foliade:read — lire le compte, les catalogues et les statistiques ;
foliade:write — transférer un PDF et créer un brouillon ;
foliade:publish — publier ou dépublier un catalogue.

Les huit outils

Outil	Paramètres	Résultat
`foliade_account`	—	Adresse du compte, offre et taille maximale du PDF.
`foliade_list_catalogues`	`limit=25 (1–100), offset=0`	Catalogues du compte et curseur de pagination.
`foliade_prepare_upload`	`filename, size_bytes, sha256, notice_version, guest_mode=false, title="", language="fr"`	Identifiant du dépôt, URL HTTPS et en-tête temporaire pour transférer le PDF.
`foliade_finalize_upload`	`upload_id, guest_token=""`	Brouillon privé et état de conversion. Une répétition conserve le même catalogue.
`foliade_catalogue_status`	`catalogue_id, guest_token=""`	État du catalogue, pages et progression de la conversion.
`foliade_publish_catalogue`	`catalogue_id, guest_token=""`	Publication du catalogue existant, sans reconversion.
`foliade_catalogue_stats`	`catalogue_id, days=30 (1–3650)`	Statistiques agrégées, sans coordonnées des contacts.
`foliade_unpublish_catalogue`	`catalogue_id, guest_token=""`	Fermeture du lien public, sans suppression des données.

Transfert d'un PDF local

Le serveur distant ne peut pas lire un chemin sur votre ordinateur. Le plugin calcule la taille et l'empreinte SHA-256 du fichier choisi, prépare un dépôt, envoie ses octets en HTTPS puis finalise le brouillon.

Le ticket expire après 10 minutes et ne permet de transférer que le PDF annoncé, en 120 secondes maximum. Le gratuit autorise un seul dépôt en cours ; les comptes payants peuvent ouvrir cinq transferts.

La conversion est asynchrone. L'assistant vérifie son résultat avant d'annoncer la réussite. La publication publique exige une action distincte ; le brouillon reste privé par défaut.

Le PDF doit être lisible, sans mot de passe, et respecter la limite affichée par l'outil de vérification du compte.

Erreurs et révocation

401 : connexion absente, expirée ou révoquée. Reconnectez le compte.
403 : permission insuffisante. Vérifiez l'offre et les droits autorisés.
413 : fichier trop volumineux. Réduisez le PDF.
422 : fichier reçu différent du fichier annoncé. Recommencez le transfert.
429 : trop de demandes. Respectez le délai de nouvelle tentative.

Les erreurs des outils sont signalées dans leur résultat MCP. Un catalogue d'un autre compte reste inaccessible. Un PDF corrompu ou une conversion échouée ne doit jamais être présenté comme réussi.

Foliade → API → Assistants connectés permet de révoquer chaque connexion. L'accès est coupé immédiatement, sans supprimer vos catalogues.

Sources et distribution

Dépôt public du connecteur · README · Skill Foliade

Plugin ZIP · Skill ZIP · SHA-256

Ce catalogue public est maintenu par Foliade. Il ne constitue pas une présence dans les annuaires officiels OpenAI ou Anthropic, qui demandent une validation séparée.

Compatibilité avec l'ancienne installation

Le script Python local reste disponible comme solution avancée avec une clé API et ses cinq outils historiques. Il n'est plus lancé par les plugins 1.1.0. Ses clés et ses réglages sont indépendants de la connexion OAuth.

Script STDIO historique · Documentation API REST