Configurer Firecrawl MCP dans un client

Commencez par Connecter Firecrawl MCP pour choisir entre l’authentification OAuth du compte, l’accès non supervisé par clé API ou l’accès sans clé. Ces exemples propres à chaque client utilisent le même mécanisme adapté au mode choisi.

Utilisation avec Cursor

Installez le serveur hébergé sans clé en un clic (aucune clé API requise) :

Ajouter le serveur MCP Firecrawl à Cursor

Vous pouvez également l’ajouter manuellement à ~/.cursor/mcp.json :

{
  "mcpServers": {
    "firecrawl": {
      "url": "https://mcp.firecrawl.dev/v2/mcp"
    }
  }
}

Exécution locale avec une clé API

Remarque : nécessite Cursor version 0.45.6 ou ultérieure. Pour les instructions de configuration les plus récentes, consultez la documentation officielle de Cursor sur la configuration des serveurs MCP : Guide de configuration des serveurs MCP de Cursor Pour configurer Firecrawl MCP dans Cursor v0.48.6

Ouvrez les paramètres de Cursor
Accédez à Fonctionnalités > Serveurs MCP
Cliquez sur « + Ajouter un nouveau serveur MCP global »

Saisissez le code suivant :

{
  "mcpServers": {
    "firecrawl-mcp": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR-API-KEY"
      }
    }
  }
}

Pour configurer Firecrawl MCP dans Cursor v0.45.6

Ouvrez les paramètres de Cursor
Accédez à Fonctionnalités > Serveurs MCP
Cliquez sur « + Ajouter un nouveau serveur MCP »
Saisissez les informations suivantes :
- Nom : “firecrawl-mcp” (ou le nom de votre choix)
- Type : “command”
- Commande : env FIRECRAWL_API_KEY=your-api-key npx -y firecrawl-mcp@3.22.4

Si vous utilisez Windows et rencontrez des problèmes, essayez cmd /c "set FIRECRAWL_API_KEY=your-api-key && npx -y firecrawl-mcp@3.22.4"

Remplacez your-api-key par votre clé API Firecrawl. Si vous n’en avez pas encore, vous pouvez créer un compte et l’obtenir sur https://www.firecrawl.dev/app/api-keys Après l’ajout, actualisez la liste des serveurs MCP pour voir les nouveaux outils. L’Agent Composer utilisera automatiquement Firecrawl MCP lorsque nécessaire, mais vous pouvez le demander explicitement en décrivant vos besoins en données web. Accédez à Composer avec Command+L (Mac), sélectionnez « Agent » à côté du bouton d’envoi, puis saisissez votre requête.

Utilisation avec Windsurf

Ajoutez ceci à votre fichier ./codeium/windsurf/model_config.json :

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

Exécuter le serveur avec le mode Streamable HTTP

Pour exécuter le serveur localement avec le transport HTTP Streamable plutôt qu’avec le transport stdio par défaut :

env HTTP_STREAMABLE_SERVER=true FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp@3.22.4

Utilisez l’URL http://localhost:3000/v2/mcp en local, ou l’URL hébergée https://mcp.firecrawl.dev/v2/mcp

Installation via Smithery (ancienne méthode)

Pour installer automatiquement Firecrawl pour Claude Desktop via Smithery :

npx -y @smithery/cli install @mendableai/mcp-server-firecrawl --client claude

Utilisation avec VS Code

Pour une installation en un clic, cliquez sur l’un des boutons d’installation ci-dessous…

Pour une installation manuelle, ajoutez le bloc JSON suivant au fichier User Settings (JSON) de VS Code. Pour l’ouvrir, appuyez sur Ctrl + Shift + P, puis saisissez Preferences: Open User Settings (JSON).

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apiKey",
        "description": "Firecrawl API Key",
        "password": true
      }
    ],
    "servers": {
      "firecrawl": {
        "command": "npx",
        "args": ["-y", "firecrawl-mcp"],
        "env": {
          "FIRECRAWL_API_KEY": "${input:apiKey}"
        }
      }
    }
  }
}

Vous pouvez également l’ajouter à un fichier nommé .vscode/mcp.json dans votre espace de travail. Vous pourrez ainsi partager la configuration avec d’autres :

{
  "inputs": [
    {
      "type": "promptString",
      "id": "apiKey",
      "description": "Firecrawl API Key",
      "password": true
    }
  ],
  "servers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "${input:apiKey}"
      }
    }
  }
}

Remarque : Certains utilisateurs ont rencontré des problèmes lors de l’ajout du serveur MCP à VS Code, en raison de la manière dont celui-ci valide le JSON avec un format de schéma obsolète (microsoft/vscode#155379). Cela affecte plusieurs outils MCP, dont Firecrawl. Solution de contournement : Désactivez la validation JSON dans VS Code pour permettre au serveur MCP de se charger correctement. Voir la référence : directus/directus#25906 (commentaire). Le serveur MCP fonctionne toujours correctement lorsqu’il est appelé via d’autres extensions, mais le problème survient spécifiquement lorsqu’il est enregistré directement dans la liste des serveurs MCP. Nous ajouterons des instructions lorsque VS Code aura mis à jour la validation de ses schémas.

Utilisation avec Claude Desktop

Pour connecter un compte de manière interactive, ajoutez le point de terminaison du compte et suivez le flux OAuth dans le Browser :

{
  "mcpServers": {
    "firecrawl": {
      "url": "https://mcp.firecrawl.dev/v2/mcp-oauth"
    }
  }
}

Pour une configuration sans interaction ou basée sur une clé API, utilisez plutôt https://mcp.firecrawl.dev/v2/mcp avec l’en-tête Authorization: Bearer <FIRECRAWL_API_KEY>. Si vous obtenez l’erreur “Impossible de joindre le serveur MCP”, votre version de Claude Desktop ne prend peut-être pas en charge le transport HTTP Streamable. Utilisez plutôt l’approche locale avec npx (nécessite Node.js) :

{
  "mcpServers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "VOTRE_CLÉ_API"
      }
    }
  }
}

