Aller au contenu
Retour au blog
tutoriels
16 juin 2026
GuruPDF Team
6 min de lecture

Convertissez vos fichiers dans Claude et Cursor avec le MCP GuruPDF

GuruPDF est un serveur MCP de conversion de fichiers : convertissez du PDF en Word, des images en PDF, et fusionnez, compressez ou faites de l'OCR — directement dans Claude, Cursor ou n'importe quel client MCP.

Convertissez vos fichiers dans Claude et Cursor avec le MCP GuruPDF

Votre agent de code sait échafauder une appli, démêler une stack trace et discuter avec vous des tabulations contre les espaces. Mais donnez-lui un PDF en lui demandant un document Word modifiable, et là, il cale. Les fichiers sont sur votre disque ; le modèle vit dans le chat. Rien ne relie les deux.

C'est précisément pour combler ce vide qu'on a créé le MCP GuruPDF — un petit serveur MCP qui donne à Claude, Cursor et à tout autre client MCP un vrai moyen de convertir des fichiers. Mettez un chemin dans votre prompt, dites ce que vous voulez, et le fichier converti atterrit sur votre disque l'instant d'après. Pas d'écran d'upload, pas de « télécharge-le, puis ré-upload-le ailleurs ». Juste « convertis ~/contracts/lease.pdf en Word ».

Ce qu'est vraiment un MCP de conversion de fichiers

Le MCP — le Model Context Protocol — c'est la prise qui permet à un agent IA d'utiliser des outils en dehors de sa propre tête. Un serveur expose quelques actions ; l'agent les appelle quand votre prompt en a besoin. Il existe des serveurs MCP pour les bases de données, les navigateurs, GitHub.

Il n'y en avait pas de bon pour les fichiers. Alors un PDF MCP — en réalité un MCP de conversion de fichiers, puisqu'il va bien au-delà du PDF — n'est qu'un serveur qui prend un fichier dans un format et vous en rend un autre. Du PDF vers Word. Un dossier d'images en un seul PDF. Une page scannée en texte interrogeable. L'agent se charge de demander ; GuruPDF se charge de convertir.

Sous le capot, c'est le même moteur que celui derrière gurupdf.com : 126 outils, plus de 100 formats, désormais accessibles depuis votre éditeur.

Mettez-le en place en deux minutes environ

Il vous faut deux choses : Node (pour npx) et une clé API GuruPDF gratuite. Récupérez une clé sur gurupdf.com/profile — les comptes gratuits viennent avec des crédits quotidiens, vous pouvez donc commencer à convertir tout de suite.

Le serveur s'installe et se lance tout seul via npx ; il n'y a rien à cloner :

bash
npx gurupdf-mcp

Vous ne lancerez pas ça à la main, cela dit — vous y pointez votre client MCP. Pour Cursor, Claude Desktop, VS Code ou Windsurf, déposez ceci dans votre config MCP :

json
{
  "mcpServers": {
    "gurupdf": {
      "command": "npx",
      "args": ["-y", "gurupdf-mcp"],
      "env": { "GURUPDF_API_KEY": "your-token-here" }
    }
  }
}

Redémarrez le client et votre agent gagne discrètement quatre outils : convertir un fichier, vérifier une tâche, lister ce qui est pris en charge, et consulter votre solde de crédits. C'est toute l'installation.

Ce que vous pouvez vraiment en faire

C'est là que ça devient amusant. Une fois branché, voici de vrais prompts qui fonctionnent tout simplement :

  • « Convertis ~/Downloads/invoice.pdf en Word pour que je puisse modifier les totaux. » — un .docx modifiable apparaît à côté de l'original.
  • « Transforme chaque capture d'écran de ~/shots en un seul PDF. » — les images fusionnées, dans l'ordre, en un unique fichier.
  • « Ce scan n'est qu'une image. Fais-en l'OCR et donne-moi le texte. » — du vrai texte extrait des pixels.
  • « Compresse report.pdf, il fait 40 Mo et je dois l'envoyer par e-mail. » — un fichier plus léger, toujours lisible.
  • « Fais un PDF de https://example.com/pricing. » — la page en direct, rendue en PDF.

Vous ne mémorisez jamais de noms d'outils ni de formats. Exprimez l'objectif en langage clair et le serveur choisit lequel des 126 outils convient, le lance, et écrit le résultat sur le disque. Fusionner, scinder, pivoter, protéger par mot de passe, filigraner, Excel ↔ PDF, HEIC → JPG — tout y est.

Il vous répond quand quelque chose cloche

La plupart des convertisseurs échouent avec un code obscur ; celui-ci est conçu pour s'expliquer à travers votre agent — parce que l'agent est justement ce qui lit la réponse.

Épuisez le niveau gratuit et vous n'obtiendrez pas un simple 402. Vous obtenez une phrase que votre assistant vous relaie : vous avez atteint la limite gratuite (2 conversions par minute, 10 par jour), elle se réinitialise demain, et voici un lien si vous préférez ne pas attendre. Passez à un outil le mauvais format, ou un fichier trop volumineux, et il vous le dit exactement — avec des mots, pas un numéro d'erreur. Vous n'avez jamais à quitter la conversation pour comprendre ce qui s'est passé.

Cette idée d'« expliquer à travers l'agent » est aussi la raison pour laquelle on soigne tant la formulation. Un message d'erreur qu'aucun humain ne lit doit quand même avoir du sens pour le modèle qui le relaie.

Ce qu'il y a sous le capot

  • 126 outils, plus de 100 formats. PDF, Word, Excel, PowerPoint, images, livres numériques, et même la vidéo — le même moteur que le site.
  • Un vrai niveau gratuit. Chaque compte reçoit des crédits quotidiens. Des forfaits payants et des packs de crédits existent pour un usage plus intensif, et votre agent vous y oriente quand ça a vraiment du sens, pas avant.
  • Les fichiers ne traînent pas. Tout transite en HTTPS et est supprimé en moins d'une heure. Le MCP écrit le résultat sur votre disque ; la copie de notre côté disparaît peu après.
  • Open source. Le serveur est sous licence MIT, publié sur npm et listé dans le registre officiel MCP, vous pouvez donc lire chaque ligne avant de le lancer.

Procurez-vous-le

Si vous passez vos journées dans Claude ou Cursor et que vous bondissez sans cesse vers un site de conversion, ceci supprime l'aller-retour.

Ajoutez-le une fois et oubliez qu'il est là — jusqu'à la prochaine fois où vous auriez ouvert un onglet de navigateur pour convertir un fichier, et où votre agent le fait à votre place.