Skip to main content
Exécutez Firecrawl MCP en local lorsqu’un client doit lancer un processus local, lorsque vous avez besoin d’un transport HTTP local ou lorsque le serveur MCP doit se connecter à une API Firecrawl auto-hébergée. Pour le service géré, commencez par la configuration de MCP.

​
Prérequis

  • Node.js 22 ou version ultérieure
  • npm et npx, inclus avec Node.js
  • Une clé API Firecrawl pour l’API cloud ou une URL d’API Firecrawl auto-hébergée
Vérifiez la version installée de Node.js :

​
Démarrer le serveur

Utilisez stdio lorsque le client MCP lance Firecrawl en tant que processus local :
Configurez le client pour exécuter npx -y firecrawl-mcp@3.23.7 et transmettez FIRECRAWL_API_KEY via son environnement protégé ou son mécanisme de gestion des secrets.

​
Configurer l’API Firecrawl

L’analyse directe de fichiers locaux avec firecrawl_parse nécessite que FIRECRAWL_API_URL pointe vers une API Firecrawl auto-hébergée. Un serveur MCP local connecté uniquement à l’API cloud ne peut pas téléverser de fichier local via cet outil ; le serveur hébergé utilise plutôt un transfert d’import signé.

​
Installer globalement

Utilisez npx pour une configuration plus rapide. Pour installer globalement la même version vérifiée à la place :
Ensuite, exécutez :

​
Dépannage

Installez Node.js 22 ou une version ultérieure, vérifiez que npx figure dans le PATH du client, puis redémarrez complètement le client. Sous Windows, exécutez where npx dans l’invite de commandes et configurez le client pour qu’il utilise le chemin npx.cmd renvoyé.
Vérifiez que HTTP_STREAMABLE_SERVER=true, puis appelez http://localhost:3000/health. Utilisez http://localhost:3000/mcp comme point de terminaison côté client, et non le chemin /v2/mcp hébergé.
La disponibilité des outils dépend des services Firecrawl activés dans le déploiement cible. Comparez la connexion avec celle indiquée dans Outils et vérifiez la sortie du processus local pour détecter d’éventuelles erreurs d’enregistrement ou d’authentification.
Les limites de débit sont appliquées par l’API Firecrawl connectée. Consultez les limites de débit actuelles et celles configurées pour un déploiement auto-hébergé.