Serverdokumentation MCP Foliade

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 — lire le compte, les réglages, les links de suivi et les statistiques ;
• foliade:write — transférer un PDF et configurer les catalogues, thèmes, enrichissements et étagères ;
• foliade:publish — gérer les publications, les protections et les adresses publiques.

Tools zum Hochladen und Veröffentlichen

Foliade mit einem Assistenten anpassen

Der Server bietet 35 Tools. Die 26 Konfigurationstools erfordern ein verbundenes Konto und beachten die Berechtigungen Ihres Tarifs.

Commencez par découvrir les capacités, puis lisez les réglages de la cible. Envoyez seulement les champs à modifier avec la révision reçue. Un conflit impose une nouvelle lecture ; les champs inconnus, valeurs nulles et valeurs invalides sont refusés.

Un aperçu avec dry_run ne sauvegarde rien. Pour enregistrer, utilisez la révision initiale, pas celle de l’aperçu. Les réglages d’un catalogue publié sont visibles immédiatement ; les enrichissements disposent d’un brouillon et d’une publication distincte.

Le lecteur expose ses couleurs, fonds, barre, contrôles, effets, sens de lecture, son, page de départ, disposition, link et position du logo, langue et téléchargement PDF. Les éléments interactifs utilisent les 13 types de l’éditeur, avec coordonnées en pourcentage de page.

Les listes sont paginées. Les links de suivi ne déclenchent aucun envoi de message. Modifier la marque du compte peut affecter plusieurs catalogues ; pour un seul PDF, préférez ses réglages propres.

Exemple : harmoniser les couleurs du lecteur

foliade_get_catalogue_settings({"catalogue_id": "IDENTIFIANT"})
foliade_update_catalogue({
  "catalogue_id": "IDENTIFIANT",
  "expected_revision": "REVISION_RENVOYEE_PAR_LA_LECTURE",
  "patch": {
    "fond": "#f7f5f0",
    "barre_fond": "#111111",
    "barre_icones": "#f7f5f0",
    "progression": "#ad935a"
  },
  "dry_run": true
})

Les imports de médias binaires, le remplacement du PDF, la synchronisation des produits, la gestion des clés API, des webhooks, de l’équipe et de la facturation restent accessibles par l’espace web ou l’API REST selon la fonction. Le MCP ne configure pas le DNS ou les certificats TLS.

Si votre assistant ne voit encore que neuf outils, actualisez la liste des outils dans son interface MCP ou relancez la session. Une réinstallation ne doit pas être la première réponse à un cache ancien. Vérifiez ensuite la présence de foliade_capabilities.

Ü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 zurückgegeben von Foliade: unzureichende Berechtigung. Überprüfen Sie die erteilten Berechtigungen. Informationen zu einer Cloudflare 403/1010-Ablehnung finden Sie im Abschnitt zur Fehlerbehebung weiter unten.
• 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.

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.

1. Wenn der Server nicht gefunden werden kann, überprüfen Sie, ob das Plugin installiert und aktiviert ist.
2. 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.
3. 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.
4. 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.

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