Exécuter Firecrawl MCP localement

• 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

env FIRECRAWL_API_KEY=VOTRE_CLÉ_API npx -y [email protected]

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

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 [email protected]

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.

npm install -g [email protected]

Ensuite, exécutez :

env FIRECRAWL_API_KEY=VOTRE_CLÉ_API firecrawl-mcp

• 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)

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

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"
      }
    }
  }
}

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.

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.