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 et utilisez les outils de Firecrawl dans generateText et streamText.

Vous cherchez les outils Firecrawl sous forme d’outils AI SDK plutôt que via une connexion MCP ? Consultez le guide Vercel AI SDK.

Configuration rapide

Créez une clé API Firecrawl, puis installez l’AI SDK et son package MCP :

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 :

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

Essayez

Appelez directement un outil pour vérifier la connexion :

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 :

Recherche sur le Web les dernières notes de version de Next.js et résume les sources.

Dépannage

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.

Prise en main

Outils d’IA

Intégrations pour agent

Clients et passerelles MCP

SDK et frameworks LLM

Débogage agentique

Recueils de recettes

Recherche web et extraction via MCP dans le Vercel AI SDK

Configuration rapide

Essayez

Dépannage

​Configuration rapide

​Essayez

​Dépannage

Configuration rapide

Essayez

Dépannage