Connectez Firecrawl à un client MCP avec OAuth, une clé API ou un essai sans clé.
Firecrawl MCP permet aux clients IA d’accéder à des données web en temps réel via le Model Context Protocol. Utilisez le serveur hébergé pour une configuration plus rapide, ou exécutez localement le serveur open source si vous avez besoin d’un processus local ou d’une API Firecrawl auto-hébergée.Cette page constitue le guide de configuration de référence pour Firecrawl MCP hébergé.
Pour un client interactif, connectez-vous via OAuth. Le client ouvre Firecrawl dans votre navigateur afin que vous puissiez vous connecter, choisir une équipe et autoriser l’accès sans avoir à copier de clé API.
Codex
Claude Desktop
Claude Code
Cursor
Autres clients
Ajoutez le serveur hébergé et terminez la connexion OAuth :
Enregistrez le fichier, ouvrez les paramètres MCP de Cursor et terminez la connexion à Firecrawl. Cursor met ensuite les outils Firecrawl à la disposition de l’Agent.
Configurez un client MCP distant compatible OAuth avec l’URL suivante :
https://mcp.firecrawl.dev/v2/mcp-oauth
Si le client demande un Client ID ou un Client Secret OAuth, laissez les deux champs vides. Les clients compatibles utilisent des documents de métadonnées Client ID ou l’enregistrement dynamique des clients.Si le client ne peut pas effectuer OAuth à distance, utilisez la configuration par clé API ci-dessous. S’il ne peut pas envoyer d’en-têtes de requête, exécutez Firecrawl MCP localement.
Les connexions OAuth reçoivent des jetons de courte durée liés à une ressource, plutôt que votre clé API Firecrawl. Vous pouvez les consulter et les révoquer dans les paramètres MCP.
Utilisez une clé API pour l’intégration continue, les serveurs, les scripts ou tout autre client ne pouvant pas effectuer OAuth dans le navigateur. Créez une clé API Firecrawl, stockez-la dans une variable d’environnement ou un gestionnaire de secrets, puis connectez-vous au point de terminaison MCP hébergé complet.
La configuration de l’en-tête varie selon le client. Conservez la clé dans l’environnement du client ou dans un stockage de secrets protégé.
Ne placez jamais une clé API dans un fichier de configuration de projet, ne la collez pas dans une discussion et ne la partagez pas dans un screenshot ou un ticket. Les nouvelles configurations doivent utiliser OAuth ou un en-tête Authorization basé sur une variable d’environnement, jamais une URL contenant des identifiants.
Pour essayer Firecrawl sans créer de compte, ajoutez le point de terminaison sans clé à n’importe quel client prenant en charge MCP à distance :
https://mcp.firecrawl.dev/v2/mcp
Le MCP sans clé est soumis à des limites de débit par réseau et donne accès uniquement à Recherche, Scrape et Parse tant que vous y êtes éligible. Connectez-vous via OAuth ou avec une clé API si vous avez besoin de l’ensemble complet d’outils ou de limites plus élevées.
Que se passe-t-il lorsque j’atteins la limite du mode sans clé ?
Lorsqu’il est disponible, le message d’erreur MCP indique le délai avant de pouvoir réessayer. Attendez ce délai pour continuer à utiliser le mode sans clé, ou connectez-vous immédiatement via OAuth ou avec une clé API.
Ouvrez l’état MCP ou la liste des outils de votre client et vérifiez que firecrawl est connecté. Une connexion sans clé affiche firecrawl_search, firecrawl_scrape et firecrawl_parse ; une connexion authentifiée peut donner accès à l’ensemble complet des outils, selon l’offre, le déploiement et la politique de l’équipe.Essayez une requête en lecture seule :
Recherche sur le web les dernières notes de version de Firecrawl et résume les sources.
Si aucun outil Firecrawl n’apparaît, redémarrez ou rechargez le client après avoir enregistré sa configuration MCP. En cas d’erreur de processus local, par exemple spawn npx ENOENT, consultez Exécuter Firecrawl MCP localement.
Ce format hérité est uniquement destiné aux configurations et clients existants qui ne peuvent pas effectuer OAuth ni envoyer un en-tête Authorization personnalisé. Il n’est pas recommandé pour les nouvelles intégrations.
La clé API fait partie de l’URL : traitez donc l’URL complète comme un mot de passe. Si elle est exposée, effectuez une rotation de la clé. Cette solution de repli s’applique uniquement à l’ensemble de la surface /v2/mcp. Elle ne fonctionne pas pour la ressource de recherche réservée à OAuth.
Connexions OAuth existantes
Les connexions OAuth existantes à /v2/mcp restent prises en charge pendant la migration vers le point de terminaison dédié au compte. Les nouvelles connexions de compte interactives doivent utiliser /v2/mcp-oauth ; les nouveaux jetons pour cette ressource de compte ne sont pas acceptés par /v2/mcp.