Si l’erreur spawn npx ENOENT s’affiche, Node.js n’est pas installé ou ne figure pas dans le PATH de votre système. Installez Node.js depuis nodejs.org (version LTS), puis redémarrez complètement Claude Desktop. Sous Windows, vous pouvez également exécuter where npx dans l’Invite de commandes et utiliser le chemin complet (par exemple, C:\\Program Files\\nodejs\\npx.cmd) comme valeur de command.

Utilisation avec Claude Code

Ajoutez le serveur MCP Firecrawl à l’aide de l’interface en ligne de commande de Claude Code. Vous pouvez utiliser l’URL hébergée à distance ou l’exécuter localement :

# Connexion interactive du compte (recommandé)
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp-oauth

# Pour une configuration par clé d'API sans intervention, utilisez un en-tête Authorization
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp --header "Authorization: Bearer <FIRECRAWL_API_KEY>"

# Ou exécutez en local via npx
claude mcp add firecrawl -e FIRECRAWL_API_KEY=fc-your-api-key -- npx -y firecrawl-mcp@3.22.4

Utilisation avec Google Antigravity

Google Antigravity vous permet de configurer des serveurs MCP directement depuis son interface Agent.

Ouvrez la barre latérale Agent dans l’éditeur ou la vue Agent Manager
Cliquez sur le menu ”…” (Autres actions), puis sélectionnez Serveurs MCP
Sélectionnez View raw config pour ouvrir votre fichier local mcp_config.json
Ajoutez la configuration suivante :

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

Enregistrez le fichier, puis cliquez sur Actualiser dans l’interface MCP d’Antigravity pour voir les nouveaux outils.

Remplacez YOUR_FIRECRAWL_API_KEY par votre clé API disponible sur https://firecrawl.dev/app/api-keys.

Utilisation avec n8n

Pour connecter le serveur MCP Firecrawl à n8n :

Obtenez votre clé API Firecrawl sur https://firecrawl.dev/app/api-keys
Dans votre workflow n8n, ajoutez un nœud agent IA
Dans la configuration de l’agent IA, ajoutez un nouvel outil
Sélectionnez MCP Client Tool comme type d’outil
Saisissez le point de terminaison du serveur MCP :

  https://mcp.firecrawl.dev/v2/mcp

Réglez Server Transport sur HTTP Streamable
Réglez Authentication sur Bearer, puis collez votre clé API Firecrawl, ou laissez None pour utiliser l’offre gratuite sans clé
Pour Tools to include, vous pouvez sélectionner All, Selected ou All Except : les outils Firecrawl (scrape, crawl, cartographie, recherche, extract, etc.) seront alors exposés

Pour les déploiements auto-hébergés, exécutez le serveur MCP avec npx et activez le mode de transport HTTP :

env HTTP_STREAMABLE_SERVER=true \
    FIRECRAWL_API_KEY=fc-YOUR_API_KEY \
    FIRECRAWL_API_URL=YOUR_FIRECRAWL_INSTANCE \
    npx -y firecrawl-mcp@3.22.4

Cette commande démarre le serveur sur http://localhost:3000/v2/mcp, que vous pouvez utiliser comme point de terminaison dans votre workflow n8n. La variable d’environnement HTTP_STREAMABLE_SERVER=true est requise, car n8n nécessite le transport HTTP.

Prise en main

Points de terminaison de base

Plus

Démarrages rapides

Guides développeur

Webhooks

Cas d'utilisation

Autres

Contribuer

Configurer Firecrawl MCP dans un client

Utilisation avec Cursor

Exécution locale avec une clé API

Utilisation avec Windsurf

Exécuter le serveur avec le mode Streamable HTTP

Installation via Smithery (ancienne méthode)

Utilisation avec VS Code

Utilisation avec Claude Desktop

Utilisation avec Claude Code

Utilisation avec Google Antigravity

Utilisation avec n8n

​Utilisation avec Cursor

​Exécution locale avec une clé API

​Utilisation avec Windsurf

​Exécuter le serveur avec le mode Streamable HTTP

​Installation via Smithery (ancienne méthode)

​Utilisation avec VS Code

​Utilisation avec Claude Desktop

​Utilisation avec Claude Code

​Utilisation avec Google Antigravity

​Utilisation avec n8n

Utilisation avec Cursor

Exécution locale avec une clé API

Utilisation avec Windsurf

Exécuter le serveur avec le mode Streamable HTTP

Installation via Smithery (ancienne méthode)

Utilisation avec VS Code

Utilisation avec Claude Desktop

Utilisation avec Claude Code

Utilisation avec Google Antigravity

Utilisation avec n8n