Skip to main content

​
Requisitos previos

  • 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:

​
Ejecutar mediante stdio

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

​
Ejecutar con Streamable HTTP

Usa el transporte HTTP para clientes como n8n que se conectan a un MCP Server que ya está en ejecución:
Conecta el cliente a:
Confirma que el servidor esté listo:
La comprobación de estado devuelve ok. La ruta local es /mcp; /v2/mcp es la ruta alojada de Firecrawl.

​
Instalar globalmente

A continuación, ejecuta:

​
Configuración

​
Variables de entorno

​
API en la nube y autogestionada

  • 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)

​
Ejemplos de configuración

Para usar la API en la nube:
Para instancias autogestionadas:

​
Configuración personalizada con Claude Desktop

Añade lo siguiente a tu claude_desktop_config.json:

​
MCP alojado frente a MCP local

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.
El procesamiento directo de archivos locales con firecrawl_parse requiere que FIRECRAWL_API_URL apunte a una API de Firecrawl autogestionada. Un MCP Server local configurado únicamente con una clave de API en la nube no puede cargar un archivo local mediante esa herramienta.

​
Límites de tasa

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.