> ## 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.

# Execute o Firecrawl MCP localmente

> Instale e configure o servidor MCP local do Firecrawl.

<div id="run-locally">
  ## Execute localmente
</div>

```bash theme={null}
env FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp@3.22.4
```

<div id="install-globally">
  ## Instale globalmente
</div>

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

<div id="configuration">
  ## Configuração
</div>

<div id="environment-variables">
  ### Variáveis de ambiente
</div>

<div id="cloud-and-self-hosted-api">
  #### API em nuvem e auto-hospedada
</div>

* `FIRECRAWL_API_KEY`: Sua chave de API do Firecrawl
  * Obrigatória ao usar a API em nuvem (padrão)
  * Opcional ao usar uma instância auto-hospedada com `FIRECRAWL_API_URL`
* `FIRECRAWL_API_URL` (Opcional): Endpoint de API personalizado para instâncias auto-hospedadas
  * Exemplo: `https://firecrawl.your-domain.com`
  * Se não for fornecida, a API em nuvem será usada (requer uma chave de API)

<div id="configuration-examples">
  ### Exemplos de configuração
</div>

Para usar a API na nuvem:

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

Para uma instância auto-hospedada:

```bash theme={null}
export FIRECRAWL_API_URL=https://firecrawl.your-domain.com
export FIRECRAWL_API_KEY=your-api-key  # Se sua instância exigir autenticação
```

<div id="custom-configuration-with-claude-desktop">
  ### Configuração personalizada com o Claude Desktop
</div>

Adicione o seguinte ao seu `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 hospedado vs. MCP local
</div>

O servidor MCP hospedado é otimizado para uso remoto seguro. Algumas opções disponíveis ao executar o servidor MCP localmente são restritas ou indisponíveis remotamente:

* O modo hospedado sem chave expõe apenas as ferramentas compatíveis com esse modo e tem limite de taxa por IP.
* A leitura de arquivos locais está disponível apenas quando você executa o servidor MCP localmente.
* Webhooks e caminhos de arquivos locais devem ser configurados em um servidor MCP local ou auto-hospedado quando o agente precisar acessar recursos locais.

<div id="rate-limiting">
  ### Limites de taxa
</div>

Os limites de taxa são aplicados pelo Firecrawl. Use uma chave de API para obter limites mais altos e acesso ao conjunto completo de ferramentas.