Vue d’ensemble
Le serveur MCP de Web2MD expose Web2MD comme un ensemble d’outils que les assistants IA peuvent appeler directement, grâce au Model Context Protocol (MCP) — un standard ouvert pour connecter les modèles IA à des outils et sources de données externes. Une fois configuré, vous pouvez demander à Claude, Cursor ou Windsurf de convertir des pages, de rechercher dans votre historique de conversions, ou de récupérer du Markdown sauvegardé, sans quitter la conversation.Le serveur MCP nécessite une clé API Web2MD (plan PRO). Générez-en une depuis le tableau de bord.
Outils disponibles
Le serveur MCP fournit trois outils :convert_url
Récupère une URL et retourne le contenu de la page sous forme de Markdown. Prend en charge les mêmes options de conversion que l’API REST. Exemple de requête : « Convertis cette URL en markdown : https://docs.example.com/getting-started »semantic_search
Recherche dans toutes vos conversions précédemment sauvegardées à l’aide d’une requête en langage naturel. Retourne une liste de conversions correspondantes avec titres, URL et scores de pertinence. Exemple de requête : « Cherche dans mes pages sauvegardées des articles sur l’indexation de bases de données »get_conversion
Récupère le contenu Markdown complet d’une conversion sauvegardée spécifique via son ID. Utile pour ramener un document complet dans le contexte après l’avoir trouvé avecsemantic_search.
Exemple de requête : « Récupère le contenu complet de la conversion abc123 »
Configuration
- Claude Desktop
- Cursor
- Windsurf
Ouvrez votre fichier de configuration Claude Desktop :Redémarrez Claude Desktop. Les outils Web2MD devraient apparaître dans le sélecteur d’outils.
- macOS :
~/Library/Application Support/Claude/claude_desktop_config.json - Windows :
%APPDATA%\Claude\claude_desktop_config.json
web2md sous mcpServers :Exemples d’utilisation
Une fois le serveur MCP en cours d’exécution, vous pouvez utiliser le langage naturel dans votre assistant IA :Convertir une page en Markdown
Convertir une page en Markdown
Vous : Convertis cette URL en markdown : https://react.dev/learn/thinking-in-reactAssistant : (appelle
convert_url) Voici le Markdown converti pour « Thinking in React »…Rechercher dans les conversions sauvegardées
Rechercher dans les conversions sauvegardées
Vous : Cherche dans mes pages sauvegardées tout ce qui concerne l’authentificationAssistant : (appelle
semantic_search) J’ai trouvé 3 conversions sauvegardées liées à l’authentification :- « OAuth 2.0 Guide » — sauvegardée il y a 2 jours
- « JWT Best Practices » — sauvegardée la semaine dernière
- …
Récupérer une conversion complète
Récupérer une conversion complète
Vous : Récupère le contenu complet de la conversion abc123Assistant : (appelle
get_conversion) Voici le contenu Markdown complet…Dépannage
Les outils n'apparaissent pas après la configuration
Les outils n'apparaissent pas après la configuration
Assurez-vous d’avoir redémarré l’application après avoir modifié le fichier de configuration. Vérifiez que
npx web2md-mcp s’exécute correctement dans votre terminal.Erreurs d'authentification
Erreurs d'authentification
Vérifiez que votre
WEB2MD_API_KEY est correcte et que votre abonnement PRO est actif. Vous pouvez vérifier votre clé sur la page des clés API.npx ne parvient pas à résoudre le package
npx ne parvient pas à résoudre le package
Essayez d’abord d’installer le package globalement :
npm install -g web2md-mcp, puis changez command en web2md-mcp et supprimez le champ args.