> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Configurer Firecrawl MCP dans un client
> Configuration spécifique au client pour le serveur MCP Firecrawl hébergé ou local.
Commencez par [Connecter Firecrawl MCP](/fr/mcp-server/connect) 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) :
Vous pouvez également l'ajouter manuellement à `~/.cursor/mcp.json` :
```json theme={null}
{
"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](https://cursor.com/docs/context/mcp)
Pour configurer Firecrawl MCP dans Cursor **v0.48.6**
1. Ouvrez les paramètres de Cursor
2. Accédez à Fonctionnalités > Serveurs MCP
3. Cliquez sur « + Ajouter un nouveau serveur MCP global »
4. Saisissez le code suivant :
```json theme={null}
{
"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**
1. Ouvrez les paramètres de Cursor
2. Accédez à Fonctionnalités > Serveurs MCP
3. Cliquez sur « + Ajouter un nouveau serveur MCP »
4. 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](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` :
```json theme={null}
{
"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 :
```bash theme={null}
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](http://localhost:3000/v2/mcp) en local, ou l’URL hébergée [https://mcp.firecrawl.dev/v2/mcp](https://mcp.firecrawl.dev/v2/mcp)
## Installation via Smithery (ancienne méthode)
Pour installer automatiquement Firecrawl pour Claude Desktop via [Smithery](https://smithery.ai/server/@mendableai/mcp-server-firecrawl) :
```bash theme={null}
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...
[](https://insiders.vscode.dev/redirect/mcp/install?name=firecrawl\&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22apiKey%22%2C%22description%22%3A%22Firecrawl%20API%20Key%22%2C%22password%22%3Atrue%7D%5D\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22firecrawl-mcp%22%5D%2C%22env%22%3A%7B%22FIRECRAWL_API_KEY%22%3A%22%24%7Binput%3AapiKey%7D%22%7D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=firecrawl\&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22apiKey%22%2C%22description%22%3A%22Firecrawl%20API%20Key%22%2C%22password%22%3Atrue%7D%5D\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22firecrawl-mcp%22%5D%2C%22env%22%3A%7B%22FIRECRAWL_API_KEY%22%3A%22%24%7Binput%3AapiKey%7D%22%7D%7D\&quality=insiders)
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)`.
```json theme={null}
{
"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 :
```json theme={null}
{
"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](https://github.com/microsoft/vscode/issues/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)](https://github.com/directus/directus/issues/25906#issuecomment-3369169513).
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 :
```json theme={null}
{
"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 `.
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](https://nodejs.org)) :
```json theme={null}
{
"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](https://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 :
```bash theme={null}
# 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 "
# 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.
1. Ouvrez la barre latérale Agent dans l’éditeur ou la vue Agent Manager
2. Cliquez sur le menu "..." (Autres actions), puis sélectionnez **Serveurs MCP**
3. Sélectionnez **View raw config** pour ouvrir votre fichier local `mcp_config.json`
4. Ajoutez la configuration suivante :
```json theme={null}
{
"mcpServers": {
"firecrawl": {
"command": "npx",
"args": ["-y", "firecrawl-mcp"],
"env": {
"FIRECRAWL_API_KEY": "YOUR_FIRECRAWL_API_KEY"
}
}
}
}
```
5. 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](https://www.firecrawl.dev/app/api-keys).
## Utilisation avec n8n
Pour connecter le serveur MCP Firecrawl à n8n :
1. Obtenez votre clé API Firecrawl sur [https://firecrawl.dev/app/api-keys](https://www.firecrawl.dev/app/api-keys)
2. Dans votre workflow n8n, ajoutez un nœud **agent IA**
3. Dans la configuration de l’agent IA, ajoutez un nouvel **outil**
4. Sélectionnez **MCP Client Tool** comme type d’outil
5. Saisissez le point de terminaison du serveur MCP :
```
https://mcp.firecrawl.dev/v2/mcp
```
6. Réglez **Server Transport** sur **HTTP Streamable**
7. Réglez **Authentication** sur **Bearer**, puis collez votre clé API Firecrawl, ou laissez **None** pour utiliser l’offre gratuite sans clé
8. 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 :
```bash theme={null}
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.