MCP · 1.1.0

Documentação do servidor MCP Foliade

O mesmo servidor hospedado conecta Codex e Claude Code à sua conta. Ambos os plug-ins fornecem instruções para transferir um PDF local com segurança.

Instalação Codex · Instalação Claude Code

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 — ler a conta, catálogos e estatísticas;
foliade:write — transfira um PDF e crie um rascunho;
foliade:publish — publicar ou cancelar a publicação de um catálogo.

As oito ferramentas

Ferramenta	Definições	Resultado
`foliade_account`	—	Endereço da conta, oferta e tamanho máximo do PDF.
`foliade_list_catalogues`	`limit=25 (1–100), offset=0`	Catálogos de contas e controle deslizante de paginação.
`foliade_prepare_upload`	`filename, size_bytes, sha256, notice_version, guest_mode=false, title="", language="fr"`	ID do repositório, URL HTTPS e cabeçalho temporário para carregar o PDF.
`foliade_finalize_upload`	`upload_id, guest_token=""`	Rascunho privado e status de conversão. Uma repetição mantém o mesmo catálogo.
`foliade_catalogue_status`	`catalogue_id, guest_token=""`	Status do catálogo, páginas e progresso da conversão.
`foliade_publish_catalogue`	`catalogue_id, guest_token=""`	Publicação do catálogo existente, sem reconversão.
`foliade_catalogue_stats`	`catalogue_id, days=30 (1–3650)`	Estatísticas agregadas, sem dados de contato.
`foliade_unpublish_catalogue`	`catalogue_id, guest_token=""`	Fechando o link público, sem excluir os dados.

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: permissão insuficiente. Verifique a oferta e os direitos autorizados.
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.

Fontes e distribuição

Repositório de conector público · LEIA-ME · Habilidade Foliade

Plug-in ZIP · ZIP de habilidade · SHA-256

Este catálogo público é mantido por Foliade. Não constitui presença nos diretórios oficiais OpenAI ou Anthropic, que requerem validação separada.

Compatibilidade com a instalação antiga

O script Python local permanece disponível como uma solução avançada com uma chave de API e suas cinco ferramentas históricas. Não é mais lançado pelos plugins 1.1.0. Suas chaves e configurações são independentes da conexão OAuth.

Script histórico STDIO · Documentação API REST