MCP · 1.1.0

Serverdokumentation MCP Foliade

Derselbe gehostete Server verbindet Codex und Claude Code mit Ihrem Konto. Beide Plugins bieten Anweisungen zum sicheren Übertragen einer lokalen PDF-Datei.

Installation Codex · Installation Claude Code

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

Transport und Authentifizierung

MCP ist kostenlos enthalten, mit oder ohne Konto. Codex und Claude Code beachten die Rechte Ihres Tarifs; ihre eigenen Zugangsbedingungen gelten zusätzlich.

Kostenloses Konto: 5 veröffentlichte Kataloge, 50 MB und 100 Seiten je PDF. Website und MCP teilen sich 10 Uploadversuche pro 24 Stunden, einschließlich Ersetzungen und Fehlern, mit nur einem laufenden Upload. Aufrufe bleiben unbegrenzt.

Ohne Konto, auf der Website oder über MCP: 3 PDFs je IP in 24 Stunden, 50 MB und 100 Seiten je PDF, ein laufender Upload. Veröffentlichung für 30 Tage, private Verwaltung für 30 Minuten. Bewahren Sie den privaten Link auf, um den Katalog vor Ablauf einem Konto zuzuordnen.

Schutz des kostenlosen Angebots: Verarbeitung höchstens 120 Sekunden, 512 MB je Ergebnis und 2 GB Speicher je Konto. Die Gesamtkapazität ist begrenzt; kostenpflichtige Tarife haben Vorrang. Bei Ablehnung warten Sie die angegebene Zeit ohne automatische Wiederholungen.

Vor jeder Übertragung prüft der Assistent das Konto oder den Gastmodus und erklärt die von Foliade gemeldeten Grenzen. Der Entwurf bleibt privat, bis Sie die Veröffentlichung anfordern.

https://foliade.gekkode.com/mcp

Die OAuth-Anmeldung ist für Gast-Uploads optional und für den Kontozugriff erforderlich, auch bei kostenlosen Konten. Der Server prüft die Rechte bei jeder Aktion; eine abgelaufene Verbindung wird nie zu einem Gastzugang.

Das Zugriffstoken ist eine Stunde lang gültig. Die Erneuerungstoken wechseln sich bei jeder Nutzung ab, ohne dass die Verbindung länger als 30 Tage verlängert wird. Ein wiederverwendetes Erneuerungstoken widerruft die gesamte Verbindung.

Kunden können die dynamischen Registrierungs- oder Kundenidentitätsdokumente OpenAI und Anthropic verwenden. Metadaten sind öffentlich:

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

Die Berechtigungen sind getrennt:

foliade:read — Konto, Kataloge und Statistiken lesen;
foliade:write — ein PDF übertragen und einen Entwurf erstellen;
foliade:publish – einen Katalog veröffentlichen oder die Veröffentlichung rückgängig machen.

Die acht Werkzeuge

Werkzeug	Einstellungen	Ergebnis
`foliade_account`	—	Kontoadresse, Angebot und maximale PDF-Größe.
`foliade_list_catalogues`	`limit=25 (1–100), offset=0`	Kontokataloge und Paginierungsschieberegler.
`foliade_prepare_upload`	`filename, size_bytes, sha256, notice_version, guest_mode=false, title="", language="fr"`	Repository-ID, HTTPS-URL und temporärer Header zum Hochladen der PDF-Datei.
`foliade_finalize_upload`	`upload_id, guest_token=""`	Privater Entwurfs- und Umwandlungsstatus. Bei einer Wiederholung bleibt derselbe Katalog erhalten.
`foliade_catalogue_status`	`catalogue_id, guest_token=""`	Katalogstatus, Seiten und Konvertierungsfortschritt.
`foliade_publish_catalogue`	`catalogue_id, guest_token=""`	Veröffentlichung des bestehenden Katalogs, ohne Rückkonvertierung.
`foliade_catalogue_stats`	`catalogue_id, days=30 (1–3650)`	Aggregierte Statistiken, ohne Kontaktdaten.
`foliade_unpublish_catalogue`	`catalogue_id, guest_token=""`	Schließen des öffentlichen Links, ohne die Daten zu löschen.

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

Das Ticket läuft nach 10 Minuten ab und erlaubt nur die Übertragung der angegebenen PDF innerhalb von 120 Sekunden. Kostenlos ist ein laufender Upload erlaubt; bezahlte Konten können fünf Übertragungen öffnen.

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.

Das PDF muss lesbar und passwortfrei sein und innerhalb des vom Kontoverifizierungstool angezeigten Limits liegen.

Irrtümer und Widerruf

401: Verbindung fehlt, ist abgelaufen oder widerrufen. Verbinden Sie das Konto erneut.
403: Unzureichende Berechtigung. Prüfen Sie das Angebot und die berechtigten Rechte.
413: Datei zu groß. Reduzieren Sie das PDF.
422: Die empfangene Datei unterscheidet sich von der angekündigten Datei. Wiederholen Sie die Übertragung.
429: Zu viele Anfragen. Beachten Sie das Zeitlimit für Wiederholungsversuche.

Werkzeugfehler werden in ihrem MCP-Ergebnis gemeldet. Auf einen Katalog von einem anderen Konto aus kann weiterhin nicht zugegriffen werden. Eine beschädigte PDF-Datei oder eine fehlgeschlagene Konvertierung sollte niemals als erfolgreich dargestellt werden.

Unter Foliade → API → Verbundene Assistenten können Sie jede Verbindung widerrufen. Der Zugriff endet sofort, ohne Ihre Kataloge zu löschen.

Quellen und Verbreitung

Öffentliches Connector-Repository · README · Fertigkeit Foliade

ZIP-Plugin · Fertigkeits-Postleitzahl · SHA-256

Dieser öffentliche Katalog wird von Foliade verwaltet. Es stellt keine Präsenz in den offiziellen Verzeichnissen OpenAI oder Anthropic dar, die einer separaten Validierung bedürfen.

Kompatibilität mit der alten Installation

Das lokale Python-Skript bleibt als erweiterte Lösung mit einem API-Schlüssel und seinen fünf historischen Tools verfügbar. Es wird nicht mehr durch Plugins 1.1.0 gestartet. Seine Schlüssel und Einstellungen sind unabhängig von der OAuth-Verbindung.

Historisches STDIO-Skript · API-Dokumentation REST