foliade

Przewodnik MCP

Co to jest serwer MCP?

Serwer MCP udostępnia ustrukturyzowane narzędzia klientowi AI. Dzięki Foliade umożliwia Codex lub Claude Code konwersję pliku PDF, pobranie jego łącza i sprawdzenie statystyk bez ręcznego kopiowania wywołań API.

Wspólny serwer, dwie wtyczki

Ten sam hostowany serwer łączy Codex i Claude Code z Twoim kontem. Obie wtyczki zawierają instrukcje dotyczące bezpiecznego przesyłania lokalnego pliku PDF.

Aplikacja korzystająca z REST API musi podać klucz konta. MCP używa OAuth dla konta lub prywatnego tokena ograniczonego do przesyłanego pliku w trybie gościa.

Zanim zaczniesz

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.

Zainstaluj wtyczkę, podłącz swoje konto i autoryzuj dostęp. Nie są wymagane żadne lokalne serwery, żadne klucze API ani instalacja Pythona.

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

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ą.

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

Kontroluj i cofaj dostęp

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

Poradniki te dotyczą Codex i Claude Code z dostępem do plików lokalnych. Nie gwarantują przesyłania załączników do ChatGPT, Claude web, Claude Desktop lub Cowork.

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.

Dla operatorów serwerów: napraw Browser Integrity Check

Ta procedura jest przeznaczona dla administratora konfiguracji Cloudflare serwera. Najpierw sprawdź, czy odrzucenie spowodował Browser Integrity Check; samo przekroczenie limitu czasu może mieć inną przyczynę.

  1. W Cloudflare otwórz strefę serwera, następnie Reguły → Reguły konfiguracji. Utwórz regułę z niestandardowym wyrażeniem ograniczonym do nazwy hosta i tras MCP i OAuth.
  2. Dodaj tylko ustawienie Browser Integrity Check i wyłącz je w tej regule. Zachowaj pozostałe zabezpieczenia, uwierzytelnianie i limity liczby żądań.

Wyrażenie używane dla serwera Foliade. W przypadku innego serwera dostosuj nazwę hosta i trasy do jego implementacji:

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

Po wdrożeniu sprawdź działanie tym samym klientem HTTP: wywołania initialize i tools/list oraz odczyt metadanych OAuth muszą się powieść. Foliade zwraca listę ośmiu narzędzi; dostęp do katalogów bez uwierzytelnienia musi nadal zwracać 401.

Aby cofnąć zmianę, wyłącz tylko tę regułę. Unikaj globalnego wyłączania zabezpieczeń Cloudflare lub zmiany nagłówka User-Agent w celu ukrycia problemu.

Cloudflare: błąd 1010 · Cloudflare: wyłącz tę kontrolę dla określonych tras

Dokumentacja narzędzi i uwierzytelniania