# Configure o Firecrawl MCP em um cliente (/pt-BR/mcp-server/clients)
Related: [Conectar ao Firecrawl MCP](/pt-BR/mcp-server/connect.md), [Desenvolva o Firecrawl MCP](/pt-BR/mcp-server/development.md), [Execute o Firecrawl MCP localmente](/pt-BR/mcp-server/local.md), [Ferramentas e operações do Firecrawl MCP](/pt-BR/mcp-server/tools.md)
Comece por [Conectar o Firecrawl MCP](/pt-BR/mcp-server/connect) para escolher OAuth da conta, acesso não assistido com chave de API ou acesso sem chave. Estes exemplos específicos de cada cliente usam o mesmo contrato compatível com o modo selecionado.
## Executando no Cursor [#executando-no-cursor]
Instale o servidor hospedado sem chave com um clique (não requer chave de API):
Instalar o Firecrawl MCP no Cursor
Ou adicione-o manualmente ao `~/.cursor/mcp.json`:
```json
{
"mcpServers": {
"firecrawl": {
"url": "https://mcp.firecrawl.dev/v2/mcp"
}
}
}
```
### Execução local com uma chave de API [#execução-local-com-uma-chave-de-api]
Observação: requer o Cursor versão 0.45.6 ou superior.
Para ver as instruções de configuração mais atualizadas, consulte a documentação oficial do Cursor sobre configuração de servidores MCP:
[Guia de configuração do servidor MCP do Cursor](https://cursor.com/docs/context/mcp)
Para configurar o Firecrawl MCP no Cursor **v0.48.6**
1. Abra as configurações do Cursor
2. Acesse Recursos > Servidores MCP
3. Clique em "+ Adicionar novo servidor MCP global"
4. Insira o seguinte código:
```json
{
"mcpServers": {
"firecrawl-mcp": {
"command": "npx",
"args": ["-y", "firecrawl-mcp"],
"env": {
"FIRECRAWL_API_KEY": "YOUR-API-KEY"
}
}
}
}
```
Para configurar o Firecrawl MCP no Cursor **v0.45.6**
1. Abra as configurações do Cursor
2. Acesse Recursos > Servidores MCP
3. Clique em "+ Adicionar novo servidor MCP"
4. Insira o seguinte:
* Nome: "firecrawl-mcp" (ou o nome de sua preferência)
* Tipo: "command"
* Comando: `env FIRECRAWL_API_KEY=your-api-key npx -y firecrawl-mcp@3.23.0`
> Se estiver usando o Windows e tiver problemas, tente `cmd /c "set FIRECRAWL_API_KEY=your-api-key && npx -y firecrawl-mcp@3.23.0"`
Substitua `your-api-key` pela sua chave de API do Firecrawl. Se ainda não tiver uma, crie uma conta e obtenha-a em [https://www.firecrawl.dev/app/api-keys](https://www.firecrawl.dev/app/api-keys)
Depois de adicionar, atualize a lista de servidores MCP para ver as novas ferramentas. O agente Composer usará o Firecrawl MCP automaticamente quando apropriado, mas você também pode solicitá-lo explicitamente descrevendo suas necessidades de dados da web. Acesse o Composer com Command+L (Mac), selecione "Agent" ao lado do botão de envio e insira sua consulta.
## Executando no Windsurf [#executando-no-windsurf]
Adicione o seguinte ao seu `./codeium/windsurf/model_config.json`:
```json
{
"mcpServers": {
"mcp-server-firecrawl": {
"command": "npx",
"args": ["-y", "firecrawl-mcp"],
"env": {
"FIRECRAWL_API_KEY": "YOUR_API_KEY"
}
}
}
}
```
## Executando com o modo Streamable HTTP [#executando-com-o-modo-streamable-http]
Para executar o servidor localmente usando o transporte Streamable HTTP em vez do transporte stdio padrão:
```bash
env HTTP_STREAMABLE_SERVER=true FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp@3.23.0
```
Use `http://localhost:3000/mcp` para o servidor local. A rota `/v2/mcp` pertence ao serviço hospedado em `https://mcp.firecrawl.dev/v2/mcp`.
Confirme se o processo local está pronto antes de conectar um cliente:
```bash
curl http://localhost:3000/health
```
A verificação de integridade retorna `ok`. Consulte [Executar o Firecrawl MCP localmente](/pt-BR/mcp-server/local#run-with-streamable-http) para conhecer os pré-requisitos e a configuração.
## Instalação via Smithery (legado) [#instalação-via-smithery-legado]
Para instalar automaticamente o Firecrawl no Claude Desktop via [Smithery](https://smithery.ai/server/@mendableai/mcp-server-firecrawl):
```bash
npx -y @smithery/cli install @mendableai/mcp-server-firecrawl --client claude
```
## Executando no VS Code [#executando-no-vs-code]
Para instalar com um clique, clique em um dos botões abaixo...
[](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)
Para instalar manualmente, adicione o seguinte bloco JSON ao arquivo User Settings (JSON) do VS Code. Para isso, pressione `Ctrl + Shift + P` e digite `Preferences: Open User Settings (JSON)`.
```json
{
"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}"
}
}
}
}
}
```
Opcionalmente, você pode adicioná-lo a um arquivo chamado `.vscode/mcp.json` no seu espaço de trabalho. Assim, você poderá compartilhar a configuração com outras pessoas:
```json
{
"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}"
}
}
}
}
```
**Observação:** Alguns usuários relataram problemas ao adicionar o servidor MCP ao VS Code devido à forma como ele valida JSON usando um formato de esquema desatualizado ([microsoft/vscode#155379](https://github.com/microsoft/vscode/issues/155379)).
Isso afeta várias ferramentas MCP, incluindo o Firecrawl.
**Solução alternativa:** Desative a validação de JSON no VS Code para que o servidor MCP seja carregado corretamente.
Consulte: [directus/directus#25906 (comentário)](https://github.com/directus/directus/issues/25906#issuecomment-3369169513).
O servidor MCP continua funcionando normalmente quando invocado por outras extensões, mas o problema ocorre especificamente ao registrá-lo diretamente na lista de servidores MCP. Planejamos adicionar orientações assim que o VS Code atualizar a validação de esquema.
## Executando no Claude Desktop [#executando-no-claude-desktop]
Para conectar uma conta de forma interativa, adicione o endpoint da conta e conclua o fluxo OAuth no navegador:
```json
{
"mcpServers": {
"firecrawl": {
"url": "https://mcp.firecrawl.dev/v2/mcp-oauth"
}
}
}
```
Para uma configuração sem supervisão ou com chave de API, use `https://mcp.firecrawl.dev/v2/mcp` com o header `Authorization: Bearer `.
Se você receber o erro "Não foi possível acessar o servidor MCP", sua versão do Claude Desktop pode não ser compatível com o transporte Streamable HTTP. Use a abordagem local com npx (requer [Node.js](https://nodejs.org)):
```json
{
"mcpServers": {
"firecrawl": {
"command": "npx",
"args": ["-y", "firecrawl-mcp"],
"env": {
"FIRECRAWL_API_KEY": "YOUR_API_KEY"
}
}
}
}
```
Se aparecer o erro `spawn npx ENOENT`, o Node.js não está instalado ou não está incluído no PATH do sistema. Instale o Node.js em [nodejs.org](https://nodejs.org) (versão LTS) e reinicie completamente o Claude Desktop. No Windows, você também pode executar `where npx` no Prompt de Comando e usar o caminho completo (por exemplo, `C:\\Program Files\\nodejs\\npx.cmd`) como valor de `command`.
## No Claude Code [#no-claude-code]
Adicione o servidor Firecrawl MCP usando a CLI do Claude Code. Você pode usar a URL hospedada remotamente ou executá-lo localmente:
```bash
# Conexão interativa da conta (recomendado)
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp-oauth
# Para uma configuração não assistida com chave de API, use um header Authorization
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp --header "Authorization: Bearer "
# Ou execute localmente via npx
claude mcp add firecrawl -e FIRECRAWL_API_KEY=fc-your-api-key -- npx -y firecrawl-mcp@3.23.0
```
## No Google Antigravity [#no-google-antigravity]
O Google Antigravity permite configurar servidores MCP diretamente pela interface do Agent.
1. Abra a barra lateral do Agent no Editor ou a visualização do Agent Manager
2. Clique no menu "..." (Mais ações) e selecione **MCP Servers**
3. Selecione **View raw config** para abrir o arquivo local `mcp_config.json`
4. Adicione a seguinte configuração:
```json
{
"mcpServers": {
"firecrawl": {
"command": "npx",
"args": ["-y", "firecrawl-mcp"],
"env": {
"FIRECRAWL_API_KEY": "YOUR_FIRECRAWL_API_KEY"
}
}
}
}
```
5. Salve o arquivo e clique em **Atualizar** na interface MCP do Antigravity para ver as novas ferramentas
Substitua `YOUR_FIRECRAWL_API_KEY` pela sua chave de API em [https://firecrawl.dev/app/api-keys](https://www.firecrawl.dev/app/api-keys).
## Executando no n8n [#executando-no-n8n]
Para conectar o servidor Firecrawl MCP ao n8n:
1. Obtenha sua chave de API do Firecrawl em [https://firecrawl.dev/app/api-keys](https://www.firecrawl.dev/app/api-keys)
2. No seu fluxo de trabalho do n8n, adicione um nó **AI Agent**
3. Na configuração do AI Agent, adicione uma nova **Tool**
4. Selecione **MCP Client Tool** como o tipo de ferramenta
5. Insira o endpoint do servidor MCP:
```
https://mcp.firecrawl.dev/v2/mcp
```
6. Defina **Server Transport** como **HTTP Streamable**
7. Escolha a autenticação:
* Defina **Authentication** como **Bearer** e cole sua chave de API do Firecrawl para acessar o conjunto completo de ferramentas MCP.
* Mantenha **Authentication** como **None** para o nível gratuito sem chave, que disponibiliza apenas Search, Scrape e Parse.
8. Em **Tools to include**, escolha **All**, **Selected** ou **All Except** entre as ferramentas disponibilizadas para seu modo de autenticação.
Para implantações auto-hospedadas, execute o servidor MCP com npx e habilite o modo de transporte HTTP:
```bash
env HTTP_STREAMABLE_SERVER=true \
FIRECRAWL_API_KEY=fc-YOUR_API_KEY \
FIRECRAWL_API_URL=YOUR_FIRECRAWL_INSTANCE \
npx -y firecrawl-mcp@3.23.0
```
Isso iniciará o servidor em `http://localhost:3000/mcp`, que você pode usar como endpoint no n8n. A variável de ambiente `HTTP_STREAMABLE_SERVER=true` é obrigatória, pois o n8n requer transporte HTTP.