Ejecuta Firecrawl MCP localmente cuando un cliente necesite iniciar un proceso local, cuando necesites un transporte HTTP local o cuando el MCP Server deba conectarse a una API de Firecrawl autogestionada. Para el servicio gestionado, comienza con Primeros pasos.
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:
Inicia el servidor#
Usa stdio cuando el cliente MCP inicie Firecrawl como proceso local:
Configura el cliente para ejecutar npx -y firecrawl-mcp@3.23.7 y proporciona FIRECRAWL_API_KEY mediante el entorno protegido o el mecanismo de secretos del cliente.
Usa HTTP cuando un cliente como n8n se conecte a un servidor 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 corresponde al servicio alojado de Firecrawl.
Configura la API de Firecrawl#
| Variable de entorno | Finalidad |
|---|---|
FIRECRAWL_API_KEY | Autentica en la API en la nube de Firecrawl. Solo es opcional si una API autogestionada no requiere autenticación. |
FIRECRAWL_API_URL | Envía solicitudes a una API de Firecrawl autogestionada en lugar de a la API en la nube. |
HTTP_STREAMABLE_SERVER | Establécela en true para iniciar el transporte HTTP Streamable local en lugar de stdio. |
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 conectado únicamente a la API en la nube no puede cargar un archivo local mediante esa herramienta; en su lugar, el servidor alojado usa una transferencia de carga firmada.
Instalar globalmente#
Usa npx para una configuración más rápida. Para instalar globalmente la misma versión revisada:
A continuación, ejecuta:
Solución de problemas#
El cliente muestra el error spawn npx ENOENT
Instala Node.js 22 o una versión posterior, confirma que npx esté en el PATH del cliente y reinícialo por completo. En Windows, ejecuta where npx en el símbolo del sistema y configura el cliente para que use la ruta devuelta de npx.cmd.
El cliente HTTP no puede conectarse
Confirma que HTTP_STREAMABLE_SERVER=true y, a continuación, llama a http://localhost:3000/health. Usa http://localhost:3000/mcp como endpoint del cliente, no la ruta alojada /v2/mcp.
Una herramienta no está disponible
La disponibilidad de las herramientas depende de los servicios de Firecrawl habilitados en la implementación de destino. Compara la conexión en Herramientas y revisa la salida del proceso local en busca de errores de registro o autenticación.
El servidor está sujeto a límites de tasa
Los límites de tasa los aplica la API de Firecrawl conectada. Revisa los límites de tasa actuales y los límites configurados para una implementación autogestionada.