Skip to main content

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 :

Exécuter via stdio

Il s’agit du transport par défaut pour les clients qui exécutent le serveur MCP en tant que processus local.

Exécuter avec Streamable HTTP

Utilisez le transport HTTP pour les clients tels que n8n qui se connectent à un serveur MCP 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 est la route Firecrawl hébergée.

Installation globale

Ensuite, exécutez :

Configuration

Variables d’environnement

API cloud et auto-hébergée

  • FIRECRAWL_API_KEY : votre clé API Firecrawl
    • Requise pour utiliser l’API cloud (par défaut)
    • Facultative pour utiliser une instance auto-hébergée avec FIRECRAWL_API_URL
  • FIRECRAWL_API_URL (facultatif) : point de terminaison d’API personnalisé pour les instances auto-hébergées
    • Exemple : https://firecrawl.your-domain.com
    • Si elle n’est pas fournie, l’API cloud est utilisée (clé API requise)

Exemples de configuration

Pour utiliser l’API cloud :
Pour une instance auto-hébergée :

Configuration personnalisée avec Claude Desktop

Ajoutez ceci à votre fichier claude_desktop_config.json :

MCP hébergé ou local

Le serveur MCP hébergé est optimisé pour une utilisation distante sécurisée. Certaines options disponibles lors de l’exécution locale du serveur MCP sont restreintes ou indisponibles à distance :
  • Le mode keyless hébergé n’expose que Search, Scrape et Parse et est limité en débit par adresse IP.
  • La lecture de fichiers locaux n’est disponible que lorsque vous exécutez le serveur MCP localement.
  • Les Webhooks et les chemins de fichiers locaux doivent être configurés depuis un serveur MCP local ou auto-hébergé lorsque l’agent doit accéder à des ressources locales.
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 configuré uniquement avec une clé API cloud ne peut pas téléverser un fichier local via cet outil.

Limites de débit

Firecrawl applique des limites de débit. Utilisez une clé API pour bénéficier de limites plus élevées et accéder à l’ensemble complet d’outils.