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 Premiers pas.
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.
Utilisez HTTP lorsqu'un client tel que n8n se connecte à un serveur déjà en cours d'exécution :
Connectez le client à :
Vérifiez que le serveur est prêt :
La vérification d'état renvoie ok. La route locale est /mcp ; /v2/mcp correspond au service Firecrawl hébergé.
Configurer l’API Firecrawl#
| Variable d’environnement | Rôle |
|---|---|
FIRECRAWL_API_KEY | Permet de s’authentifier auprès de l’API cloud Firecrawl. Elle est facultative uniquement si une API auto-hébergée ne requiert pas d’authentification. |
FIRECRAWL_API_URL | Envoie les requêtes à une API Firecrawl auto-hébergée plutôt qu’à l’API cloud. |
HTTP_STREAMABLE_SERVER | Définissez cette variable sur true pour démarrer le transport HTTP Streamable local au lieu de stdio. |
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#
Le client signale l’erreur spawn npx ENOENT
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é.
Le client HTTP ne parvient pas à se connecter
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é.
Un outil est indisponible
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.
Le serveur est soumis à une limite de débit
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é.