foliade

Guide MCP

Qu'est-ce qu'un serveur MCP ?

Un serveur MCP expose des outils structurés à un client d'IA. Avec Foliade, il permet à Codex ou Claude Code de convertir un PDF, récupérer son lien et consulter ses statistiques sans recopier manuellement des appels API.

Un serveur commun, deux plugins

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

Une application utilisant l’API REST doit fournir une clé de compte. Le MCP utilise OAuth pour votre compte, ou un jeton privé limité au dépôt pour le mode invité.

Avant de commencer

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.

Installez le plugin, connectez votre compte et autorisez l'accès. Aucun serveur local, aucune clé API et aucune installation de Python ne sont nécessaires.

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

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.

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.

Contrôler et révoquer l'accès

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

Ces guides concernent Codex et Claude Code avec accès aux fichiers locaux. Ils ne garantissent pas le transfert des pièces jointes dans ChatGPT, Claude web, Claude Desktop ou Cowork.

Plugin activé, mais outils MCP indisponibles

Un plugin activé peut échouer à se connecter au serveur. Consultez l’état MCP et le message d’erreur avant de réinstaller le plugin ou de reconnecter votre compte.

  1. Si le serveur est introuvable, vérifiez l’installation et l’activation du plugin.
  2. Si la connexion dépasse le délai de démarrage, consultez les journaux MCP. Un délai dépassé après 30 secondes ne prouve pas que votre connexion OAuth a expiré.
  3. Si la réponse Cloudflare 403 indique l’erreur 1010 ou browser_signature_banned, le contrôle Browser Integrity Check bloque le client HTTP avant son accès à Foliade. Augmenter le délai de démarrage ne corrige pas ce refus.
  4. Si Foliade renvoie 401 ou invalid_token, reconnectez votre compte par OAuth. Ne remplacez pas cette connexion par un accès invité.

Que faire en cas de blocage Cloudflare ?

Sur le service hébergé Foliade, contactez notre support avec l’heure et le fuseau horaire, l’URL concernée, le code d’erreur et le Ray ID Cloudflare s’il est affiché. Ne transmettez aucun jeton, cookie, lien de connexion ou document privé. Vous n’avez pas de réglage Cloudflare à modifier sur votre ordinateur.

État du service · Contacter le support Foliade

Après la correction du serveur, relancez votre assistant pour recharger les outils MCP, puis demandez-lui de vérifier le compte Foliade connecté. Envoyez le PDF seulement lorsque les outils sont disponibles et que l’adresse du compte a été confirmée.

Pour l’exploitant : corriger Browser Integrity Check

Cette procédure concerne l’administrateur Cloudflare du serveur. Vérifiez d’abord que le refus provient bien de Browser Integrity Check ; un simple délai dépassé peut avoir une autre cause.

  1. Dans Cloudflare, ouvrez la zone du serveur, puis Règles → Règles de configuration. Créez une règle avec une expression personnalisée limitée au nom d’hôte et aux routes MCP et OAuth.
  2. Ajoutez uniquement le paramètre Browser Integrity Check et désactivez-le dans cette règle. Conservez les autres protections, l’authentification et les limites de requêtes.

Expression utilisée pour le serveur Foliade. Pour un autre serveur, adaptez le nom d’hôte et les routes à son implémentation :

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

Après déploiement, testez avec le même client HTTP : initialize et tools/list doivent aboutir, ainsi que la lecture des métadonnées OAuth. Pour Foliade, 35 outils sont annoncés ; l’accès aux catalogues sans authentification doit toujours recevoir 401.

Pour revenir en arrière, désactivez uniquement cette règle. Évitez une désactivation globale des protections Cloudflare ou un changement d’agent utilisateur destiné à masquer le problème.

Cloudflare : erreur 1010 · Cloudflare : désactiver ce contrôle sur certaines routes

Référence des outils et de l'authentification