Serveur MCP : utiliser PDFMonkey depuis Claude, Cursor et d’autres assistants IA
Dernière mise à jour le 26 octobre 2026
Le serveur MCP de PDFMonkey relie votre compte PDFMonkey aux assistants IA compatibles avec le Model Context Protocol (MCP), comme Claude Code, Claude Desktop ou Cursor. Une fois configuré, vous pouvez demander à votre assistant de lister vos modèles, de générer un document à partir de l’un d’eux ou de vérifier combien de documents il vous reste ce mois-ci.
- npm : pdfmonkey-mcp-server
- GitHub : pdfmonkey/pdfmonkey-mcp
- MCP Registry :
io.github.pdfmonkey/pdfmonkey-mcp
Le serveur tourne sur votre machine et communique avec l’API PDFMonkey grâce à votre clé d’API. Rien n’est hébergé entre les deux.
Vous créez des modèles avec un agent ?
Installation #
Le serveur nécessite Node.js 18 ou plus récent. Il lit votre clé d’API dans la variable d’environnement PDFMONKEY_API_KEY. Vous trouverez votre clé sur la page de votre compte.
Claude Code #
$ claude mcp add pdfmonkey -e PDFMONKEY_API_KEY=votre-cle-api -- npx -y pdfmonkey-mcp-server
Claude Desktop, Cursor et autres clients #
Ajoutez le serveur à la configuration MCP de votre client : claude_desktop_config.json pour Claude Desktop, .cursor/mcp.json pour Cursor.
{
"mcpServers": {
"pdfmonkey": {
"command": "npx",
"args": ["-y", "pdfmonkey-mcp-server"],
"env": {
"PDFMONKEY_API_KEY": "votre-cle-api"
}
}
}
}
Redémarrez le client : les outils PDFMonkey apparaissent dans sa liste d’outils.
Outils disponibles #
| Outil | Ce qu’il fait |
|---|---|
list_workspaces | Liste les workspaces accessibles avec votre clé d’API |
list_templates | Liste les modèles d’un workspace |
get_template | Récupère le HTML, le CSS et les données d’exemple d’un modèle |
generate_document | Génère un document et attend qu’il soit prêt (vérification toutes les 1,5 s, jusqu’à 3 minutes) |
get_document_status | Vérifie le statut d’un document et récupère son URL de téléchargement |
list_documents | Liste les documents, filtrés par statut, modèle ou date de mise à jour |
delete_document | Supprime définitivement un document |
list_snippets | Liste les snippets Liquid d’un workspace |
get_snippet | Récupère le code d’un snippet |
get_quota | Affiche votre quota et votre plan |
get_user_info | Affiche les informations de votre compte |
Ce que vous pouvez demander #
- « Quels modèles ai-je dans mon workspace principal ? »
- « Génère une facture pour ACME avec mon modèle de facture, pour 3 heures de conseil à 90 €. »
- « Montre-moi les documents qui ont échoué cette semaine. »
- « Combien de documents me reste-t-il ce mois-ci ? »
Quand vous demandez un document, l’assistant consulte en général d’abord le modèle pour voir quelles données il attend, puis appelle generate_document avec les bonnes données.
Bon à savoir #
- Les URL de téléchargement expirent au bout d’une heure. Téléchargez le fichier tout de suite, ou utilisez un lien de partage avec les plans Pro+ et Premium.
- Générations longues :
generate_documentattend jusqu’à 3 minutes. Si votre document prend plus de temps, demandez à l’assistant de le vérifier plus tard avecget_document_status. - La suppression est définitive. La plupart des clients demandent une confirmation avant d’exécuter
delete_document. - Votre clé d’API donne un accès complet à votre compte. Ne la laissez pas dans des fichiers de configuration partagés.
Questions fréquentes
- PDFMonkey a-t-il un serveur MCP ?
- Oui. Le serveur MCP officiel de PDFMonkey est publié sur npm sous le nom pdfmonkey-mcp-server et référencé dans le MCP Registry sous io.github.pdfmonkey/pdfmonkey-mcp. Il tourne en local via stdio et utilise votre clé d’API PDFMonkey.
- Quels assistants IA fonctionnent avec le serveur MCP de PDFMonkey ?
- Tous les clients MCP qui acceptent les serveurs locaux en stdio, dont Claude Code, Claude Desktop et Cursor.
- Le serveur MCP de PDFMonkey peut-il créer ou modifier des modèles ?
- Non. Il peut lire les modèles et les snippets, générer et gérer des documents, et consulter votre quota. Pour qu’un agent IA crée, modifie et prévisualise des modèles, utilisez la CLI PDFMonkey.