Documentação do servidor MCP Foliade

Ligar a sua conta no Codex

Instalar o plugin ainda não liga a sua conta. Após a instalação, execute este comando no terminal do computador, fora da conversa do Codex:

codex mcp login foliade

Na página Foliade que se abre, faça login, verifique o endereço da conta e autorize a conexão. Em seguida, retorne ao seu assistente.

Se o navegador não abrir, abra a ligação apresentada no terminal. Não partilhe esta ligação de início de sessão.

Antes de continuar, aguarde que o terminal confirme o início de sessão. Não é necessário copiar nenhuma chave API.

Verificar a ligação e enviar o primeiro PDF · Instalação Claude Code

Transporte e autenticação

O MCP está incluído gratuitamente, com ou sem conta. O Codex e o Claude Code respeitam os direitos do seu plano; as suas próprias condições de acesso são independentes.

Conta gratuita: 5 catálogos publicados, 50 MB e 100 páginas por PDF. O site e o MCP partilham 10 tentativas de carregamento por 24 horas, incluindo substituições e falhas, com apenas um carregamento em curso. As visualizações continuam ilimitadas.

Sem conta, no site ou por MCP: 3 PDF por IP por 24 horas, 50 MB e 100 páginas por PDF, um carregamento em curso. Publicação durante 30 dias, gestão privada durante 30 minutos. Guarde a ligação privada para associar o catálogo a uma conta antes de expirar.

Proteção do serviço gratuito: processamento limitado a 120 segundos, 512 MB por resultado e 2 GB de armazenamento por conta. A capacidade global é limitada; os planos pagos têm prioridade. Em caso de recusa, aguarde o prazo indicado sem tentativas automáticas.

Antes de cada transferência, o assistente verifica a conta ou o modo convidado e explica os limites indicados pelo Foliade. O rascunho permanece privado até pedir a publicação.

https://foliade.gekkode.com/mcp

A ligação OAuth é opcional para um carregamento como convidado e necessária para aceder à sua conta, incluindo gratuita. O servidor verifica os direitos em cada ação; uma ligação expirada nunca se torna um acesso de convidado.

O token de acesso dura uma hora. Os tokens de renovação giram a cada uso, sem estender a conexão além de 30 dias. Um token de renovação reutilizado revoga toda a conexão.

Os clientes podem utilizar registro dinâmico ou documentos de identidade do cliente OpenAI e Anthropic. Os metadados são públicos:

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

As permissões são separadas:

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

Ferramentas de carregamento e publicação

Personalizar o Foliade com um assistente

O servidor disponibiliza 35 ferramentas. As 26 ferramentas de configuração exigem uma conta ligada e respeitam as permissões do seu plano.

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.

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

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

Transferindo um PDF local

O servidor remoto não consegue ler um caminho no seu computador. O plugin calcula o tamanho e a impressão digital SHA-256 do arquivo escolhido, prepara um depósito, envia seus bytes via HTTPS e finaliza o rascunho.

O ticket expira após 10 minutos e só permite transferir o PDF indicado, em 120 segundos no máximo. O plano gratuito permite um carregamento em curso; as contas pagas podem abrir cinco transferências.

A conversão é assíncrona. O assistente verifica o resultado antes de anunciar o sucesso. A publicação pública requer uma ação separada; o rascunho permanece privado por padrão.

O PDF deve ser legível, sem senha e dentro do limite exibido pela ferramenta de verificação de conta.

Erros e revogação

• 401: conexão ausente, expirada ou revogada. Reconecte a conta.
• 403 retornado por Foliade: permissão insuficiente. Verifique as permissões concedidas. Para uma rejeição Cloudflare 403/1010, consulte a seção de solução de problemas abaixo.
• 413: arquivo muito grande. Reduza o PDF.
• 422: arquivo recebido diferente do arquivo anunciado. Repita a transferência.
• 429: muitos pedidos. Respeite o tempo limite de nova tentativa.

Erros de ferramenta são relatados no resultado MCP. Um catálogo de outra conta permanece inacessível. Um PDF corrompido ou uma conversão com falha nunca deve ser apresentado como bem-sucedido.

Em Foliade → API → Assistentes conectados pode revogar cada ligação. O acesso termina imediatamente, sem eliminar os seus catálogos.

Plugin ativado, mas ferramentas MCP indisponíveis

Um plugin habilitado ainda pode não conseguir se conectar ao servidor. Verifique o status do MCP e a mensagem de erro antes de reinstalar o plugin ou reconectar sua conta.

1. Se o servidor não for encontrado, verifique se o plugin está instalado e habilitado.
2. Se a conexão exceder o tempo limite de inicialização, verifique os logs do MCP. Um tempo limite após 30 segundos não prova que a sua ligação OAuth expirou.
3. Se uma resposta Cloudflare 403 indicar o erro 1010 ou browser_signature_banned, Browser Integrity Check está a bloquear o cliente HTTP antes de chegar ao Foliade. Aumentar o tempo limite de inicialização não corrige esta recusa.
4. Se Foliade retornar 401 ou invalid_token, reconecte sua conta através de OAuth. Não substitua esta conexão pelo acesso de convidado.

O que devo fazer se Cloudflare bloquear a conexão?

Para o serviço hospedado Foliade, entre em contato com nossa equipe de suporte com a hora e fuso horário, URL afetado, código de erro e Cloudflare Ray ID, se mostrado. Não envie tokens, cookies, links de login ou documentos privados. Não há configurações Cloudflare para alterar em seu computador.

Estado do Serviço · Entre em contato com o suporte Foliade

Após a correção do servidor, reinicie o seu assistente para recarregar as ferramentas MCP e, em seguida, peça para verificar a conta Foliade conectada. Envie o PDF somente quando as ferramentas estiverem disponíveis e o e-mail da conta for 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/")
))