Skip to main content
Connectez GitHub Copilot CLI ou Copilot dans VS Code à Firecrawl via le serveur MCP hébergé, puis connectez-vous avec votre compte Firecrawl. L’agent de codage Copilot, lui, se connecte à l’aide d’une clé API. Les URL de serveur ci-dessous sont des valeurs à renseigner dans la configuration du client : il ne s’agit pas de pages à ouvrir directement dans un navigateur.

Copilot CLI

  1. Ajouter Firecrawl

Cette commande ajoute le serveur à ~/.copilot/mcp-config.json. Vous pouvez également exécuter /mcp add dans une session interactive et choisir le type HTTP, ou modifier directement le fichier :
~/.copilot/mcp-config.json

  1. Connexion et vérification

Lors de la première connexion, Copilot CLI ouvre la page de connexion Firecrawl dans votre navigateur : choisissez une équipe, puis approuvez la connexion. Saisissez /mcp pour vérifier que firecrawl est bien connecté.

Utiliser une clé API à la place

Pour une utilisation sans intervention, créez une clé API Firecrawl, exportez-la sous le nom FIRECRAWL_API_KEY, puis ajoutez le point de terminaison prévu pour l’authentification par clé API, avec un en-tête bearer :
La clé est stockée dans ~/.copilot/mcp-config.json : veillez donc à exclure ce fichier du contrôle de version.

VS Code

  1. Ajouter Firecrawl

Exécutez MCP: Add Server depuis la palette de commandes et choisissez HTTP, ou créez le fichier .vscode/mcp.json dans votre espace de travail :
.vscode/mcp.json
Pour rendre le serveur disponible dans tous vos espaces de travail, exécutez MCP: Open User Configuration et ajoutez-y la même entrée.

  1. Se connecter et vérifier

Démarrez le serveur depuis l’éditeur mcp.json ou avec MCP: List Servers. Lorsque VS Code vous demande de vous authentifier, autorisez l’accès et finalisez la connexion à Firecrawl dans votre navigateur. Ouvrez ensuite Copilot Chat en mode Agent et cliquez sur l’icône des outils pour vérifier que les outils de Firecrawl figurent bien dans la liste.

Utiliser plutôt une clé API

Utilisez le point de terminaison avec clé API et laissez VS Code vous demander la clé : elle sera ainsi stockée de manière sécurisée au lieu d’être écrite en clair dans le fichier :
.vscode/mcp.json

Agent de codage Copilot

L’agent de codage Copilot (également appelé agent cloud Copilot) traite les issues et les pull requests sur GitHub. Ses paramètres MCP au niveau du dépôt ne prennent pas en charge les serveurs distants utilisant OAuth : cette configuration stocke donc une clé API Firecrawl en tant que secret Agents et l’envoie dans un en-tête.

Prérequis

  • Une offre GitHub Copilot payante, avec l’agent de codage activé pour le dépôt.
  • Un accès administrateur au dépôt, nécessaire pour modifier les paramètres MCP et les secrets Agents.
  • Une clé API Firecrawl.

Configuration

  1. Dans votre dépôt, ouvrez Settings, puis Secrets and variables, puis Agents.
  2. Sélectionnez New repository secret, nommez-le COPILOT_MCP_FIRECRAWL_API_KEY, collez votre clé API Firecrawl, puis enregistrez. Copilot ne transmet aux serveurs MCP que les secrets Agents dont le nom commence par COPILOT_MCP_.
  3. Ouvrez Settings, puis Copilot, puis MCP servers.
  4. Collez cette configuration dans MCP configuration, puis sélectionnez Save MCP configuration :
  1. Assignez un ticket à Copilot. Lorsque sa pull request apparaît, choisissez View session, ouvrez l’étape Start MCP Servers dans le journal, puis vérifiez que les outils Firecrawl y figurent.
Copilot utilise les outils de la liste tools sans demander d’approbation. Limitez cette liste aux seuls outils dont l’agent a besoin. N’utilisez "*" que si vous souhaitez mettre à disposition tous les outils Firecrawl.

Essayer

Voir choisir un outil pour la liste complète des outils de Firecrawl MCP.

Dépannage

  • Les outils n’apparaissent pas : vérifiez qu’un seul serveur firecrawl est configuré, puis redémarrez Copilot CLI, ou exécutez MCP: List Servers dans VS Code et redémarrez le serveur.
  • La connexion est à nouveau demandée ou renvoie 401 : redémarrez le serveur et finalisez la connexion dans le navigateur. Il est normal qu’une requête brute vers le serveur OAuth renvoie 401 avant l’authentification.
  • Une connexion par clé API renvoie 401 : vérifiez que l’URL est bien https://mcp.firecrawl.dev/v2/mcp (et non /v2/mcp-oauth) et que l’en-tête est Authorization: Bearer <FIRECRAWL_API_KEY>.
  • Stratégie d’organisation : si votre organisation GitHub restreint les serveurs MCP dans Copilot, un administrateur doit autoriser Firecrawl pour que la connexion soit possible.
  • Agent de codage : les outils Firecrawl n’apparaissent pas dans le journal de session : vérifiez que le nom du secret est exactement COPILOT_MCP_FIRECRAWL_API_KEY et qu’il s’agit bien d’un secret Agents, et non d’un secret Actions.