Conecta Firecrawl a un cliente MCP con OAuth, una clave de API o una prueba sin clave.
Firecrawl MCP ofrece a los clientes de IA acceso a datos web en tiempo real mediante el Model Context Protocol. Usa el servidor alojado para configurarlo rápidamente o ejecuta el servidor de código abierto de forma local si necesitas un proceso local o una API de Firecrawl autogestionada.Esta página es la guía canónica para configurar Firecrawl MCP alojado.
Para un cliente interactivo, conéctate mediante OAuth. El cliente abrirá Firecrawl en tu navegador para que puedas iniciar sesión, seleccionar un equipo y autorizar el acceso sin copiar una clave de API.
Codex
Claude Desktop
Claude Code
Cursor
Otros clientes
Añade el servidor alojado y completa el inicio de sesión con OAuth:
Guarda el archivo, abre la configuración de MCP de Cursor y completa el inicio de sesión en Firecrawl. Cursor pondrá las herramientas de Firecrawl a disposición de Agent.
Configura un cliente MCP remoto compatible con OAuth para que use:
https://mcp.firecrawl.dev/v2/mcp-oauth
Si el cliente solicita un Client ID o Client Secret de OAuth, deja ambos campos en blanco. Los clientes compatibles usan Client ID Metadata Documents o Dynamic Client Registration.Si el cliente no puede completar OAuth remoto, usa la configuración con clave de API que aparece a continuación. Si no puede enviar cabeceras de solicitud, ejecuta Firecrawl MCP localmente.
Las conexiones OAuth reciben tokens de corta duración vinculados a recursos, en lugar de tu clave de API de Firecrawl. Puedes revisarlos y revocarlos desde la configuración de MCP.
Usa una clave de API para CI, servidores, scripts u otros clientes que no puedan completar el flujo OAuth en el navegador. Crea una clave de API de Firecrawl, guárdala en una variable de entorno o un almacén de secretos y conéctate al endpoint MCP alojado completo.
La configuración de la cabecera varía según el cliente. Guarda la clave en las variables de entorno del cliente o en un almacén de secretos protegido.
Nunca incluyas una clave de API en un archivo de configuración del proyecto, la pegues en un chat ni la compartas en una captura de pantalla o un issue. Las nuevas configuraciones deben usar OAuth o una cabecera Authorization respaldada por una variable de entorno, nunca una URL que incluya credenciales.
Para probar Firecrawl sin crear una cuenta, añade el endpoint sin clave a cualquier cliente compatible con MCP remoto:
https://mcp.firecrawl.dev/v2/mcp
El MCP sin clave está sujeto a límites de frecuencia por red y, mientras cumplas los requisitos, expone exactamente Search, Scrape y Parse. Conéctate mediante OAuth o una clave de API cuando necesites todas las herramientas de Firecrawl MCP o límites más altos.
¿Qué sucede cuando alcanzo el límite sin clave?
Cuando está disponible, el error del MCP incluye el tiempo actual de reintento. Espera ese intervalo para seguir usando el modo sin clave o conéctate de inmediato mediante OAuth o una clave de API.
Abre el estado de MCP o la lista de herramientas de tu cliente y confirma que firecrawl esté conectado. Una conexión sin clave muestra firecrawl_search, firecrawl_scrape y firecrawl_parse; una conexión autenticada puede ofrecer todas las herramientas de Firecrawl MCP, según el plan, la implementación y la política del equipo.Prueba una solicitud de solo lectura:
Busca en la web las notas de la última release de Firecrawl y resume las fuentes.
Si no aparece ninguna herramienta de Firecrawl, reinicia o recarga el cliente después de guardar la configuración de MCP. Si se produce un error de proceso local, como spawn npx ENOENT, consulta Ejecutar Firecrawl MCP localmente.
Este formato heredado solo existe para configuraciones y clientes existentes que no pueden completar OAuth ni enviar una cabecera Authorization personalizada. No es la configuración recomendada para nuevas integraciones.
La clave de API forma parte de la URL, así que trata la URL completa como si fuera una contraseña. Si queda expuesta, rota la clave. Esta alternativa solo se aplica a toda la superficie de /v2/mcp. No funciona con el recurso Search exclusivo de OAuth.
Conexiones OAuth existentes
Las conexiones OAuth existentes de /v2/mcp seguirán siendo compatibles durante la migración al endpoint de cuenta dedicado. Las nuevas conexiones interactivas de cuenta deben usar /v2/mcp-oauth; los nuevos tokens para ese recurso de cuenta no se aceptan en /v2/mcp.
