TemplateFox
officielGénérez des documents PDF avec TemplateFox
Que pouvez-vous faire avec TemplateFox MCP ?
- Générer des PDF à partir de modèles — Demandez à votre assistant de créer un PDF à partir d’un modèle avec des données dynamiques, comme une facture ou un certificat.
- Mettre en file d’attente des tâches PDF asynchrones — Demandez la génération en arrière-plan de tâches volumineuses ou par lots, avec un rappel webhook facultatif une fois la tâche terminée.
- Examiner les modèles et les champs — Listez les modèles disponibles et consultez les champs attendus par un modèle spécifique avant de générer un PDF.
- Suivre les tâches PDF — Vérifiez l’état d’une tâche asynchrone ou consultez la liste des tâches PDF récentes et leur état.
- Vérifier les crédits et les transactions — Renseignez-vous sur les crédits restants, les informations du compte ou l’historique des transactions de crédits.
Documentation
MCP (Model Context Protocol) est un standard ouvert qui permet aux assistants IA de découvrir et d’utiliser des outils externes. Le serveur MCP TemplateFox fournit à votre assistant IA 8 outils pour générer des PDF, gérer des modèles et vérifier vos crédits, le tout en langage naturel.
Prérequis
- Node.js 18+ installé sur votre machine (pour
npx) - Une clé API TemplateFox — obtenez-en une depuis votre Dashboard (commence par
sk_)
Installation
Claude Desktop
Ajoutez cette configuration à votre fichier de configuration Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json sur macOS, %APPDATA%\Claude\claude_desktop_config.json sur Windows) :
{
"mcpServers": {
"templatefox": {
"command": "npx",
"args": ["-y", "@templatefox/mcp-server"],
"env": {
"TEMPLATEFOX_API_KEY": "sk_your_api_key_here"
}
}
}
}
Redémarrez Claude Desktop après avoir enregistré le fichier.
Claude Code
claude mcp add templatefox -- npx -y @templatefox/mcp-server
Définissez ensuite la variable d’environnement TEMPLATEFOX_API_KEY dans votre shell :
export TEMPLATEFOX_API_KEY="sk_your_api_key_here"
Cursor / Windsurf
Utilisez la même commande npx dans la configuration de votre serveur MCP :
npx -y @templatefox/mcp-server
Définissez TEMPLATEFOX_API_KEY dans les variables d’environnement.
Installation globale (alternative)
npm install -g @templatefox/mcp-server
Utilisez ensuite templatefox-mcp-server comme commande à la place de npx.
Vérifier la configuration
Après l’installation, demandez à votre assistant IA :
« Liste mes modèles TemplateFox »
Si le serveur MCP est correctement configuré, l’assistant appellera list_templates et renverra la liste de vos modèles. En cas d’erreur, consultez la section Dépannage ci-dessous.
Configuration
| Variable d’environnement | Obligatoire | Description |
|---|---|---|
TEMPLATEFOX_API_KEY | Oui | Votre clé API (commence par sk_). Obtenez-en une depuis votre Dashboard |
TEMPLATEFOX_BASE_URL | Non | Remplace l’URL de base de l’API (par défaut : https://api.templatefox.com) |
Outils disponibles
Le serveur MCP expose 8 outils que votre assistant IA peut appeler :
generate_pdf
Génère un PDF à partir d’un modèle et de données dynamiques. Coûte 1 crédit par PDF.
Exemples de demandes :
« Génère une facture pour John Doe, d’un montant total de 250 $, avec mon modèle Invoice »
« Crée un certificat de réussite pour Jane Smith, cours : Advanced React »
generate_pdf_async
Met en file d’attente la génération asynchrone de PDF, avec un rappel webhook facultatif. Utile pour les tâches volumineuses ou par lots. Coûte 1 crédit par PDF.
Exemple de demande :
« Génère 10 certificats en arrière-plan et préviens-moi quand ce sera terminé »
list_templates
Découvre tous les modèles PDF disponibles dans votre compte.
Exemples de demandes :
« Quels modèles ai-je ? »
« Affiche tous mes modèles PDF »
get_template_fields
Récupère les champs et les variables d’un modèle spécifique. Utile pour savoir quelles données un modèle attend avant de générer un document.
Exemple de demande :
« De quels champs mon modèle Invoice a-t-il besoin ? »
get_pdf_job_status
Vérifie l’état d’une tâche de génération asynchrone de PDF.
Exemple de demande :
« Ma tâche PDF est-elle terminée ? »
list_pdf_jobs
Liste toutes les tâches de génération asynchrone de PDF et leur état.
Exemple de demande :
« Affiche mes tâches PDF récentes »
get_account_info
Vérifie le solde de crédits et les informations du compte.
Exemple de demande :
« Combien de crédits me reste-t-il ? »
list_transactions
Consulte l’historique des transactions de crédits.
Exemple de demande :
« Affiche mon utilisation de crédits ce mois-ci »
Cas d’utilisation
Générer un document
Demandez à votre assistant IA de générer un PDF avec des données précises. L’assistant découvre le modèle, vérifie les champs requis et génère le PDF en une seule étape :
« Génère un bordereau d’expédition pour la commande n° 1234, client John Doe, 3x Widget Blue et 1x Gadget Pro »
Explorer les modèles avant de générer un document
Commencez par vous renseigner sur vos modèles, puis générez un document une fois que vous savez lesquels sont disponibles :
« Liste mes modèles, puis affiche les champs du modèle Receipt »
Vérifier l’état du compte
Suivez votre utilisation sans quitter votre assistant IA :
« Combien de crédits me reste-t-il ? Affiche mes transactions récentes »
Serveur distant (bientôt disponible)
Un point de terminaison MCP HTTP hébergé à l’adresse https://api.templatefox.com/mcp sera bientôt disponible. Vous pourrez ainsi vous connecter sans rien installer localement : il suffira d’indiquer l’URL à votre client MCP.
Dépannage
« Serveur MCP introuvable » ou erreurs de connexion
- Vérifiez que Node.js 18+ est installé : exécutez
node --version - Vérifiez que la commande
npxfonctionne : exécuteznpx -y @templatefox/mcp-server --help - Redémarrez votre assistant IA après avoir modifié la configuration
« Clé API invalide » ou erreurs d’authentification
- Vérifiez que votre clé API commence par
sk_et qu’elle n’a pas expiré - Vérifiez la clé dans votre Dashboard
- Assurez-vous que
TEMPLATEFOX_API_KEYest défini dans le bon environnement (pas seulement dans votre shell, mais aussi dans la configuration du serveur MCP)
Les outils ne s’affichent pas
- Certains clients mettent en cache les listes d’outils MCP : redémarrez le client
- Vérifiez si d’autres serveurs MCP fonctionnent afin d’écarter un problème lié au client
Étapes suivantes
- Bien démarrer en 5 minutes — Créez votre premier modèle
- Liaison des données — Découvrez comment transmettre des données dynamiques
- Référence de l’API — Documentation complète des points de terminaison