Serveur MCP

Vue d’ensemble

Le serveur MCP de Web2MD expose Web2MD sous forme d’un ensemble d’outils que les assistants IA peuvent appeler directement, via le Model Context Protocol (MCP) — un standard ouvert pour connecter des 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 et synchroniser votre Bibliothèque, de convertir en lot avec l’extension Chrome, ou de récupérer un Skill enregistré — 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, ou exécutez npx web2md-cli login pour vous authentifier une fois et partager automatiquement la clé avec le CLI (voir Authentification ci-dessous).

Outils disponibles

Le serveur MCP fournit 11 outils, regroupés par fonction :

Outil	Description
`convert_url`	Convertit n’importe quelle URL en Markdown propre via le convertisseur côté serveur
`bridge_convert_url`	Convertit une URL via votre extension Chrome en HTTP — pour Reddit, les pages rendues en JS ou protégées par connexion
`agent_convert`	Convertit une URL via l’extension Chrome par messagerie native (mêmes cas d’usage que `bridge_convert_url`, transport différent)
`agent_batch_convert`	Convertit en lot jusqu’à 50 URL via l’extension Chrome par messagerie native
`search_library`	Recherche dans votre Bibliothèque enregistrée par mot-clé et/ou tag
`get_library_items`	Récupère le Markdown complet des éléments de la Bibliothèque par id
`sync_library`	Synchronise votre Bibliothèque vers un répertoire local sous forme de fichiers Markdown
`list_skills`	Liste les Skills enregistrés dans votre compte cloud Web2MD
`get_skill`	Récupère le contenu complet d’un Skill par id ou par nom
`semantic_search`	Déprécié — utilisez `search_library` + `get_library_items` à la place
`get_conversion`	Déprécié — utilisez `search_library` + `get_library_items` à la place

convert_url

Récupère une URL côté serveur et renvoie le contenu de la page en Markdown, avec le titre, le nombre de mots et le temps de lecture. Prend en charge les mêmes options de conversion que l’API REST (includeImages, includeLinks). Exemple de prompt : « Convertis cette URL en markdown : https://docs.example.com/getting-started »

bridge_convert_url

Convertit une URL en récupérant son HTML via votre extension Chrome en cours d’exécution (via un pont HTTP local), puis en convertissant ce HTML en Markdown côté serveur. Utilisez ceci pour les pages que le serveur ne peut pas atteindre directement — Reddit, les sites protégés par connexion, ou les pages fortement rendues en JS. Nécessite que Chrome soit ouvert avec l’extension Web2MD installée ; l’ID de l’extension est découvert automatiquement à partir de votre clé API. Exemple de prompt : « Utilise le bridge pour convertir ce fil Reddit : https://reddit.com/r/… »

agent_convert

Convertit une URL de la même manière que bridge_convert_url — via votre extension Chrome — mais via le canal de messagerie native Agent Bridge au lieu de HTTP. Accepte un paramètre optionnel skill : passez un id ou un nom de Skill et son contenu est ajouté au Markdown renvoyé, afin que l’agent puisse agir dessus immédiatement. Nécessite que Chrome soit en cours d’exécution avec l’extension et l’hôte natif installés. Exemple de prompt : « Convertis cette page en appliquant le skill summarize : https://… »

agent_batch_convert

Même transport que agent_convert, mais prend un tableau de jusqu’à 50 URL et les convertit séquentiellement en un seul appel. Idéal pour récupérer de nombreux fils Reddit ou pages rendues en JS en une seule fois. Exemple de prompt : « Convertis ces 12 URL en Markdown en lot : […] »

search_library

Recherche dans votre Bibliothèque Web2MD — chaque page que vous avez enregistrée — par mot-clé (correspond au titre et au contenu complet de la page) et/ou par tag, du plus récent au plus ancien. Renvoie des métadonnées compactes (id, titre, url, date, tags), pas le Markdown complet. Les comptes du plan gratuit ne voient que les éléments les plus récents dans les résultats ; l’outil indique quand les résultats ont été tronqués. Exemple de prompt : « Cherche dans ma bibliothèque tout ce qui concerne l’authentification »

get_library_items

Récupère le contenu Markdown complet des éléments de la Bibliothèque par id (jusqu’à 20 par appel — utilisez d’abord search_library pour trouver les id). Les réponses peuvent être volumineuses ; pour les pages longues, regroupez 5 id ou moins par appel. Exemple de prompt : « Récupère le contenu complet des éléments de bibliothèque abc123 et def456 »

sync_library

Synchronise toute votre Bibliothèque vers un répertoire local sous forme de fichiers Markdown, organisés par tag avec en-tête YAML. Incrémental par défaut (suit un curseur dans <dir>/.web2md-sync.json) ; passez full: true pour tout rescanner. C’est la même synchronisation que celle exécutée par web2md sync depuis le CLI — utilisez celle qui convient le mieux à votre workflow. Exemple de prompt : « Synchronise ma bibliothèque vers ~/notes/web2md, uniquement le tag ‘research’ »

list_skills

Liste les Skills enregistrés dans votre compte cloud Web2MD sous forme de tableau compact (id, nom, description). Utilisez get_skill pour en récupérer un en intégralité. Exemple de prompt : « Quels skills ai-je enregistrés ? »

get_skill

Récupère le contenu complet au format SKILL.md d’un Skill par id ou par nom — ses instructions, sa description et son contenu en intégralité. Utilisez d’abord list_skills si vous ne connaissez pas l’id. Exemple de prompt : « Récupère mon skill ‘summarize’ »

semantic_search / get_conversion (dépréciés)

