foliade

Guía MCP

¿Qué es un servidor MCP?

Un servidor MCP expone herramientas estructuradas a un cliente de IA. Con Foliade, permite a Codex o Claude Code convertir un PDF, recuperar su enlace y consultar sus estadísticas sin copiar manualmente las llamadas API.

Un servidor común, dos complementos

El mismo servidor alojado conecta Codex y Claude Code a su cuenta. Ambos complementos brindan instrucciones para transferir un PDF local de forma segura.

Una aplicación que use la API REST debe proporcionar una clave de cuenta. MCP utiliza OAuth para su cuenta o un token privado limitado a la carga en modo invitado.

Antes de empezar

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.

Instale el complemento, conecte su cuenta y autorice el acceso. No se requieren servidores locales, claves API ni instalación de Python.

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

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.

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.

Controlar y revocar el acceso

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

Estas guías se refieren a Codex y Claude Code con acceso a archivos locales. No garantizan la transferencia de archivos adjuntos a ChatGPT, Claude web, Claude Desktop o Cowork.

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.

Para operadores de servidores: corrija Browser Integrity Check

Este procedimiento es para el administrador Cloudflare del servidor. Primero verifique que Browser Integrity Check provocó el rechazo; un tiempo de espera por sí solo puede tener otra causa.

  1. En Cloudflare, abra la zona del servidor, luego Reglas → Reglas de configuración. Cree una regla con una expresión personalizada limitada al nombre de host y las rutas MCP y OAuth.
  2. Agregue únicamente el ajuste Browser Integrity Check y desactívelo en esta regla. Mantenga las demás protecciones, la autenticación y los límites de solicitudes.

Expresión utilizada para el servidor Foliade. Para otro servidor, adapte el nombre de host y las rutas a su implementación:

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

Después del despliegue, pruebe con el mismo cliente HTTP: las llamadas initialize y tools/list, así como la consulta de los metadatos OAuth, deben completarse correctamente. Foliade devuelve una lista de 35 herramientas; el acceso a catálogos sin autenticación debe seguir devolviendo 401.

Para retroceder, deshabilite solo esta regla. Evite deshabilitar las protecciones Cloudflare globalmente o cambiar el agente de usuario para ocultar el problema.

Cloudflare: error 1010 · Cloudflare: deshabilita esta verificación para rutas específicas

Referencia de herramientas y autenticación