Skip to main content

​
Se connecter avec OAuth

https://mcp.firecrawl.dev/v2/mcp-oauth est une URL de serveur destinée à votre client MCP. Il ne s’agit pas d’une page à ouvrir directement dans un navigateur. Votre client lance le flux de connexion dans le navigateur.
Utilisez OAuth lorsqu’une personne est présente pour se connecter, choisir une équipe Firecrawl et approuver l’accès. Le client reçoit des jetons pour cette connexion au lieu de vous demander de copier une clé API Firecrawl dans la conversation. La page de connexion vous demande de choisir une équipe et d’approuver la connexion. Si le client vous demande un ID client OAuth ou un secret client, laissez les deux champs vides. Les clients compatibles s’identifient automatiquement. Les requêtes effectuées via cette connexion utilisent l’équipe sélectionnée. Vous pouvez consulter ou révoquer la connexion depuis les paramètres MCP. Vous avez besoin d’une connexion sans intervention ? Utilisez la configuration par clé API. Ne collez pas la clé dans une conversation avec un agent et ne l’insérez pas dans l’URL MCP.

​
Vérifiez la connexion

Démarrez une nouvelle session client, puis essayez :
Si aucun outil Firecrawl n’apparaît, ouvrez l’état MCP du client, vérifiez que firecrawl est authentifié et qu’une seule entrée de serveur Firecrawl est active.

​
Basculer une connexion keyless existante

Mettez à jour ou remplacez le serveur firecrawl existant par l’URL du serveur OAuth. N’ajoutez pas de deuxième entrée Firecrawl. Après cette modification, démarrez une nouvelle session client avant de réessayer la requête.

​
Codex

Exécutez :
Codex remplace le serveur existant du même nom. Saisissez /mcp et vérifiez que firecrawl est connecté.

​
Claude Code

Claude Code n’écrase pas un serveur existant portant le même nom. Supprimez l’entrée actuelle, puis ajoutez l’entrée OAuth :
Ouvrez /mcp dans Claude Code et connectez-vous via le navigateur.

​
Autres clients

Modifiez le serveur firecrawl existant et définissez son URL sur :
Enregistrez la configuration, terminez la connexion initiée par le client, puis ouvrez une nouvelle session cliente.

​
Détails de compatibilité et de sécurité

Les jetons OAuth existants émis pour /v2/mcp restent pris en charge par ce point de terminaison. Les nouvelles connexions interactives utilisent /v2/mcp-oauth, et les jetons émis pour cette ressource de compte ne sont pas acceptés par /v2/mcp.
Firecrawl utilise le flux OAuth avec code d’autorisation et PKCE. Les clients compatibles peuvent s’identifier à l’aide d’un document de métadonnées d’ID client ou de l’enregistrement dynamique des clients, et n’ont donc pas besoin de secret client.Firecrawl accepte les URI de redirection HTTPS et les redirections loopback sur localhost, 127.0.0.1 ou [::1]. Pour un client natif utilisant une redirection loopback, le port peut changer d’une exécution à l’autre. Le reste de l’URI de redirection enregistrée doit correspondre exactement.
Les jetons d’accès expirent après une heure. Les jetons de rafraîchissement sont renouvelés après un rafraîchissement réussi. Chaque connexion est associée à son client OAuth, son utilisateur, son équipe, sa portée et sa ressource MCP.Un nouveau jeton émis pour /v2/mcp-oauth n’est pas accepté par /v2/mcp. Les jetons dont l’audience est absente ou ambiguë sont refusés par défaut.
Ouvrez MCP dans les paramètres Firecrawl, puis révoquez la connexion. La révocation invalide ses jetons d’accès et de rafraîchissement. Reconnectez-vous depuis le client pour l’autoriser à nouveau.
Les requêtes effectuées via une connexion consomment les crédits de l’équipe sélectionnée lors de la connexion, conformément à l’offre de cette équipe. Chaque connexion est répertoriée dans les paramètres MCP, où elle peut être consultée et révoquée à tout moment. Pour le SSO et les contrôles à l’échelle de l’organisation, consultez Enterprise.

​
Ressources supplémentaires

Comparer les options de connexion

Retournez au sélecteur de configuration MCP.

Choisir un outil

Consultez l’ensemble des outils disponibles dans Firecrawl MCP.