OpenAI
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.
- Jeśli nie można znaleźć serwera, sprawdź, czy wtyczka jest zainstalowana i włączona.
- 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.
- 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.
- 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ę.
- 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.
- 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
Anthropic