O que é um servidor MCP?

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

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.

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.

Controlar e revogar acesso

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

Estes guias referem-se ao Codex e Claude Code com acesso a arquivos locais. Não garantem a transferência de anexos para ChatGPT, Claude web, Claude Desktop ou Cowork.

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