OpenAI
Führung MCP
Was ist ein MCP-Server?
Ein MCP-Server stellt einem KI-Client strukturierte Tools zur Verfügung. Mit Foliade ermöglicht es Codex oder Claude Code, ein PDF zu konvertieren, seinen Link abzurufen und seine Statistiken abzurufen, ohne API-Aufrufe manuell kopieren zu müssen.
Ein gemeinsamer Server, zwei Plugins
Derselbe gehostete Server verbindet Codex und Claude Code mit Ihrem Konto. Beide Plugins bieten Anweisungen zum sicheren Übertragen einer lokalen PDF-Datei.
Eine Anwendung mit REST-API muss einen Kontoschlüssel bereitstellen. MCP verwendet OAuth für Ihr Konto oder ein auf den Upload beschränktes privates Token im Gastmodus.
Bevor Sie beginnen
MCP ist kostenlos enthalten, mit oder ohne Konto. Codex und Claude Code beachten die Rechte Ihres Tarifs; ihre eigenen Zugangsbedingungen gelten zusätzlich.
Installieren Sie das Plugin, verbinden Sie Ihr Konto und autorisieren Sie den Zugriff. Es sind keine lokalen Server, keine API-Schlüssel und keine Python-Installation erforderlich.
Ihr Konto in Codex verbinden
Die Installation des Plugins verbindet Ihr Konto noch nicht. Führen Sie nach der Installation diesen Befehl im Terminal Ihres Computers aus, außerhalb der Codex-Unterhaltung:
codex mcp login foliade
Melden Sie sich auf der Seite Foliade an, die sich öffnet, überprüfen Sie die Kontoadresse und autorisieren Sie die Verbindung. Kehren Sie dann zu Ihrem Assistenten zurück.
Falls sich der Browser nicht öffnet, öffnen Sie den im Terminal angezeigten Link. Teilen Sie diesen Anmeldelink nicht.
Warten Sie auf die Bestätigung der erfolgreichen Anmeldung im Terminal, bevor Sie fortfahren. Sie müssen keinen API-Schlüssel kopieren.
Verbindung prüfen und das erste PDF senden · Installation Claude Code
Übertragen eines lokalen PDF
Der Remote-Server kann einen Pfad auf Ihrem Computer nicht lesen. Das Plugin berechnet die Größe und den SHA-256-Fingerabdruck der ausgewählten Datei, bereitet eine Einzahlung vor, sendet ihre Bytes über HTTPS und stellt dann den Entwurf fertig.
Die Konvertierung erfolgt asynchron. Der Assistent prüft sein Ergebnis, bevor er den Erfolg meldet. Eine öffentliche Veröffentlichung erfordert eine gesonderte Maßnahme; Der Entwurf bleibt standardmäßig privat.
Zugriff kontrollieren und widerrufen
Unter Foliade → API → Verbundene Assistenten können Sie jede Verbindung widerrufen. Der Zugriff endet sofort, ohne Ihre Kataloge zu löschen.
Diese Anleitungen betreffen Codex und Claude Code mit Zugriff auf lokale Dateien. Sie garantieren nicht die Übertragung von Anhängen an ChatGPT, Claude Web, Claude Desktop oder Cowork.
Plugin aktiviert, aber MCP-Tools nicht verfügbar
Ein aktiviertes Plugin kann möglicherweise immer noch keine Verbindung zum Server herstellen. Überprüfen Sie den MCP-Status und die Fehlermeldung, bevor Sie das Plugin neu installieren oder Ihr Konto erneut verbinden.
- Wenn der Server nicht gefunden werden kann, überprüfen Sie, ob das Plugin installiert und aktiviert ist.
- Wenn die Verbindung das Startzeitlimit überschreitet, überprüfen Sie die MCP-Protokolle. Ein Timeout nach 30 Sekunden beweist nicht, dass Ihre OAuth-Verbindung abgelaufen ist.
- Wenn eine Cloudflare-403-Antwort den Fehler 1010 oder browser_signature_banned meldet, blockiert Browser Integrity Check den HTTP-Client, bevor er Foliade erreicht. Durch Erhöhen des Start-Timeouts wird diese Ablehnung nicht behoben.
- Wenn Foliade 401 oder invalid_token zurückgibt, verbinden Sie Ihr Konto erneut über OAuth. Ersetzen Sie diese Verbindung nicht durch einen Gastzugang.
Was soll ich tun, wenn Cloudflare die Verbindung blockiert?
Für den gehosteten Foliade-Dienst kontaktieren Sie unser Support-Team unter Angabe der Uhrzeit und Zeitzone, der betroffenen URL, des Fehlercodes und Cloudflare Ray ID, falls angezeigt. Senden Sie keine Token, Cookies, Anmeldelinks oder privaten Dokumente. Auf Ihrem Computer müssen keine Cloudflare-Einstellungen geändert werden.
Servicestatus · Kontaktieren Sie den Foliade-Support
Nachdem der Server repariert wurde, starten Sie Ihren Assistenten neu, um die MCP-Tools neu zu laden, und bitten Sie ihn dann, das verbundene Foliade-Konto zu überprüfen. Senden Sie das PDF erst, wenn die Tools verfügbar sind und die E-Mail-Adresse des Kontos bestätigt wurde.
Für Serverbetreiber: Browser Integrity Check beheben
Dieses Verfahren richtet sich an den Cloudflare-Administrator des Servers. Überprüfen Sie zunächst, ob Browser Integrity Check die Ablehnung verursacht hat. Eine Zeitüberschreitung allein kann eine andere Ursache haben.
- Öffnen Sie in Cloudflare die Zone des Servers und dann Regeln → Konfigurationsregeln. Erstellen Sie eine Regel mit einem benutzerdefinierten Ausdruck, der auf den Hostnamen und die Routen MCP und OAuth beschränkt ist.
- Fügen Sie nur die Einstellung Browser Integrity Check hinzu und deaktivieren Sie sie in dieser Regel. Behalten Sie die anderen Schutzmaßnahmen, Authentifizierungs- und Ratenbeschränkungen bei.
Ausdruck, der für den Foliade-Server verwendet wird. Passen Sie für einen anderen Server den Hostnamen und die Routen an seine Implementierung an:
(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/")
))
Testen Sie nach der Bereitstellung mit demselben HTTP-Client: Die Aufrufe initialize und tools/list sowie der Abruf der OAuth-Metadaten müssen erfolgreich sein. Foliade liefert eine Liste mit 35 Tools; der Zugriff auf Kataloge ohne Authentifizierung muss weiterhin 401 zurückgeben.
Um ein Rollback durchzuführen, deaktivieren Sie nur diese Regel. Vermeiden Sie es, den Cloudflare-Schutz global zu deaktivieren oder den Benutzeragenten zu ändern, um das Problem zu verbergen.
Cloudflare: Fehler 1010 · Cloudflare: Deaktivieren Sie diese Prüfung für bestimmte Routen
Anthropic