Connecter FRED à Claude Code, Codex et Cursor via MCP
Connectez FRED à Claude Code, Codex ou Cursor avec une configuration à copier-coller, puis utilisez la documentation et votre compte depuis votre assistant.
Publié par FRED · Mis à jour le
Le MCP FRED est disponible. Il connecte votre assistant à la documentation et à votre compte client. Demandez-lui d’intégrer l’API à votre projet, de retrouver vos produits ou de préparer un devis, sans quitter Claude Code, Codex ou Cursor.
Le service FRED reste en bêta privée ; si vous n’avez pas encore de compte, demandez votre accès.
Avant de commencer : disposez d’un compte client FRED et de Claude Code, de Codex CLI ou de Cursor installé sur votre ordinateur. La connexion à FRED se fait dans votre navigateur, sans clé API à copier.
Connecter FRED
Choisissez votre assistant. Les commandes et la configuration sont complètes : aucun champ à remplacer.
1. Ajoutez FRED depuis votre terminal.
claude mcp add --transport http --scope user fred https://docs.fredpod.com/api/mcpFRED sera disponible dans tous vos projets pour votre utilisateur.
2. Ouvrez Claude Code.
claudeDans la conversation Claude Code, saisissez cette commande, sélectionnez fred
et lancez la connexion :
/mcp3. Autorisez l’accès dans FRED. Connectez-vous dans la page du navigateur,
vérifiez les permissions, puis cliquez sur Revenir à mon assistant.
Le menu /mcp permet de vérifier que fred est connecté.
1. Ajoutez FRED depuis votre terminal.
codex mcp add fred --url https://docs.fredpod.com/api/mcp2. Connectez votre compte FRED. Si l’ajout n’a pas déjà lancé la connexion, exécutez :
codex mcp login fredDans la page du navigateur, connectez-vous à FRED, vérifiez les permissions, puis cliquez sur Revenir à mon assistant.
3. Vérifiez la configuration et ouvrez Codex.
codex mcp list
codexfred doit apparaître dans la liste. Ouvrez une nouvelle conversation si Codex
était déjà lancé, puis essayez la demande ci-dessous pour vérifier l’accès.
1. Ajoutez la configuration à votre projet.
Dans Cursor, créez le fichier .cursor/mcp.json à la racine de votre projet
et collez ce contenu. Si le fichier existe déjà, ajoutez seulement l’entrée
fred dans mcpServers en conservant vos autres serveurs.
{
"mcpServers": {
"fred": {
"url": "https://docs.fredpod.com/api/mcp"
}
}
}Pour utiliser FRED dans tous vos projets, placez plutôt cette configuration
dans ~/.cursor/mcp.json, dans votre dossier utilisateur.
2. Connectez votre compte FRED.
Dans Customize, ouvrez les serveurs MCP et lancez la connexion de fred.
Connectez-vous dans la page FRED du navigateur, vérifiez les permissions,
puis cliquez sur Revenir à mon assistant.
3. Essayez FRED dans Agent.
Vérifiez que le serveur fred est activé et que ses outils sont disponibles.
Ouvrez une conversation Agent, puis copiez le premier essai ci-dessous.
Dans les réglages MCP de votre assistant, ajoutez un serveur distant :
| Champ | Valeur |
|---|---|
| Nom | fred |
| Transport | HTTP / Streamable HTTP |
| Authentification | OAuth |
https://docs.fredpod.com/api/mcpLancez la connexion et autorisez l’accès sur la page FRED du navigateur. Votre client doit prendre en charge les serveurs MCP distants et OAuth.
Vérifier la connexion
Copiez cette demande dans votre assistant :
Utilise le MCP fred pour consulter mon compte et rechercher dans la documentation
comment obtenir un devis. Résume les étapes et donne les liens des guides.
Ne crée et ne modifie rien.L’assistant doit pouvoir lire votre compte et citer les guides FRED. S’il ne trouve
pas les outils fred, consultez le dépannage.
Intégrer FRED à votre projet
Ouvrez votre projet dans Claude Code, Codex ou Cursor, puis copiez cette demande :
Utilise le MCP fred pour lire la documentation FRED sur les devis, la livraison
et l’authentification. Inspecte mon projet et implémente une intégration adaptée
à sa stack pour importer un modèle 3D et afficher un devis livré.
Garde FRED_API_KEY côté serveur et fournis un fichier .env.example sans secret.
Gère les devis en cours d’analyse, les erreurs et les prix encore indicatifs.
Ajoute des tests avec des réponses simulées, sans appeler les services réels.
Ne crée aucune commande et ne déclenche aucun paiement.Le MCP donne à votre assistant l’accès aux guides et aux outils FRED. Pour les appels de votre application, créez ensuite sa propre clé API côté serveur.
Exemples à copier-coller
Avec le MCP fred, retrouve mes produits actifs. Présente leurs noms, variantes
et identifiants dans un tableau. Ne modifie rien.Avec le MCP fred, aide-moi à chiffrer un de mes produits avec la livraison.
Commence par me faire choisir le produit et sa variante, puis demande la quantité
et la destination. Attends ces informations avant de créer le devis.
Présente le total livré et distingue une estimation d’un prix confirmé.
Ne crée aucune commande.Avec le MCP fred, liste mes commandes récentes, leur état et les informations
de suivi disponibles. Indique celles qui attendent une action de ma part.
Ne modifie et n’annule aucune commande.Ce que vous autorisez
La connexion permet à l’assistant de lire et de gérer les fichiers, produits, marques, devis et commandes de votre compte selon les permissions accordées. La facturation reste en lecture seule.
Toute commande préparée via MCP doit être validée dans FRED avant paiement et fabrication. L’assistant vous fournit le lien pour vérifier le montant et confirmer.
Vous pouvez retirer l’accès depuis les clés API de votre compte en supprimant la clé MCP · votre application. Saisissez vos identifiants uniquement sur la page de connexion FRED ouverte dans le navigateur.
Dépannage
| Problème | Que faire ? |
|---|---|
claude ou codex est introuvable | Installez le CLI correspondant avec le lien indiqué en début de page, puis rouvrez votre terminal. |
| FRED est ajouté mais pas connecté | Claude Code : ouvrez /mcp et connectez fred. Codex : lancez codex mcp login fred. |
| Cursor ne trouve pas FRED | Vérifiez le fichier .cursor/mcp.json du projet ouvert, ou ~/.cursor/mcp.json pour tous les projets. Dans Customize, activez fred et lancez sa connexion OAuth. |
| Le navigateur ne s’ouvre pas | Ouvrez le lien de connexion affiché par votre assistant dans votre navigateur. |
| FRED a confirmé l’accès mais l’assistant attend encore | Cliquez sur Revenir à mon assistant dans la page de confirmation FRED. |
| Les outils FRED n’apparaissent pas | Ouvrez une nouvelle session après l’ajout. Vérifiez fred avec claude mcp get fred ou codex mcp list. |
| Une permission manque après une mise à jour | Reconnectez FRED pour autoriser les nouvelles fonctions ; les anciens accès ne sont pas étendus automatiquement. |
L’URL du serveur affiche 401 dans le navigateur | L’endpoint MCP demande une connexion OAuth : utilisez le parcours de votre assistant ci-dessus. |
Le service répond 503 | Le serveur est indisponible ou sa configuration est incomplète. Réessayez plus tard ; si cela persiste, signalez-le à l’équipe FRED. |
Référence des outils
Consulter les outils, les limites de fichiers et le fonctionnement des commandes
| Outils | Usage |
|---|---|
search, list_pages, get_page | Rechercher et lire les guides et la référence API complète |
get_account | Consulter le compte et ses réglages de validation |
list_files, get_file, upload_file | Rechercher, consulter et importer vos modèles, images et documents |
list_catalog, get_catalog_item | Trouver un modèle du catalogue FRED |
list_products, get_product, create_product, update_product | Gérer les produits, leurs couleurs, tailles et champs de personnalisation |
archive_product, activate_product, update_product_variant | Archiver ou réactiver un produit et modifier ses variantes |
list_brands, get_brand, create_brand, update_brand | Gérer les marques, logos, adresses et coordonnées |
get_materials | Consulter les matières et couleurs |
create_quote, get_quote | Chiffrer un fichier déjà enregistré ou un produit, puis suivre son analyse |
quote_shipping | Calculer un nouveau devis avec la livraison |
list_orders, get_order | Consulter les commandes et leur suivi |
create_order | Préparer une commande à partir d’un devis prêt et d’une option choisie |
get_order_approval_link | Obtenir le lien de validation dans FRED ; cet outil ne confirme pas lui-même la commande |
update_order, pause_order, cancel_order | Modifier une commande lorsque son état le permet, suspendre sa revue ou l’annuler avant fabrication |
list_disputes, get_dispute, open_dispute | Consulter les incidents ou signaler un problème sur une commande expédiée ou livrée |
get_billing, list_billing_plans, list_charges | Consulter l’abonnement, les offres et l’historique des paiements et remboursements |
Importer un fichier
upload_file accepte les octets du fichier encodés en base64, jusqu’à 2 Mio
avant encodage : STL, 3MF ou OBJ pour les modèles ; PNG, JPG, WebP ou SVG pour les
images ; PDF pour les documents. L’assistant doit avoir accès au fichier réel.
Il ne suffit pas de fournir un chemin sur votre ordinateur ou une URL.
Pour un fichier plus volumineux, importez-le dans FRED puis demandez à l’assistant
de le retrouver avec list_files. L’analyse, les dimensions et les problèmes de
géométrie sont accessibles avec get_file.
Prix et validation
Importez le fichier ou retrouvez un produit existant avant de demander un devis. Si un devis est encore en traitement, consultez-le à nouveau. Les prix indicatifs ne permettent pas de commander.
Pour préparer une commande, l’assistant doit fournir l’option choisie, votre adresse de livraison et un plafond de prix en centimes d’euro. FRED impose une validation manuelle, même si votre compte autorise habituellement les commandes automatiques. Ouvrez le lien retourné et validez dans FRED le montant et la commande avant tout paiement et lancement de fabrication.
Les créations de devis et de commandes utilisent une clé d’idempotence : une reprise après un délai d’attente
ou une réponse processing conserve les mêmes paramètres et la même clé. Modifier
la demande nécessite une nouvelle clé.
Les imports et créations de produits, marques ou incidents ne garantissent pas l’idempotence : après un délai d’attente, consultez la liste correspondante avant de recommencer. L’annulation d’une commande payée peut demander un remboursement ; elle doit correspondre à votre demande explicite. Une commande déjà en fabrication ne peut pas être annulée par cet outil.
Le MCP reste réservé au compte client : il ne pilote pas les imprimantes, n’administre pas les ateliers et ne modifie pas les moyens de paiement.
Chaque accès dure une heure et peut être renouvelé automatiquement pendant 30 jours par votre client. Celui-ci peut demander un sous-ensemble des permissions ; une fonction non autorisée nécessite une nouvelle connexion.
Pour les options avancées, consultez les documentations officielles Claude Code — MCP, Codex — MCP et Cursor — MCP.