Connecter votre agent avec MCP

Connectez PDFCraft à un agent IA compatible avec les serveurs MCP distants. Votre agent pourra convertir des PDF en Markdown ou en EPUB, traduire des PDF et des livres EPUB, consulter votre solde, estimer le coût et récupérer les résultats.

Configurer la connexion

1. Créez votre propre clé API dans OOMOL Console.
2. Ajoutez un serveur MCP distant dans les paramètres de votre agent. Saisissez https://api.pdfcraft.ai/v1/mcp comme URL et choisissez Streamable HTTP comme transport.
3. Ajoutez l’en-tête Authorization: Bearer YOUR_API_KEY en remplaçant YOUR_API_KEY par votre clé.

Le JSON ci-dessous présente les paramètres de connexion. Les noms des champs dépendent du client : renseignez ces valeurs dans ses réglages d’URL et d’en-têtes HTTP.

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

Conservez votre clé dans les paramètres sécurisés du client. Ne la collez pas dans une conversation et ne l’ajoutez pas aux liens de fichiers. Les conversions consomment des crédits PDFCraft ; vous pouvez recharger votre solde ici.

Vérifier la compatibilité

Le service utilise Streamable HTTP avec la version 2026-07-28 du protocole MCP. Votre client doit prendre en charge cette version et permettre l’ajout d’un en-tête d’authentification Bearer. Les anciens mécanismes d’initialisation et de session de 2025 ne sont pas pris en charge.

La connexion interactive par OAuth n’est pas disponible. Les clients qui imposent OAuth et ne permettent pas l’envoi d’une clé API Bearer ne peuvent pas se connecter directement.

Lancer une première conversion

Une fois connecté, votre agent peut découvrir les outils et lire leurs instructions. Demandez-lui d’appeler d’abord get_capabilities pour connaître les formats, les langues et les étapes à suivre. Par exemple :

Convertis ce PDF en EPUB. Avant de commencer, vérifie mon solde et estime le coût.

L’agent doit pouvoir lire et envoyer le contenu du fichier ; un simple chemin local ne suffit pas au serveur distant. Il pourra ensuite créer une tâche, envoyer le fichier, lancer le traitement, suivre sa progression et obtenir un lien de téléchargement. Conservez l’UUID de la tâche pour pouvoir la reprendre plus tard.

Le fichier complet est proposé par défaut. Si un montant impayé bloque le téléchargement, rechargez votre solde puis demandez un nouveau lien pour la même tâche. Un fichier incomplet n’est fourni que sur demande explicite, si une telle version est disponible.

Pour intégrer le service directement à votre application, consultez la référence de l’API REST.