Ejecutar Firecrawl MCP localmente

• Node.js 22 o una versión posterior
• npm y npx, incluidos con Node.js
• Una clave de API de Firecrawl para la API en la nube o una URL de una API de Firecrawl autogestionada

Confirma la versión de Node.js instalada:

node --version

env FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y [email protected]

Este es el transporte predeterminado para los clientes que ejecutan el MCP Server como proceso local.

Usa el transporte HTTP para clientes como n8n que se conectan a un MCP Server que ya está en ejecución:

env HTTP_STREAMABLE_SERVER=true \
  FIRECRAWL_API_KEY=fc-YOUR_API_KEY \
  npx -y [email protected]

Conecta el cliente a:

http://localhost:3000/mcp

Confirma que el servidor esté listo:

curl http://localhost:3000/health

La comprobación de estado devuelve ok. La ruta local es /mcp; /v2/mcp es la ruta alojada de Firecrawl.

npm install -g [email protected]

A continuación, ejecuta:

env FIRECRAWL_API_KEY=fc-YOUR_API_KEY firecrawl-mcp

• FIRECRAWL_API_KEY: Tu clave de API de Firecrawl
  • Obligatoria al utilizar la API en la nube (predeterminada)
  • Opcional al utilizar una instancia autogestionada con FIRECRAWL_API_URL
• FIRECRAWL_API_URL (Opcional): Endpoint de API personalizado para instancias autogestionadas
  • Ejemplo: https://firecrawl.your-domain.com
  • Si no se proporciona, se utilizará la API en la nube (requiere una clave de API)

Para usar la API en la nube:

export FIRECRAWL_API_KEY=your-api-key

Para instancias autogestionadas:

export FIRECRAWL_API_URL=https://firecrawl.your-domain.com
export FIRECRAWL_API_KEY=your-api-key  # Si tu instancia requiere autenticación

Añade lo siguiente a tu claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-server-firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

El MCP Server alojado está optimizado para un uso remoto seguro. Algunas opciones disponibles al ejecutar el MCP Server localmente son más limitadas o no están disponibles de forma remota:

• El modo alojado sin clave expone únicamente Search, Scrape y Parse y está sujeto a límites de tasa por IP.
• La lectura de archivos locales solo está disponible al ejecutar el MCP Server localmente.
• Los Webhooks y las rutas de archivos locales deben configurarse desde un MCP Server local o autogestionado cuando el agent necesite acceder a recursos locales.

Firecrawl aplica límites de tasa. Usa una clave de API para obtener límites más altos y acceder al conjunto completo de herramientas.