> ## 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 avec les agents OpenAI

> Dotez les modèles OpenAI des fonctionnalités de recherche web et de scraping de Firecrawl grâce à l’outil MCP de l’API Responses

Connectez les modèles OpenAI à Firecrawl en ajoutant le serveur MCP hébergé en tant qu'outil `mcp` distant dans l'API Responses. OpenAI récupère la liste des outils Firecrawl, que le modèle appelle ensuite pour effectuer des recherches sur le web et lire des pages.

<Note>
  D'après la documentation d'OpenAI, l'arrêt d'Agent Builder est prévu pour le 30 novembre 2026. L'outil MCP distant présenté sur cette page ne dépend pas d'Agent Builder.
</Note>

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

* Une clé API OpenAI dans `OPENAI_API_KEY` et le package Python `openai`.
* Une [clé API Firecrawl](https://www.firecrawl.dev/app/api-keys) dans `FIRECRAWL_API_KEY`.

<h2 id="quick-setup">
  Configuration rapide
</h2>

Ajoutez le serveur Firecrawl à la liste `tools`. Le champ `authorization` contient votre clé API Firecrawl, tandis que `allowed_tools` restreint les outils que le modèle peut appeler :

```python theme={null}
import os
from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="gpt-6-astra",
    tools=[
        {
            "type": "mcp",
            "server_label": "firecrawl",
            "server_description": "Search the web and read pages as Markdown.",
            "server_url": "https://mcp.firecrawl.dev/v2/mcp",
            "authorization": os.environ["FIRECRAWL_API_KEY"],
            "allowed_tools": ["firecrawl_search", "firecrawl_scrape"],
            "require_approval": "never",
        }
    ],
    input="Search the web for the latest Next.js release notes and summarize the sources.",
)

print(response.output_text)
```

OpenAI ne conserve pas la valeur `authorization` : vous devez donc l’envoyer à chaque requête. Définissez `require_approval` sur `"always"` si vous souhaitez vérifier chaque appel d’outil avant que les données ne soient envoyées au serveur.

Voir [Configurer une clé API](/fr/mcp-server/keyless#add-an-api-key) pour en savoir plus sur les connexions par clé. Avec cette configuration, votre code n’effectue aucun appel direct à l’API Firecrawl, car OpenAI se connecte au serveur MCP à votre place.

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

```text theme={null}
Recherche sur le Web les dernières notes de release de TypeScript et fais une synthèse des sources.
```

```text theme={null}
Extrais le contenu de https://firecrawl.dev et explique ce que fait ce site.
```

<h2 id="what-you-can-do">
  Ce que vous pouvez faire
</h2>

<CardGroup cols={2}>
  <Card title="Recherche" icon="magnifying-glass" href="/fr/features/search">
    Trouvez des informations à jour et consultez le contenu des résultats pertinents.
  </Card>

  <Card title="Extraction" icon="file-lines" href="/fr/features/scrape">
    Convertissez des URL en markdown propre ou en données structurées.
  </Card>

  <Card title="Interact" icon="hand-pointer" href="/fr/features/interact">
    Naviguez, cliquez et remplissez des formulaires pour accéder aux données dont vous avez besoin.
  </Card>

  <Card title="Alexandria" icon="books" href="/fr/features/alexandria">
    Découvrez des outils de données structurées, consultez leurs paramètres d'entrée et leur tarification, puis exécutez-les via Firecrawl.
  </Card>
</CardGroup>

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

* **La requête échoue lors de la récupération de la liste des outils :** vérifiez que `server_url` vaut exactement `https://mcp.firecrawl.dev/v2/mcp` et que `FIRECRAWL_API_KEY` est défini dans l'environnement qui exécute le script.
* **Le serveur renvoie `401` :** remplacez la clé et renvoyez la requête, car OpenAI ne conserve pas la valeur `authorization` d'une requête à l'autre.
* **Un outil est manquant :** ajoutez son nom à `allowed_tools`, ou supprimez `allowed_tools` pour importer tous les outils exposés par le serveur.
* **Le modèle répond sans utiliser Firecrawl :** indiquez le nom de l'outil dans votre prompt, par exemple « Utilise firecrawl\_search pour trouver... ».


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