> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-claude-eager-dijkstra-u6tgua.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Exécuter Firecrawl MCP localement

> Installez et configurez le serveur MCP Firecrawl local.

<div id="prerequisites">
  ## Prérequis
</div>

* 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 :

```bash theme={null}
node --version
```

<div id="run-over-stdio">
  ## Exécuter via stdio
</div>

```bash theme={null}
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.

<div id="run-with-streamable-http">
  ## Exécuter avec Streamable HTTP
</div>

Utilisez le transport HTTP pour les clients tels que n8n qui se connectent à un serveur MCP déjà en cours d’exécution :

```bash theme={null}
env HTTP_STREAMABLE_SERVER=true \
  FIRECRAWL_API_KEY=VOTRE_CLÉ_API \
  npx -y firecrawl-mcp@3.23.0
```

Connectez le client à :

```text theme={null}
http://localhost:3000/mcp
```

Vérifiez que le serveur est prêt :

```bash theme={null}
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.

<div id="install-globally">
  ## Installation globale
</div>

```bash theme={null}
npm install -g firecrawl-mcp@3.23.0
```

Ensuite, exécutez :

```bash theme={null}
env FIRECRAWL_API_KEY=VOTRE_CLÉ_API firecrawl-mcp
```

<div id="configuration">
  ## Configuration
</div>

<div id="environment-variables">
  ### Variables d’environnement
</div>

<div id="cloud-and-self-hosted-api">
  #### API cloud et auto-hébergée
</div>

* `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)

<div id="configuration-examples">
  ### Exemples de configuration
</div>

Pour utiliser l’API cloud :

```bash theme={null}
export FIRECRAWL_API_KEY=your-api-key
```

Pour une instance auto-hébergée :

```bash theme={null}
export FIRECRAWL_API_URL=https://firecrawl.your-domain.com
export FIRECRAWL_API_KEY=your-api-key  # Si votre instance requiert une authentification
```

<div id="custom-configuration-with-claude-desktop">
  ### Configuration personnalisée avec Claude Desktop
</div>

Ajoutez ceci à votre fichier `claude_desktop_config.json` :

```json theme={null}
{
  "mcpServers": {
    "mcp-server-firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}
```

<div id="hosted-mcp-vs-local-mcp">
  ### MCP hébergé ou local
</div>

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.

<Note>
  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.
</Note>

<div id="rate-limiting">
  ### Limites de débit
</div>

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.