# Serveur MCP : PDFMonkey dans Claude et Cursor


Le [serveur MCP de PDFMonkey](https://github.com/pdfmonkey/pdfmonkey-mcp) relie votre compte PDFMonkey aux assistants IA compatibles avec le [Model Context Protocol](https://modelcontextprotocol.io) (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](https://www.npmjs.com/package/pdfmonkey-mcp-server)
- GitHub : [pdfmonkey/pdfmonkey-mcp](https://github.com/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.

> [!TIP]
> **Vous créez des modèles avec un agent ?**
>
> Le serveur MCP travaille avec des modèles existants : il peut les lire, mais pas les créer ni les modifier. Pour qu’un agent comme Claude Code construise et prévisualise des modèles, utilisez la [CLI](/fr/docs/integrations/cli/) avec le [skill pour agents IA](/fr/docs/integrations/agent-skill/).


## 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](https://dashboard.pdfmonkey.io/account).

### Claude Code

```bash
$ 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.

```json
{
  "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_document` attend jusqu’à 3 minutes. Si votre document prend plus de temps, demandez à l’assistant de le vérifier plus tard avec `get_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.


## FAQ

**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.
