# Exécuter Firecrawl MCP localement (/fr/mcp-server/local)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 1013 · updated: 2026-07-30 -->
Related: [Configurer Firecrawl MCP dans un client](/fr/mcp-server/clients.md), [Connecter Firecrawl MCP](/fr/mcp-server/connect.md), [Développer le MCP Firecrawl](/fr/mcp-server/development.md), [Outils et opérations de Firecrawl MCP](/fr/mcp-server/tools.md)

<div id="prerequisites">
  ## Prérequis [#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
node --version
```

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

```bash
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 [#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
env HTTP_STREAMABLE_SERVER=true \
  FIRECRAWL_API_KEY=VOTRE_CLÉ_API \
  npx -y firecrawl-mcp@3.23.0
```

Connectez le client à :

```text
http://localhost:3000/mcp
```

Vérifiez que le serveur est prêt :

```bash
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 [#installation-globale]
</div>

```bash
npm install -g firecrawl-mcp@3.23.0
```

Ensuite, exécutez :

```bash
env FIRECRAWL_API_KEY=VOTRE_CLÉ_API firecrawl-mcp
```

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

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

<div id="cloud-and-self-hosted-api">
  #### API cloud et auto-hébergée [#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 [#exemples-de-configuration]
</div>

Pour utiliser l’API cloud :

```bash
export FIRECRAWL_API_KEY=your-api-key
```

Pour une instance auto-hébergée :

```bash
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 [#configuration-personnalisée-avec-claude-desktop]
</div>

Ajoutez ceci à votre fichier `claude_desktop_config.json` :

```json
{
  "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 [#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 [#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.