Dokumentacja serwera MCP Foliade

Połącz konto w Codex

Samo zainstalowanie wtyczki nie łączy jeszcze konta. Po instalacji uruchom to polecenie w terminalu komputera, poza rozmową z Codex:

codex mcp login foliade

Na stronie Foliade, która się otworzy, zaloguj się, zweryfikuj adres konta i autoryzuj połączenie. Następnie wróć do kreatora.

Jeśli przeglądarka się nie otworzy, otwórz link wyświetlony w terminalu. Nie udostępniaj tego linku do logowania.

Przed kontynuowaniem poczekaj na potwierdzenie logowania w terminalu. Nie trzeba kopiować żadnego klucza API.

Sprawdź połączenie i wyślij pierwszy PDF · Instalacja Claude Code

Transport i uwierzytelnianie

MCP jest dostępny bezpłatnie, z kontem lub bez. Codex i Claude Code przestrzegają uprawnień planu; ich własne warunki dostępu obowiązują osobno.

Bezpłatne konto: 5 opublikowanych katalogów, 50 MB i 100 stron na PDF. Witryna i MCP dzielą limit 10 prób przesłania na 24 godziny, w tym zastąpień i błędów, z tylko jednym przesyłaniem w toku. Wyświetlenia pozostają bez limitu.

Bez konta, w witrynie lub przez MCP: 3 pliki PDF na IP w ciągu 24 godzin, 50 MB i 100 stron na PDF, jedno przesyłanie w toku. Publikacja przez 30 dni, prywatne zarządzanie przez 30 minut. Zachowaj prywatny link, aby przypisać katalog do konta przed wygaśnięciem.

Ochrona bezpłatnej usługi: przetwarzanie do 120 sekund, 512 MB na wynik i 2 GB miejsca na konto. Łączna pojemność jest ograniczona; płatne plany mają pierwszeństwo. Po odmowie odczekaj wskazany czas bez automatycznego ponawiania.

Przed każdym przesłaniem asystent sprawdza konto lub tryb gościa i wyjaśnia limity zwrócone przez Foliade. Wersja robocza pozostaje prywatna do czasu żądania publikacji.

https://foliade.gekkode.com/mcp

Logowanie OAuth jest opcjonalne przy przesyłaniu jako gość i wymagane do dostępu do konta, także bezpłatnego. Serwer sprawdza uprawnienia przy każdej operacji; wygasłe połączenie nigdy nie zmienia się w dostęp gościa.

Token dostępu ważny jest przez godzinę. Tokeny odnowienia zmieniają się przy każdym użyciu, bez przedłużania połączenia powyżej 30 dni. Ponownie użyty token odnowienia unieważnia całe połączenie.

Klienci mogą korzystać z dynamicznej rejestracji lub dokumentów tożsamości klienta OpenAI i Anthropic. Metadane są publiczne:

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

Uprawnienia są rozdzielone:

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

Narzędzia przesyłania i publikowania

Dostosowywanie Foliade za pomocą asystenta

Serwer udostępnia 35 narzędzia. 26 narzędzi konfiguracji wymaga połączonego konta i przestrzega uprawnień Twojego planu.

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, links 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 s 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.

Przesyłanie lokalnego pliku PDF

Serwer zdalny nie może odczytać ścieżki na Twoim komputerze. Wtyczka oblicza rozmiar i odcisk palca SHA-256 wybranego pliku, przygotowuje depozyt, wysyła jego bajty poprzez HTTPS, a następnie finalizuje wersję roboczą.

Bilet wygasa po 10 minutach i umożliwia przesłanie wyłącznie zadeklarowanego PDF w ciągu 120 sekund. Bezpłatny plan pozwala na jedno przesyłanie w toku; płatne konta mogą otworzyć pięć transferów.

Konwersja jest asynchroniczna. Asystent sprawdza jego wynik przed ogłoszeniem sukcesu. Publikacja publiczna wymaga osobnego działania; wersja robocza domyślnie pozostaje prywatna.

Plik PDF musi być czytelny, wolny od hasła i mieścić się w limicie wyświetlanym przez narzędzie do weryfikacji konta.

Błędy i unieważnienie

• 401: brak połączenia, wygasło lub odwołane. Połącz ponownie konto.
• 403 zwrócony przez Foliade: niewystarczające pozwolenie. Sprawdź przyznane uprawnienia. W przypadku odrzucenia Cloudflare 403/1010, zobacz sekcję dotyczącą rozwiązywania problemów poniżej.
• 413: plik jest za duży. Zmniejsz plik PDF.
• 422: otrzymany plik różni się od pliku ogłoszonego. Powtórz przelew.
• 429: zbyt wiele żądań. Przestrzegaj limitu czasu ponownej próby.

Błędy narzędzia są raportowane w wyniku MCP. Katalog z innego konta pozostaje niedostępny. Uszkodzony plik PDF lub nieudana konwersja nigdy nie powinny być przedstawiane jako pomyślne.

W Foliade → API → Połączeni asystenci możesz unieważnić każde połączenie. Dostęp kończy się natychmiast, bez usuwania katalogów.

Wtyczka włączona, ale narzędzia MCP niedostępne

Włączona wtyczka może nadal nie łączyć się z serwerem. Przed ponowną instalacją wtyczki lub ponownym podłączeniem konta sprawdź status i komunikat o błędzie MCP.

1. Jeśli nie można znaleźć serwera, sprawdź, czy wtyczka jest zainstalowana i włączona.
2. Jeśli połączenie przekroczy limit czasu uruchamiania, sprawdź logi MCP. Przekroczenie limitu czasu po 30 sekundach nie oznacza, że ​​połączenie OAuth wygasło.
3. Jeśli odpowiedź Cloudflare 403 zawiera błąd 1010 lub browser_signature_banned, Browser Integrity Check blokuje klienta HTTP, zanim dotrze on do Foliade. Zwiększenie limitu czasu uruchamiania nie naprawia tego odrzucenia.
4. Jeśli Foliade zwróci 401 lub invalid_token, podłącz ponownie swoje konto poprzez OAuth. Nie zastępuj tego połączenia dostępem dla gości.

Co mam zrobić jeśli Cloudflare blokuje połączenie?

W przypadku hostowanej usługi Foliade skontaktuj się z naszym zespołem pomocy technicznej, podając godzinę i strefę czasową, adres URL, którego dotyczy problem, kod błędu i Cloudflare Ray ID, jeśli jest wyświetlany. Nie wysyłaj tokenów, plików cookie, linków do logowania ani dokumentów prywatnych. Na Twoim komputerze nie ma żadnych ustawień Cloudflare do zmiany.

Status usługi · Skontaktuj się z obsługą Foliade

Po naprawieniu serwera zrestartuj asystenta, aby ponownie załadować narzędzia MCP, a następnie poproś go o sprawdzenie podłączonego konta Foliade. Wyślij plik PDF dopiero po udostępnieniu narzędzi i potwierdzeniu adresu e-mail konta.

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