An AI agent should choose which file to convert and which format to convert it to, and a conversion engine should do the converting. With the GroupDocs.Conversion.Mcp server, Claude, Cursor or GitHub Copilot call that engine locally, on your machine, from one sentence:

Convert contract.docx to PDF

The step‑by‑step version with config and troubleshooting is in the documentation: How to convert documents with AI agents using MCP. This post explains why the split matters and where the agent should stay out of the way.

Qu’est‑ce qui ne va pas lorsqu’un agent convertit un fichier lui‑même ?

Un modèle de langage qui « convertit » un PDF en Word ne convertit rien. Il lit le contenu qui lui est fourni et écrit du nouveau contenu dans le format cible. Tout ce que le modèle n’a pas vu, il ne peut pas reproduire : la police exacte, la géométrie des colonnes, le saut de page avant un tableau, les noms de styles dont dépend un modèle Word. Ce qui revient ressemble à une conversion mais est en réalité une re‑saisie.

C’est le mode d’échec dont parle cet article. Il est discret : le résultat s’ouvre sans erreur, donc personne ne le vérifie jusqu’à ce qu’une table se soit déplacée ou qu’un titre ait perdu son style. La fidélité du rendu est le travail déterministe du moteur, pas celui de la génération.

Que doit décider l’agent, et que doit faire le moteur ?

Séparez la tâche le long de la frontière entre jugement et exécution.

Question L’agent décide Le moteur fait
Quels fichiers sont concernés ? Lit votre invite et le dossier de stockage Aucun
Quel format cible ? Mappe « rendre éditable » à DOCX, « archiver » à PDF Aucun
Le fichier est‑il même convertible ? Appelle get_supported_formats et lit la réponse Signale les formats cibles valides
Quelle est la taille du fichier ? Appelle get_document_info et lit le nombre de pages Lit le type, le nombre de pages, les propriétés
La conversion elle‑même Appelle convert Rend le résultat avec le moteur GroupDocs.Conversion
Que faire en cas d’échec Réessaie, vous interroge, ou saute le fichier Retourne la raison sous forme de texte

L’agent ne touche jamais aux octets de votre document. Il transmet un nom de fichier et un format, et le moteur renvoie un fichier.

Comment connecter un agent au moteur localement ?

Enregistrez le serveur une fois dans votre client. Claude Desktop utilise claude_desktop_config.json, Claude Code utilise claude mcp add, VS Code avec GitHub Copilot utilise mcp.json, et Cursor utilise ~/.cursor/mcp.json. Le serveur prend également en charge Visual Studio 2022, Windsurf, Cline, Codex CLI et JetBrains Rider. Une entrée Claude Desktop ressemble à ceci :

{
  "mcpServers": {
    "groupdocs-conversion": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Conversion.Mcp", "--yes"],
      "env": { "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents" }
    }
  }
}

dnx nécessite le SDK .NET 10. Si vous préférez Docker, l’image autonome est ghcr.io/groupdocs-conversion/conversion-net-mcp:latest, à lancer avec docker run --rm -i -v $(pwd)/documents:/data devant. Le client communique avec le serveur via stdio : le chemin est agent → serveur local → système de fichiers local. Redémarrez le client après l’enregistrement.

Quel outil chaque requête déclenche‑t‑elle ?

Le serveur expose quatre outils. Leurs noms sont littéraux ; les agents les recherchent lorsqu’un problème survient.

  • convert convertit un document vers un autre format et enregistre le résultat dans votre stockage ou dossier de sortie. Il prend file, format (par ex. pdf, docx, xlsx, pptx, html, png, jpg, csv, txt, rtf, md) et un password optionnel.
  • get_supported_formats répertorie les formats cibles qu’un fichier source donné peut devenir.
  • get_document_info renvoie le type de fichier, le nombre de pages et les propriétés de base sans conversion.
  • get_license_status indique si le serveur fonctionne en mode évaluation, avec fichier de licence ou en mode métrique.

Les invites ouvertes fonctionnent parce que l’agent les enchaîne :

Quels formats puis‑je transformer ce fichier Visio ? Puis le convertir en PDF.

Vérifier d’abord le nombre de pages de whitepaper.pdf, puis le convertir en DOCX.

Les fichiers existants ne sont jamais écrasés. Une seconde conversion du même fichier reçoit un nom distinct, par exemple report (1).pdf.

Session d’exemple

Voici une session abrégée, illustrative, construite à partir des descriptions d’outils de la documentation, et non une capture d’écran.

You:    Convert contract-draft.pdf to DOCX so I can edit it.
Agent:  [calls convert with file.filePath = "contract-draft.pdf", format = "docx"]
Agent:  Done. The converted file is saved as contract-draft.docx in your output folder.

Pour le flux complet, le guide n8n montre le même moteur piloté par un workflow au lieu d’un chat, et l’annonce couvre le serveur en général.

Quelles sont les limites ?

  • Mode évaluation. Sans licence, le serveur ajoute un filigrane d’évaluation au résultat converti et limite chaque processus serveur à 15 documents ouverts ; redémarrer le serveur réinitialise le compteur. Demandez d’abord à votre agent « quel est le statut de licence du serveur de conversion ? », get_license_status répond sans traiter de document.
  • Pas d’OCR. Le serveur convertit les documents qui possèdent une couche texte. Un scan enregistré comme PDF uniquement image ne sera pas rendu éditable.
  • Conversion, pas extraction. Ce serveur transforme des documents entiers. Pour l’extraction de données au niveau des champs, le serveur compagnon GroupDocs.Parser.Mcp (disponible uniquement sous forme d’image Docker) est plus adapté, et de nombreux pipelines utilisent les deux.

FAQ

Claude peut‑il convertir un docx en pdf ?
Oui, avec un serveur de conversion attaché. Claude appelle convert avec format: "pdf", et le moteur GroupDocs produit le fichier sur votre machine.

Mes fichiers sont‑ils téléchargés lorsqu’un agent les convertit ?
Pas avec ce serveur. Il fonctionne localement via stdio, et les documents restent dans votre dossier de stockage. Votre fichier de licence est également lu depuis le disque local.

Quels formats le serveur peut‑il convertir ?
Plus de 100 formats de documents, feuilles de calcul, présentations, images, e‑mail, CAD et web, le même ensemble que la bibliothèque .NET GroupDocs.Conversion. Interrogez get_supported_formats pour obtenir la liste exacte pour un fichier donné.

Approfondir