> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Recherche web et extraction MCP dans GitHub Copilot

> Ajoutez le scraping web et la recherche de Firecrawl à GitHub Copilot CLI, à Copilot dans VS Code et à l'agent de codage Copilot

Connectez [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli) ou [Copilot dans VS Code](https://code.visualstudio.com/docs/copilot/overview) à Firecrawl via le serveur MCP hébergé, puis connectez-vous avec votre compte Firecrawl. L'[agent de codage Copilot](#copilot-coding-agent), 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.

<h2 id="copilot-cli">
  Copilot CLI
</h2>

<h3 id="1-add-firecrawl">
  1. Ajouter Firecrawl
</h3>

```bash theme={null}
copilot mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp-oauth
```

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 :

```json ~/.copilot/mcp-config.json theme={null}
{
  "mcpServers": {
    "firecrawl": {
      "type": "http",
      "url": "https://mcp.firecrawl.dev/v2/mcp-oauth",
      "tools": ["*"]
    }
  }
}
```

<h3 id="2-sign-in-and-verify">
  2. Connexion et vérification
</h3>

```bash theme={null}
copilot
```

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é.

<h3 id="use-an-api-key-instead">
  Utiliser une clé API à la place
</h3>

Pour une utilisation sans intervention, [créez une clé API Firecrawl](https://www.firecrawl.dev/app/api-keys), 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 :

```bash theme={null}
copilot mcp add --transport http \
  --header "Authorization: Bearer $FIRECRAWL_API_KEY" \
  firecrawl https://mcp.firecrawl.dev/v2/mcp
```

La clé est stockée dans `~/.copilot/mcp-config.json` : veillez donc à exclure ce fichier du contrôle de version.

<h2 id="vs-code">
  VS Code
</h2>

<h3 id="1-add-firecrawl-2">
  1. Ajouter Firecrawl
</h3>

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 :

```json .vscode/mcp.json theme={null}
{
  "servers": {
    "firecrawl": {
      "type": "http",
      "url": "https://mcp.firecrawl.dev/v2/mcp-oauth"
    }
  }
}
```

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.

<h3 id="2-sign-in-and-verify-2">
  2. Se connecter et vérifier
</h3>

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.

<h3 id="use-an-api-key-instead-2">
  Utiliser plutôt une clé API
</h3>

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 :

```json .vscode/mcp.json theme={null}
{
  "inputs": [
    {
      "type": "promptString",
      "id": "firecrawl-api-key",
      "description": "Firecrawl API key",
      "password": true
    }
  ],
  "servers": {
    "firecrawl": {
      "type": "http",
      "url": "https://mcp.firecrawl.dev/v2/mcp",
      "headers": {
        "Authorization": "Bearer ${input:firecrawl-api-key}"
      }
    }
  }
}
```

<h2 id="copilot-coding-agent">
  Agent de codage Copilot
</h2>

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.

<h3 id="requirements">
  Prérequis
</h3>

* 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](https://www.firecrawl.dev/app/api-keys).

<h3 id="set-it-up">
  Configuration
</h3>

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** :

```json theme={null}
{
  "mcpServers": {
    "firecrawl": {
      "type": "http",
      "url": "https://mcp.firecrawl.dev/v2/mcp",
      "headers": {
        "Authorization": "Bearer $COPILOT_MCP_FIRECRAWL_API_KEY"
      },
      "tools": ["firecrawl_search", "firecrawl_scrape", "firecrawl_map"]
    }
  }
}
```

5. 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.

<Warning>
  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.
</Warning>

<h2 id="try-it">
  Essayer
</h2>

```text theme={null}
Recherche sur le Web les dernières notes de release de l'App Router de Next.js et résume les sources.
```

```text theme={null}
Extrais https://docs.firecrawl.dev et liste les sections de premier niveau.
```

Voir [choisir un outil](/fr/mcp-server/tools) pour la liste complète des outils de Firecrawl MCP.

<h2 id="troubleshooting">
  Dépannage
</h2>

* **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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.