Agent per MCP verbinden

Verbinden Sie PDFCraft mit einem KI-Agenten, der entfernte MCP-Server unterstützt. Ihr Agent kann PDFs in Markdown oder EPUB umwandeln sowie PDFs und EPUB-Bücher übersetzen. Außerdem kann er Ihr Guthaben prüfen, Kosten schätzen und Ergebnisse herunterladen.

Verbindung einrichten

1. Erstellen Sie Ihren eigenen API Key in der OOMOL Console.
2. Fügen Sie in den Einstellungen Ihres Agenten einen entfernten MCP-Server hinzu. Verwenden Sie https://api.pdfcraft.ai/v1/mcp als URL und Streamable HTTP als Transport.
3. Fügen Sie den Header Authorization: Bearer YOUR_API_KEY hinzu und ersetzen Sie YOUR_API_KEY durch Ihren Schlüssel.

Das folgende JSON zeigt die Verbindungsdaten. Die Feldnamen hängen vom Client ab. Tragen Sie die Werte in dessen Einstellungen für URL und HTTP-Header ein:

{  "url": "https://api.pdfcraft.ai/v1/mcp",  "headers": {    "Authorization": "Bearer YOUR_API_KEY"  }}

Bewahren Sie den Schlüssel in den geschützten Einstellungen des Clients auf. Fügen Sie ihn weder in Unterhaltungen noch in Datei-URLs ein. Konvertierungen verbrauchen PDFCraft-Credits. Sie können Ihr Guthaben hier aufladen.

Kompatibilität prüfen

Der Dienst verwendet Streamable HTTP mit der MCP-Protokollversion 2026-07-28. Ihr Client muss diese Version und eigene Bearer-Authentifizierungsheader unterstützen. Ältere Initialisierungs- und Sitzungsabläufe aus dem Jahr 2025 werden nicht unterstützt.

Eine interaktive OAuth-Anmeldung ist nicht verfügbar. Clients, die OAuth voraussetzen und keinen Bearer API Key senden können, lassen sich nicht direkt verbinden.

Erste Datei konvertieren

Nach dem Verbinden kann Ihr Agent die verfügbaren Tools und deren Anleitungen abrufen. Bitten Sie ihn, zuerst get_capabilities aufzurufen, um unterstützte Formate, Sprachen und Abläufe zu erfahren. Zum Beispiel:

Wandle diese PDF in EPUB um. Prüfe vorher mein Guthaben und schätze die Kosten.

Zum Hochladen braucht der Agent Zugriff auf die Dateiinhalte. Ein lokaler Pfad allein reicht dem entfernten Server nicht aus. Anschließend kann er einen Auftrag erstellen, die Datei hochladen, die Verarbeitung starten, den Fortschritt prüfen und einen Downloadlink abrufen. Bewahren Sie die Auftrags-UUID auf, um später fortzufahren.

Standardmäßig erhalten Sie die vollständige Datei. Wird der Download wegen eines offenen Betrags gesperrt, laden Sie Ihr Guthaben auf und fordern Sie für denselben Auftrag einen neuen Link an. Eine unvollständige Datei wird nur auf ausdrücklichen Wunsch und nur dann bereitgestellt, wenn sie verfügbar ist.

Für die direkte Einbindung in Ihre Anwendung siehe REST-API-Referenz.