Skip to main content

Conectarse con OAuth

https://mcp.firecrawl.dev/v2/mcp-oauth es una URL de servidor para tu cliente MCP. No es una página que debas abrir directamente en un navegador. Tu cliente inicia el flujo de inicio de sesión en el navegador.
Usa OAuth cuando haya una persona disponible para iniciar sesión, seleccionar un equipo de Firecrawl y aprobar el acceso. El cliente recibe tokens para esa conexión en lugar de pedirte que copies una clave de la API de Firecrawl en la conversación. La página de inicio de sesión te pide que selecciones un equipo y apruebes la conexión. Si el cliente solicita un OAuth Client ID o Client Secret, deja ambos en blanco. Los clientes compatibles se identifican automáticamente. Las solicitudes realizadas mediante esta conexión usan el equipo seleccionado. Puedes revisar o revocar la conexión desde configuración de MCP. ¿Necesitas una conexión sin supervisión? Usa la configuración con clave de API. No pegues la clave en una conversación con un agente ni la incluyas en la URL de MCP.

Verifica la conexión

Inicia una nueva sesión de cliente y, a continuación, prueba:
Si no aparece ninguna herramienta de Firecrawl, abre el estado de MCP del cliente, confirma que firecrawl esté autenticado y verifica que solo haya una entrada de servidor Firecrawl activa.

Cambia una conexión sin clave existente

Actualiza o reemplaza el servidor firecrawl existente por la URL del servidor OAuth. No añadas una segunda entrada de Firecrawl. Después del cambio, inicia una nueva sesión de cliente antes de volver a intentar la solicitud.

Codex

Ejecuta:
Codex reemplaza el servidor existente con el mismo nombre. Escribe /mcp y confirma que firecrawl esté conectado.

Claude Code

Claude Code no sobrescribe un servidor existente con el mismo nombre. Elimina la entrada actual y, a continuación, añade la entrada de OAuth:
Abre /mcp en Claude Code y completa el inicio de sesión en el navegador.

Otros clientes

Edita el servidor firecrawl existente y configura su URL como sigue:
Guarda la configuración, completa el inicio de sesión iniciado por el cliente y abre una nueva sesión de cliente.

Detalles de compatibilidad y seguridad

Los tokens OAuth existentes emitidos para /v2/mcp siguen siendo compatibles con ese endpoint. Las nuevas conexiones interactivas usan /v2/mcp-oauth, y los tokens emitidos para ese recurso de cuenta no se aceptan en /v2/mcp.
Firecrawl utiliza el Código de autorización de OAuth con PKCE. Los clientes compatibles pueden identificarse mediante un documento de metadatos de ID de cliente o el Registro dinámico de clientes, por lo que no necesitan un secreto de cliente.Firecrawl acepta URI de redireccionamiento HTTPS y redireccionamientos de loopback en localhost, 127.0.0.1 o [::1]. En el caso de un cliente nativo que use un redireccionamiento de loopback, el puerto puede cambiar entre ejecuciones. El resto de la URI de redireccionamiento registrada debe coincidir exactamente.
Los tokens de acceso caducan al cabo de una hora. Los tokens de actualización rotan tras una actualización correcta. Cada conexión está vinculada a su cliente OAuth, usuario, equipo, alcance y recurso MCP.Un token nuevo emitido para /v2/mcp-oauth no se acepta en /v2/mcp. Los tokens con una audiencia ausente o ambigua se rechazan de forma segura.
Abre MCP en la configuración de Firecrawl y revoca la conexión. La revocación invalida sus tokens de acceso y actualización. Vuelve a conectarte desde el cliente para autorizarla de nuevo.
Las solicitudes realizadas mediante una conexión consumen los créditos del equipo seleccionado durante el inicio de sesión, conforme al plan de ese equipo. Cada conexión aparece en la configuración de MCP, donde puede revisarse y revocarse en cualquier momento. Para controles de SSO y para toda la organización, consulta Enterprise.

Más recursos

Comparar opciones de conexión

Vuelve al selector de configuración de MCP.

Seleccionar una herramienta

Consulta todas las herramientas de Firecrawl MCP.