TemplateFox

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 offre à votre assistant IA 8 outils pour générer des PDF, gérer des modèles et vérifier les crédits — le tout en langage naturel.

Prérequis

1. Node.js 18+ installé sur votre machine (pour npx)
2. Une clé API TemplateFox — obtenez-en une depuis votre Tableau de bord (commence par sk_)

Installation

Claude Desktop

Ajoutez à votre 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

Ensuite, définissez 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 votre configuration de 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 au lieu de npx.

Vérifier la configuration

Après l'installation, demandez à votre assistant IA :

« Listez mes modèles TemplateFox »

Si le serveur MCP est correctement configuré, l'assistant appellera list_templates et renverra votre liste de modèles. Si vous voyez une erreur, consultez la section Dépannage ci-dessous.

Configuration

Variable d'environnement	Requise	Description
TEMPLATEFOX_API_KEY	Oui	Votre clé API (commence par sk_). Obtenez-en une depuis votre Tableau de bord
TEMPLATEFOX_BASE_URL	Non	Remplacer l'URL de base de l'API (défaut : https://api.templatefox.com)

Outils disponibles

Le serveur MCP expose 8 outils que votre assistant IA peut appeler :

generate_pdf

Générez un PDF à partir d'un modèle avec des données dynamiques. Coûte 1 crédit par PDF.

Ce que vous pouvez demander :

« Générez une facture pour John Doe, total 250 $, en utilisant mon modèle Facture »

« Créez un certificat de fin de formation pour Jane Smith, cours : React avancé »

generate_pdf_async

Mettez en file d'attente la génération asynchrone de PDF avec un rappel webhook optionnel. Utile pour les travaux volumineux ou par lots. Coûte 1 crédit par PDF.

Ce que vous pouvez demander :

« Générez 10 certificats en arrière-plan et prévenez-moi quand c'est terminé »

list_templates

Découvrez tous les modèles PDF disponibles dans votre compte.

Ce que vous pouvez demander :

« Quels modèles ai-je ? »

« Montrez-moi tous mes modèles PDF »

get_template_fields

Obtenez les champs et variables pour un modèle spécifique. Utile pour comprendre quelles données un modèle attend avant de générer.

Ce que vous pouvez demander :

« De quels champs mon modèle Facture a-t-il besoin ? »

get_pdf_job_status

Vérifiez le statut d'un travail de génération de PDF asynchrone.

Ce que vous pouvez demander :

« Mon travail PDF est-il terminé ? »

list_pdf_jobs

Listez tous les travaux de génération de PDF asynchrones et leurs statuts.

Ce que vous pouvez demander :

« Montrez-moi mes travaux PDF récents »

get_account_info

Vérifiez les crédits restants et les informations du compte.

Ce que vous pouvez demander :

« Combien de crédits me reste-t-il ? »

list_transactions

Consultez l'historique des transactions de crédit.

Ce que vous pouvez demander :

« Montrez-moi mon utilisation de crédits ce mois-ci »

Cas d'utilisation

Générer un document unique

Demandez à votre assistant IA de générer un PDF avec des données spécifiques. L'assistant découvre le modèle, vérifie les champs requis et génère le PDF en une seule opération :

« Générez un bon de livraison pour la commande #1234, client John Doe, 3x Widget Bleu et 1x Gadget Pro »

Explorer les modèles avant de générer

Interrogez d'abord vos modèles, puis générez une fois que vous savez ce qui est disponible :

« Listez mes modèles, puis montrez-moi les champs pour le modèle Reçu »

Vérifier l'état du compte

Surveillez votre utilisation sans quitter votre assistant IA :

« Combien de crédits me reste-t-il ? Montrez-moi mes transactions récentes »

Serveur distant (bientôt)

Un point de terminaison HTTP MCP hébergé à https://api.templatefox.com/mcp arrive bientôt. Cela vous permettra de vous connecter sans rien installer localement — pointez simplement votre client MCP vers l'URL.

Dépannage

« Serveur MCP introuvable » ou erreurs de connexion

• Assurez-vous que Node.js 18+ est installé : exécutez node --version
• Vérifiez que la commande npx fonctionne : exécutez npx -y @templatefox/mcp-server --help
• Redémarrez votre assistant IA après avoir mis à jour la configuration

« Clé API invalide » ou erreurs d'authentification

• Vérifiez que votre clé API commence par sk_ et n'est pas expirée
• Vérifiez la clé dans votre Tableau de bord
• Assurez-vous que TEMPLATEFOX_API_KEY est défini dans le bon environnement (pas seulement votre shell, mais 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 pour exclure un problème au niveau du client

Prochaines étapes

• Commencez en 5 minutes — Créez votre premier modèle
• Liaison de données — Apprenez à passer des données dynamiques
• Référence API — Documentation complète des points de terminaison