Ces deux outils précèdent la Bibliothèque. Ils fonctionnent encore mais ne voient que les conversions enregistrées via l’ancienne API d’historique, pas la Bibliothèque complète — les nouvelles intégrations devraient utiliser search_library et get_library_items à la place.

Authentification

Le serveur résout la clé API dans cet ordre :

La variable d’environnement WEB2MD_API_KEY, si elle est définie.
Sinon, ~/.web2md/config.json — le même fichier écrit par npx web2md-cli login (le flux de connexion par appareil du CLI). Exécutez login une fois et le CLI comme le serveur MCP récupèrent automatiquement la clé, sans bloc env nécessaire.

Si aucune n’est trouvée, le serveur démarre mais chaque appel d’outil renvoie une erreur d’authentification avec une suggestion de définir la clé ou d’exécuter login.

Configuration

Claude Desktop
Cursor
Windsurf

Ouvrez votre fichier de configuration Claude Desktop :

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Windows : %APPDATA%\Claude\claude_desktop_config.json

Ajoutez l’entrée web2md sous mcpServers :

{
  "mcpServers": {
    "web2md": {
      "command": "npx",
      "args": ["-y", "web2md-mcp-server"],
      "env": {
        "WEB2MD_API_KEY": "w2m_your_key_here"
      }
    }
  }
}

Si vous avez déjà exécuté npx web2md-cli login, vous pouvez supprimer complètement le bloc env — le serveur lit la clé depuis ~/.web2md/config.json.Redémarrez Claude Desktop. Les outils Web2MD devraient apparaître dans le sélecteur d’outils.

Ouvrez votre fichier de configuration MCP Cursor à ~/.cursor/mcp.json et ajoutez :

{
  "mcpServers": {
    "web2md": {
      "command": "npx",
      "args": ["-y", "web2md-mcp-server"],
      "env": {
        "WEB2MD_API_KEY": "w2m_your_key_here"
      }
    }
  }
}

Redémarrez Cursor pour charger le nouveau serveur.

Ouvrez votre fichier de configuration MCP Windsurf à ~/.windsurf/mcp.json et ajoutez :

{
  "mcpServers": {
    "web2md": {
      "command": "npx",
      "args": ["-y", "web2md-mcp-server"],
      "env": {
        "WEB2MD_API_KEY": "w2m_your_key_here"
      }
    }
  }
}

Redémarrez Windsurf pour charger le nouveau serveur.

Exemples d’utilisation

Une fois le serveur MCP en cours d’exécution, vous pouvez utiliser du langage naturel dans votre assistant IA :

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 et récupérer depuis votre Bibliothèque

Vous : Cherche dans ma bibliothèque tout ce qui concerne l’authentification, puis récupère le contenu complet du plus récentAssistant : (appelle search_library, puis get_library_items) J’ai trouvé 3 éléments liés à l’authentification. Voici le contenu complet du plus récent, « OAuth 2.0 Guide »…

Synchroniser votre Bibliothèque en local

Vous : Synchronise ma bibliothèque vers ~/notes/web2mdAssistant : (appelle sync_library) 42 nouveaux éléments synchronisés, 118 déjà à jour, 0 échec.

Convertir en lot avec l'extension

Vous : Convertis en lot ces 8 fils Reddit : […]Assistant : (appelle agent_batch_convert) 8/8 URL converties avec succès.

Appliquer un Skill enregistré

Vous : Quels skills ai-je, et peux-tu appliquer « summarize » à cette page : https://…Assistant : (appelle list_skills, puis agent_convert avec skill: "summarize") Voici la page convertie en Markdown, avec le skill summarize appliqué ci-dessous…

Combinez les outils dans une même conversation. Par exemple : « Cherche dans ma bibliothèque des docs React, puis récupère le contenu complet du plus récent. »

Dépannage

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 -y web2md-mcp-server s’exécute correctement dans votre terminal.

Erreurs d'authentification

Vérifiez que WEB2MD_API_KEY est une clé w2m_ valide, ou que ~/.web2md/config.json en contient une (réexécutez npx web2md-cli login en cas de doute). Vous pouvez vérifier votre clé sur la page des clés API.

agent_convert / agent_batch_convert / bridge_convert_url échouent

Ces outils nécessitent que Chrome soit ouvert avec l’extension Web2MD installée, et — pour les outils agent_* — que l’hôte natif soit également installé. Consultez Agent Bridge pour la configuration.

npx échoue à résoudre le package

Essayez d’installer le package globalement d’abord : npm install -g web2md-mcp-server, puis changez command en web2md-mcp-server et supprimez le champ args.

Premiers pas

Fonctionnalités principales

Avancé

Forfaits

Vue d’ensemble

Outils disponibles

convert_url

bridge_convert_url

agent_convert

agent_batch_convert

search_library

get_library_items

sync_library

list_skills

get_skill

semantic_search / get_conversion (dépréciés)

Authentification

Configuration

Exemples d’utilisation

Dépannage

​Vue d’ensemble

​Outils disponibles

​convert_url

​bridge_convert_url

​agent_convert

​agent_batch_convert

​search_library

​get_library_items

​sync_library

​list_skills

​get_skill

​semantic_search / get_conversion (dépréciés)

​Authentification

​Configuration

​Exemples d’utilisation

​Dépannage

Vue d’ensemble

Outils disponibles

convert_url

bridge_convert_url

agent_convert

agent_batch_convert

search_library

get_library_items

sync_library

list_skills

get_skill

semantic_search / get_conversion (dépréciés)

Authentification

Configuration

Exemples d’utilisation

Dépannage