TemplateFox

Serveur MCP

Copier la page

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 met à disposition de 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_votre_clé_api_ici" } } } }

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 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 :

« 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ère 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 Jean Dupont, total 250 €, en utilisant mon modèle Facture »

« Crée un certificat de réussite pour Marie Martin, cours : React Avancé »

generate_pdf_async

Met 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écouvre tous les modèles PDF disponibles dans votre compte.

« Quels modèles ai-je ? »

« Montre-moi tous mes modèles PDF »

get_template_fields

Obtient 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érifie le statut d'un travail de génération PDF asynchrone.

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

list_pdf_jobs

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

« Montre-moi mes travaux PDF récents »

get_account_info

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

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

list_transactions

Affiche 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 #1234, client Jean Dupont, 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

« 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 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

Dernière mise à jour le 12 juillet 2026

Normes PDFTéléverser vers S3