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

# Pesquisa na web e scraping via MCP no Pi

> Adicione web scraping e busca do Firecrawl ao agente de programação Pi

Adicione as ferramentas Search, Scrape, Crawl e Map do Firecrawl ao [Pi](https://pi.dev) usando o servidor MCP hospedado.

<h2 id="quick-setup">
  Configuração rápida
</h2>

[Crie uma chave de API do Firecrawl](https://www.firecrawl.dev/app/api-keys) e depois exporte-a para que o Pi consiga lê-la:

```bash theme={null}
export FIRECRAWL_API_KEY=fc-YOUR_API_KEY
```

Adicione o servidor usando o comando MCP integrado do Pi:

```bash theme={null}
pi mcp add firecrawl --url https://mcp.firecrawl.dev/v2/mcp --bearer-token-env-var FIRECRAWL_API_KEY
```

Isso grava a entrada em `~/.pi/agent/mcp.json`. Você também pode colá-la manualmente ou colocá-la em `.pi/mcp.json` para usá-la em um único projeto:

```json theme={null}
{
  "mcpServers": {
    "firecrawl": {
      "url": "https://mcp.firecrawl.dev/v2/mcp",
      "headers": {
        "Authorization": "Bearer ${FIRECRAWL_API_KEY}"
      }
    }
  }
}
```

Execute `pi mcp list` e confirme que `firecrawl` aparece como conectado, junto com suas ferramentas, como `firecrawl_search` e `firecrawl_scrape`. Em seguida, inicie o `pi`; se já houver uma sessão aberta, execute `/reload`.

Se você usa o [pi-mcp-adapter](https://github.com/nicobailon/pi-mcp-adapter), adicione a mesma entrada em `~/.config/mcp/mcp.json` (ou em `.mcp.json`, no caso de um projeto) e execute `pi-mcp-adapter doctor` para verificar a conexão.

<h3 id="run-it-locally-instead">
  Executar localmente como alternativa
</h3>

Para executar o servidor MCP na sua máquina, adicione-o como um servidor stdio:

```bash theme={null}
pi mcp add firecrawl --env FIRECRAWL_API_KEY='${FIRECRAWL_API_KEY}' -- npx -y firecrawl-mcp
```

<h2 id="try-it">
  Experimente
</h2>

```text theme={null}
Faça uma busca na web pelas notas de versão mais recentes do Bun e resuma as fontes.
```

```text theme={null}
Faça scraping de https://firecrawl.dev e explique o que o site faz.
```

<h2 id="troubleshooting">
  Solução de problemas
</h2>

* **O servidor aparece com status de falha:** execute `pi mcp list` e verifique se `FIRECRAWL_API_KEY` foi exportada no mesmo shell em que o Pi é iniciado.
* **As ferramentas não aparecem em uma sessão aberta:** execute `/reload` depois de adicionar ou alterar um servidor fora da sessão.
* **O comando MCP do Pi não existe:** atualize o Pi para uma versão recente ou use o pi-mcp-adapter com a configuração acima.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.