TemplateFox

officiel

Gé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

  1. Node.js 18+ installé sur votre machine (pour npx)
  2. 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’environnementObligatoireDescription
TEMPLATEFOX_API_KEYOuiVotre clé API (commence par sk_). Obtenez-en une depuis votre Dashboard
TEMPLATEFOX_BASE_URLNonRemplace 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 npx fonctionne : exécutez npx -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_KEY est 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