TemplateFox

Serveur MCP

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 les crédits — le tout en langage naturel.

• npm : @templatefox/mcp-server
• GitHub : TemplateFoxPDF/mcp-server

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

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 au lieu 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 retournera 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	Surcharger 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érer 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ère une facture pour John Doe, total 250 $, en utilisant mon modèle Facture »

« Crée un certificat de réussite pour Jane Smith, cours : React avancé »

generate_pdf_async

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

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

list_templates

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

« Quels modèles ai-je ? »

« Montre-moi tous mes modèles PDF »

get_template_fields

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

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

get_pdf_job_status

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

« Mon travail PDF est-il déjà terminé ? »

list_pdf_jobs

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

« Montre-moi mes travaux PDF récents »

get_account_info

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

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

list_transactions

Voir l'historique des transactions de crédits.

« Montre-moi ma consommation 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 un seul flux :

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

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

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

« Liste mes modèles, puis montre-moi les champs du modèle Reçu »

Vérifier le statut du compte

Surveillez votre consommation sans quitter votre assistant IA :

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

Serveur distant (bientôt)

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

Dépannage

Erreurs « Serveur MCP introuvable » ou 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

Erreurs « Clé API invalide » ou 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 n'apparaissent 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

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