Documentación del servidor MCP Foliade

Conecta tu cuenta en Codex

Instalar el complemento todavía no conecta tu cuenta. Después de instalarlo, ejecuta este comando en el terminal de tu ordenador, fuera de la conversación de Codex:

codex mcp login foliade

En la página Foliade que se abre, inicie sesión, verifique la dirección de la cuenta y autorice la conexión. Luego regresa con tu asistente.

Si el navegador no se abre, abre el enlace que aparece en el terminal. No compartas este enlace de inicio de sesión.

Espera a que el terminal confirme que has iniciado sesión antes de continuar. No necesitas copiar ninguna clave API.

Comprueba la conexión y envía tu primer PDF · Instalación Claude Code

Transporte y autenticación

MCP está incluido gratis, con o sin cuenta. Codex y Claude Code respetan los permisos de su plan; sus propias condiciones de acceso son independientes.

Cuenta gratuita: 5 catálogos publicados, 50 MB y 100 páginas por PDF. El sitio y MCP comparten 10 intentos de carga cada 24 horas, incluidas sustituciones y errores, con una sola carga en curso. Las vistas siguen siendo ilimitadas.

Sin cuenta, en el sitio o mediante MCP: 3 PDF por IP cada 24 horas, 50 MB y 100 páginas por PDF, una sola carga en curso. Publicación durante 30 días y gestión privada durante 30 minutos. Conserve el enlace privado para vincular el catálogo a una cuenta antes de que caduque.

Protección del servicio gratuito: procesamiento limitado a 120 segundos, 512 MB por resultado y 2 GB de almacenamiento por cuenta. La capacidad global es limitada; los planes de pago tienen prioridad. Si se rechaza una solicitud, respete el plazo indicado sin reintentos automáticos.

Antes de cada transferencia, el asistente verifica la cuenta o el modo invitado y explica los límites devueltos por Foliade. El borrador sigue siendo privado hasta que solicite publicarlo.

https://foliade.gekkode.com/mcp

La conexión OAuth es opcional para una carga como invitado y necesaria para acceder a su cuenta, también gratuita. El servidor verifica los permisos en cada acción; una conexión caducada nunca se convierte en acceso de invitado.

El token de acceso tiene una duración de una hora. Los tokens de renovación rotan con cada uso, sin extender la conexión más allá de 30 días. Un token de renovación reutilizado revoca toda la conexión.

Los clientes pueden utilizar el registro dinámico o los documentos de identidad del cliente OpenAI y Anthropic. Los metadatos son públicos:

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

Los permisos están separados:

• foliade:read enlace — lire le compte, les réglages, less 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.

Herramientas de carga y publicación

Personalizar Foliade desde un asistente

El servidor ofrece 35 herramientas. Las 26 herramientas de configuración requieren una cuenta conectada y respetan los permisos de su plan.

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.

enlace Le lecteur expose ses couleurs, fonds, barre, contrôles, effets, sens de lecture, son, page de départ, disposition, 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.

enlace Les listes sont paginées. Less 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.

Transferir un PDF local

El servidor remoto no puede leer una ruta en su computadora. El complemento calcula el tamaño y la huella digital SHA-256 del archivo elegido, prepara un depósito, envía sus bytes a través de HTTPS y luego finaliza el borrador.

El ticket caduca a los 10 minutos y solo permite transferir el PDF declarado en un máximo de 120 segundos. El plan gratuito admite una carga en curso; las cuentas de pago pueden abrir cinco transferencias.

La conversión es asincrónica. El asistente comprueba su resultado antes de anunciar el éxito. La publicación pública requiere una acción separada; el borrador permanece privado de forma predeterminada.

El PDF debe ser legible, no tener contraseña y estar dentro del límite mostrado por la herramienta de verificación de cuenta.

Errores y revocación

• 401: conexión faltante, caducada o revocada. Vuelva a conectar la cuenta.
• 403 devuelto por Foliade: permiso insuficiente. Verifique los permisos otorgados. Para un rechazo Cloudflare 403/1010, consulte la sección de solución de problemas a continuación.
• 413: archivo demasiado grande. Reducir el PDF.
• 422: archivo recibido diferente al archivo anunciado. Repita la transferencia.
• 429: demasiadas solicitudes. Respete el tiempo de espera de reintento.

Los errores de herramienta se informan en su resultado MCP. Un catálogo de otra cuenta permanece inaccesible. Un PDF dañado o una conversión fallida nunca deben presentarse como exitosos.

En Foliade → API → Asistentes conectados puedes revocar cada conexión. El acceso se interrumpe inmediatamente, sin eliminar tus catálogos.

Complemento habilitado, pero herramientas MCP no disponibles

Es posible que un complemento habilitado aún no pueda conectarse al servidor. Verifique el estado de MCP y el mensaje de error antes de reinstalar el complemento o volver a conectar su cuenta.

1. Si no se puede encontrar el servidor, verifique que el complemento esté instalado y habilitado.
2. Si la conexión excede el tiempo de espera de inicio, verifique los registros MCP. Un tiempo de espera después de 30 segundos no prueba que su conexión OAuth haya caducado.
3. Si una respuesta Cloudflare 403 indica el error 1010 o browser_signature_banned, Browser Integrity Check bloquea el cliente HTTP antes de que llegue a Foliade. Aumentar el tiempo de espera de inicio no soluciona este rechazo.
4. Si Foliade devuelve 401 o invalid_token, vuelva a conectar su cuenta a través de OAuth. No reemplace esta conexión con acceso de invitados.

¿Qué debo hacer si Cloudflare bloquea la conexión?

Para el servicio alojado Foliade, comuníquese con nuestro equipo de soporte con la hora y la zona horaria, la URL afectada, el código de error y Cloudflare Ray ID si se muestra. No envíe tokens, cookies, enlaces de inicio de sesión ni documentos privados. No hay configuraciones Cloudflare para cambiar en su computadora.

Estado del servicio · Póngase en contacto con el soporte técnico de Foliade

Una vez que se haya reparado el servidor, reinicie su asistente para recargar las herramientas MCP, luego pídale que verifique la cuenta Foliade conectada. Envíe el PDF solo una vez que las herramientas estén disponibles y el correo electrónico de la cuenta haya sido confirmado.

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