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 — zapoznaj się z rachunkiem, katalogami i statystykami;
• foliade:write — prześlij plik PDF i utwórz wersję roboczą;
• foliade:publish — opublikować lub cofnąć publikację katalogu.

Osiem narzędzi

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: niewystarczające pozwolenie. Sprawdź ofertę i autoryzowane uprawnienia.
• 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.