> ## 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 via MCP dans le Vercel AI SDK

> Connectez le client MCP du Vercel AI SDK au serveur MCP hébergé de Firecrawl pour la recherche web et le scraping

Connectez le client MCP du [Vercel AI SDK](https://ai-sdk.dev) au serveur MCP hébergé de Firecrawl et utilisez les outils de Firecrawl dans `generateText` et `streamText`.

<Note>
  Vous cherchez les outils Firecrawl sous forme d’outils AI SDK plutôt que via une connexion MCP ? Consultez le [guide Vercel AI SDK](/fr/developer-guides/llm-sdks-and-frameworks/vercel-ai-sdk).
</Note>

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

[Créez une clé API Firecrawl](https://www.firecrawl.dev/app/api-keys), puis installez l'AI SDK et son package MCP :

```bash theme={null}
npm install ai @ai-sdk/mcp
export FIRECRAWL_API_KEY="fc-YOUR-API-KEY"
```

Créez le client avec le transport HTTP, en plaçant votre clé dans l'en-tête `Authorization` :

```typescript theme={null}
import { createMCPClient } from '@ai-sdk/mcp';

const mcpClient = await createMCPClient({
  transport: {
    type: 'http',
    url: 'https://mcp.firecrawl.dev/v2/mcp',
    headers: { Authorization: `Bearer ${process.env.FIRECRAWL_API_KEY}` },
  },
});

const tools = await mcpClient.tools();
console.log(Object.keys(tools));
```

La liste comprend `firecrawl_scrape`, `firecrawl_search`, `firecrawl_map` et `firecrawl_crawl`. Passez `tools` à `generateText` ou `streamText` comme indiqué dans le [guide MCP de l'AI SDK](https://ai-sdk.dev/docs/ai-sdk-core/mcp-tools), puis fermez le client avec `await mcpClient.close()` une fois la réponse terminée.

Vous préférez un processus local ? Utilisez le transport stdio de l'AI SDK avec `npx -y firecrawl-mcp` et `FIRECRAWL_API_KEY` dans `env` ; l'AI SDK recommande toutefois HTTP en production.

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

Appelez directement un outil pour vérifier la connexion :

```typescript theme={null}
const result = await tools.firecrawl_scrape.execute(
  { url: 'https://firecrawl.dev', formats: ['markdown'], onlyMainContent: true },
  { toolCallId: 'test', messages: [] },
);
console.log(result.content[0].text.slice(0, 300));
await mcpClient.close();
```

Fournissez ensuite les outils à un modèle avec un prompt comme celui-ci :

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

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

* **Erreurs d'authentification :** vérifiez que `FIRECRAWL_API_KEY` est bien défini dans le processus qui exécute le client et que l'en-tête a la forme `Bearer <key>`.
* **Erreurs de redirection :** par défaut, le client AI SDK refuse les redirections ; utilisez l'URL exacte `https://mcp.firecrawl.dev/v2/mcp`.
* **Handles restés ouverts à la fin d'un script :** appelez `mcpClient.close()` une fois que vous n'avez plus besoin des outils.


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