Exécuter Firecrawl MCP localement

Installez et configurez le serveur MCP Firecrawl local.

​

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 :

node --version

​

Exécuter via stdio

env FIRECRAWL_API_KEY=VOTRE_CLÉ_API npx -y firecrawl-mcp@3.23.0

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 :

env HTTP_STREAMABLE_SERVER=true \
  FIRECRAWL_API_KEY=VOTRE_CLÉ_API \
  npx -y firecrawl-mcp@3.23.0

Connectez le client à :

http://localhost:3000/mcp

Vérifiez que le serveur est prêt :

curl http://localhost:3000/health

La vérification d’état renvoie ok. La route locale est /mcp ; /v2/mcp est la route Firecrawl hébergée.

​

Installation globale

npm install -g firecrawl-mcp@3.23.0

Ensuite, exécutez :

env FIRECRAWL_API_KEY=VOTRE_CLÉ_API firecrawl-mcp

​

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 :

export FIRECRAWL_API_KEY=your-api-key

Pour une instance auto-hébergée :

export FIRECRAWL_API_URL=https://firecrawl.your-domain.com
export FIRECRAWL_API_KEY=your-api-key  # Si votre instance requiert une authentification

​

Configuration personnalisée avec Claude Desktop

Ajoutez ceci à votre fichier claude_desktop_config.json :

{
  "mcpServers": {
    "mcp-server-firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

​

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.