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 donne à votre assistant des outils pour générer des PDF et des images, consulter vos templates, faire créer des templates image par l’agent de création et suivre vos 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, à créer dans votre tableau de bord (elle commence par sk_)

Installation

Claude Desktop

Ajoutez ce bloc à la configuration de 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

Renseignez TEMPLATEFOX_API_KEY dans les variables d’environnement.

Installation globale (variante)

npm install -g @templatefox/mcp-server

Utilisez ensuite templatefox-mcp-server comme commande à la place de npx.

Vérifier l’installation

Une fois l’installation faite, demandez à votre assistant IA :

« Liste mes templates TemplateFox »

Si le serveur MCP est bien configuré, l’assistant appelle list_templates et affiche la liste de vos templates. En cas d’erreur, consultez la section Dépannage plus bas.

Configuration

Variable d’environnement	Obligatoire	Description
TEMPLATEFOX_API_KEY	Oui	Votre clé API (elle commence par sk_), à créer dans votre tableau de bord
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 ces outils à votre assistant IA.

generate_pdf

Génère un PDF à partir d’un template et de données dynamiques. Coûte 1 crédit par PDF.

Exemples de demandes :

« Génère une facture pour John Doe, total 250 $, avec mon template Facture »

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

generate_pdf_async

Met en file une génération de PDF asynchrone, avec un webhook facultatif. Utile pour les gros documents ou les 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 c’est fini »

list_templates

Liste tous les templates de votre compte.

Exemples de demandes :

« Quels templates est-ce que j’ai ? »

« Montre-moi tous mes templates PDF »

get_template_fields

Renvoie les champs et variables d’un template. Utile pour savoir quelles données il attend avant de générer.

Exemple de demande :

« De quels champs mon template Facture a-t-il besoin ? »

get_pdf_job_status

Renvoie l’état d’une tâche de génération de PDF asynchrone.

Exemple de demande :

« Est-ce que ma tâche PDF est terminée ? »

list_pdf_jobs

Liste les tâches de génération de PDF asynchrones et leur état.

Exemple de demande :

« Montre-moi mes dernières tâches PDF »

get_account_info

Renvoie vos crédits restants et les informations de votre compte.

Exemple de demande :

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

list_transactions

Affiche l’historique de vos transactions de crédits.

Exemple de demande :

« Montre-moi ma consommation de crédits ce mois-ci »

generate_image

Génère une image (PNG, JPEG ou WebP) à partir d’un template image. Le contenu passe par des modifications qui ciblent les calques nommés du template. Renvoie l’URL de l’image (la sortie binaire n’est pas disponible par MCP). Coûte 1 crédit par image.

Exemple de demande :

« Génère l’image de mon template Social Card avec le titre “Soldes d’été” »

get_template_layers

Liste les calques nommés d’un template image : nom, type (fond, image, texte ou forme), texte actuel, et les champs que chaque calque accepte dans generate_image.

Exemple de demande :

« Quels calques puis-je modifier dans mon template Social Card ? »

author_template

Demande à l’agent de création TemplateFox de concevoir un nouveau template image à partir d’une description en langage naturel (avec, si vous le souhaitez, vos couleurs, vos polices et les URL de vos visuels). Asynchrone : l’outil renvoie un job_id à suivre avec get_agent_job_status. Coûte 25 crédits, remboursés si la tâche échoue.

Exemple de demande :

« Crée un template de slide Instagram en 1080×1350, avec un titre, un paragraphe et un numéro de slide »

revise_template

Envoie vos retours, en langage naturel, à l’agent de création pour retoucher un template image existant (les noms de calques ne changent pas). Asynchrone : suivez la tâche avec get_agent_job_status. Coûte 10 crédits, remboursés si la tâche échoue.

Exemple de demande :

« Agrandis le titre et passe le fond en bleu nuit »

get_agent_job_status

Renvoie l’état d’une tâche de l’agent de création (author_template ou revise_template). Une fois la tâche terminée, l’outil renvoie le template_id et une preview_url du rendu. Une tâche en échec contient l’erreur et ses crédits sont remboursés automatiquement.

Cas d’usage

Générer un document

Demandez à votre assistant IA un PDF avec des données précises. L’assistant trouve le template, vérifie les champs attendus et génère le PDF dans la foulée :

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

Explorer vos templates avant de générer

Interrogez d’abord votre assistant sur vos templates, puis générez une fois que vous savez ce qui est disponible :

« Liste mes templates, puis montre-moi les champs du template Reçu »

Suivre votre compte

Gardez un œil sur votre consommation sans quitter votre assistant IA :

« Combien de crédits me reste-t-il ? Montre-moi mes dernières transactions »

Dépannage

« MCP server not found » ou erreurs de connexion

• Vérifiez que Node.js 18+ est installé : lancez node --version
• Vérifiez que la commande npx -y @templatefox/mcp-server démarre sans erreur : le serveur attend ensuite les messages de votre client (quittez avec Ctrl+C)
• Redémarrez votre assistant IA après avoir modifié la configuration

« Invalid API key » ou erreurs d’authentification

• Vérifiez que votre clé API commence par sk_ et qu’elle est toujours active
• Contrôlez la clé dans votre tableau de bord
• Vérifiez que TEMPLATEFOX_API_KEY est définie au bon endroit : dans la configuration du serveur MCP, pas seulement dans votre shell

Les outils n’apparaissent pas

• Certains clients gardent en cache la liste des outils MCP : redémarrez le client
• Vérifiez que vos autres serveurs MCP fonctionnent, pour écarter un problème côté client

Pour aller plus loin

• Démarrer en 5 minutes — créez votre premier template
• Liaison de données — envoyez des données dynamiques à vos templates
• Référence API — la documentation complète des endpoints