MCP · 1.1.0
Documentación del servidor MCP Foliade
El mismo servidor alojado conecta Codex y Claude Code a su cuenta. Ambos complementos brindan instrucciones para transferir un PDF local de forma segura.
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 foliadeEn 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/mcpLa 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/mcpLos permisos están separados:
foliade:read— leer la cuenta, los catálogos y las estadísticas;foliade:write— transferir un PDF y crear un borrador;foliade:publish— publicar o despublicar un catálogo.
Las ocho herramientas
| Herramienta | Configuración | Resultado |
|---|---|---|
foliade_account | — | Dirección de cuenta, oferta y tamaño máximo de PDF. |
foliade_list_catalogues | limit=25 (1–100), offset=0 | Catálogos de cuentas y control deslizante de paginación. |
foliade_prepare_upload | filename, size_bytes, sha256, notice_version, guest_mode=false, title="", language="fr" | ID del repositorio, URL HTTPS y encabezado temporal para cargar el PDF. |
foliade_finalize_upload | upload_id, guest_token="" | Estado de conversión y borrador privado. Una repetición mantiene el mismo catálogo. |
foliade_catalogue_status | catalogue_id, guest_token="" | Estado del catálogo, páginas y progreso de conversión. |
foliade_publish_catalogue | catalogue_id, guest_token="" | Publicación del catálogo existente, sin reconversión. |
foliade_catalogue_stats | catalogue_id, days=30 (1–3650) | Estadísticas agregadas, sin datos de contacto. |
foliade_unpublish_catalogue | catalogue_id, guest_token="" | Cerrando el enlace público, sin borrar los datos. |
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: permiso insuficiente. Consulta la oferta y derechos autorizados.
- 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.
Fuentes y distribución
Repositorio de conectores públicos · LÉAME · Habilidad Foliade
Complemento ZIP · Habilidad ZIP · SHA-256
Este catálogo público es mantenido por Foliade. No constituye presencia en los directorios oficiales OpenAI o Anthropic, que requieren validación por separado.
Compatibilidad con la instalación antigua.
El script Python local sigue disponible como solución avanzada con una clave API y sus cinco herramientas históricas. Ya no se inicia con los complementos 1.1.0. Sus claves y configuraciones son independientes de la conexión OAuth.
Guión histórico STDIO · Documentación API REST