MCP Server

Übersicht

Der Web2MD MCP-Server stellt Web2MD als eine Reihe von Tools bereit, die AI-Assistenten direkt aufrufen können, unter Verwendung des Model Context Protocol (MCP) — einem offenen Standard zur Verbindung von AI-Modellen mit externen Tools und Datenquellen. Nach der Konfiguration können Sie Claude, Cursor oder Windsurf bitten, Seiten zu konvertieren, Ihre Library zu durchsuchen und zu synchronisieren, mit der Chrome-Erweiterung im Batch zu konvertieren oder einen gespeicherten Skill einzubinden — ohne die Konversation zu verlassen.

Der MCP-Server erfordert einen Web2MD API-Schlüssel (PRO-Plan). Erstellen Sie einen im Dashboard, oder führen Sie npx web2md-cli login aus, um sich einmalig zu authentifizieren und den Schlüssel automatisch mit der CLI zu teilen (siehe Authentifizierung unten).

Verfügbare Tools

Der MCP-Server stellt 11 Tools bereit, gruppiert nach Funktion:

Tool	Beschreibung
`convert_url`	Konvertiert jede URL über den serverseitigen Converter in sauberes Markdown
`bridge_convert_url`	Konvertiert eine URL über Ihre Chrome-Erweiterung per HTTP — für Reddit, JS-gerenderte oder login-geschützte Seiten
`agent_convert`	Konvertiert eine URL über die Chrome-Erweiterung per Native Messaging (gleiche Anwendungsfälle wie `bridge_convert_url`, anderer Transportweg)
`agent_batch_convert`	Konvertiert bis zu 50 URLs im Batch über die Chrome-Erweiterung per Native Messaging
`search_library`	Durchsucht Ihre gespeicherte Library nach Stichwort und/oder Tag
`get_library_items`	Ruft vollständiges Markdown für Library-Einträge anhand der ID ab
`sync_library`	Synchronisiert Ihre Library als Markdown-Dateien in ein lokales Verzeichnis
`list_skills`	Listet die in Ihrem Web2MD-Cloud-Konto gespeicherten Skills auf
`get_skill`	Ruft den vollständigen Inhalt eines Skills anhand der ID oder des Namens ab
`semantic_search`	Veraltet — verwenden Sie stattdessen `search_library` + `get_library_items`
`get_conversion`	Veraltet — verwenden Sie stattdessen `search_library` + `get_library_items`

convert_url

Ruft eine URL serverseitig ab und liefert den Seiteninhalt als Markdown zurück, mit Titel, Wortanzahl und Lesezeit. Unterstützt dieselben Konvertierungsoptionen wie die REST API (includeImages, includeLinks). Beispiel-Prompt: “Convert this URL to markdown: https://docs.example.com/getting-started”

bridge_convert_url

Konvertiert eine URL, indem ihr HTML über Ihre laufende Chrome-Erweiterung abgerufen wird (über eine lokale HTTP-Bridge), und konvertiert dieses HTML dann serverseitig in Markdown. Verwenden Sie dies für Seiten, die der Server nicht direkt erreichen kann — Reddit, login-geschützte Seiten oder stark JS-gerenderte Seiten. Erfordert ein geöffnetes Chrome mit installierter Web2MD-Erweiterung; die Extension-ID wird automatisch anhand Ihres API-Schlüssels ermittelt. Beispiel-Prompt: “Use the bridge to convert this Reddit thread: https://reddit.com/r/…“

agent_convert

Konvertiert eine URL auf dieselbe Weise wie bridge_convert_url — über Ihre Chrome-Erweiterung — jedoch über den Agent Bridge Native-Messaging-Kanal statt über HTTP. Akzeptiert einen optionalen skill-Parameter: Übergeben Sie eine Skill-ID oder einen -Namen, und dessen Inhalt wird dem zurückgegebenen Markdown angehängt, sodass der Agent sofort darauf reagieren kann. Erfordert ein laufendes Chrome mit installierter Erweiterung und Native Host. Beispiel-Prompt: “Convert this page with the summarize skill applied: https://…“

agent_batch_convert

Derselbe Transportweg wie bei agent_convert, akzeptiert jedoch ein Array von bis zu 50 URLs und konvertiert diese in einem Aufruf nacheinander. Ideal, um viele Reddit-Threads oder JS-gerenderte Seiten auf einmal abzurufen. Beispiel-Prompt: “Batch-convert these 12 URLs to Markdown: […]“

search_library

Durchsucht Ihre Web2MD Library — jede von Ihnen gespeicherte Seite — nach Stichwort (durchsucht Titel und vollständigen Seiteninhalt) und/oder Tag, neueste zuerst. Liefert kompakte Metadaten (id, title, url, date, tags), nicht das vollständige Markdown. Free-Plan-Konten sehen in den Ergebnissen nur die neuesten Einträge; das Tool weist darauf hin, wenn Ergebnisse gekürzt wurden. Beispiel-Prompt: “Search my library for anything about authentication”

get_library_items

Ruft den vollständigen Markdown-Inhalt von Library-Einträgen anhand der ID ab (bis zu 20 pro Aufruf — verwenden Sie zuerst search_library, um die IDs zu finden). Antworten können umfangreich sein; bei langen Seiten empfiehlt sich ein Batch von 5 oder weniger IDs pro Aufruf. Beispiel-Prompt: “Get the full content of library items abc123 and def456”

sync_library

Synchronisiert Ihre gesamte Library als Markdown-Dateien in ein lokales Verzeichnis, organisiert nach Tag mit Frontmatter. Standardmäßig inkrementell (verfolgt einen Cursor in <dir>/.web2md-sync.json); übergeben Sie full: true, um alles neu zu scannen. Dies ist dieselbe Synchronisierung, die web2md sync über die CLI ausführt — verwenden Sie, was zu Ihrem Workflow passt. Beispiel-Prompt: “Sync my library to ~/notes/web2md, tag ‘research’ only”

list_skills

Listet die in Ihrem Web2MD-Cloud-Konto gespeicherten Skills als kompaktes Array auf (id, name, description). Verwenden Sie get_skill, um einen davon vollständig abzurufen. Beispiel-Prompt: “What skills do I have saved?“

get_skill

Ruft den vollständigen SKILL.md-artigen Inhalt eines Skills anhand der ID oder des Namens ab — Anweisungen, Beschreibung und Inhalt in voller Länge. Verwenden Sie zuerst list_skills, wenn Sie die ID nicht kennen. Beispiel-Prompt: “Get my ‘summarize’ skill”

semantic_search / get_conversion (veraltet)

Diese beiden Tools stammen aus der Zeit vor der Library. Sie funktionieren noch, sehen aber nur Konvertierungen, die über die alte History-API gespeichert wurden, nicht die vollständige Library — neue Integrationen sollten stattdessen search_library und get_library_items verwenden.

Authentifizierung

Der Server ermittelt den API-Schlüssel in dieser Reihenfolge:

Umgebungsvariable WEB2MD_API_KEY, falls gesetzt.
Andernfalls ~/.web2md/config.json — dieselbe Datei, die von npx web2md-cli login geschrieben wird (der Device-Login-Flow der CLI). Führen Sie login einmal aus, und sowohl die CLI als auch der MCP-Server übernehmen den Schlüssel automatisch — kein env-Block nötig.

Wird keiner der beiden gefunden, startet der Server dennoch, aber jeder Tool-Aufruf liefert einen Authentifizierungsfehler mit einem Hinweis, den Schlüssel zu setzen oder login auszuführen.

Einrichtung

Claude Desktop
Cursor
Windsurf

Öffnen Sie Ihre Claude Desktop-Konfigurationsdatei:

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

Fügen Sie den web2md-Eintrag unter mcpServers hinzu:

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

Wenn Sie bereits npx web2md-cli login ausgeführt haben, können Sie den env-Block komplett weglassen — der Server liest den Schlüssel aus ~/.web2md/config.json.Starten Sie Claude Desktop neu. Die Web2MD-Tools sollten nun im Tool-Picker erscheinen.

Öffnen Sie Ihre Cursor MCP-Konfigurationsdatei unter ~/.cursor/mcp.json und fügen Sie Folgendes hinzu:

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

Starten Sie Cursor neu, um den neuen Server zu laden.

Öffnen Sie Ihre Windsurf MCP-Konfigurationsdatei unter ~/.windsurf/mcp.json und fügen Sie Folgendes hinzu:

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

Starten Sie Windsurf neu, um den neuen Server zu laden.

Anwendungsbeispiele

Sobald der MCP-Server läuft, können Sie natürliche Sprache in Ihrem AI-Assistenten verwenden:

Eine Seite in Markdown konvertieren

Sie: Convert this URL to markdown: https://react.dev/learn/thinking-in-reactAssistent: (ruft convert_url auf) Hier ist das konvertierte Markdown für “Thinking in React”…

In Ihrer Library suchen und abrufen

Sie: Search my library for anything about authentication, then get the full content of the most recent oneAssistent: (ruft search_library auf, dann get_library_items) Ich habe 3 Einträge zum Thema Authentifizierung gefunden. Hier ist der vollständige Inhalt des neuesten, “OAuth 2.0 Guide”…

Ihre Library lokal synchronisieren

Sie: Sync my library to ~/notes/web2mdAssistent: (ruft sync_library auf) 42 neue Einträge synchronisiert, 118 bereits aktuell, 0 fehlgeschlagen.

Mit der Erweiterung im Batch konvertieren

Sie: Batch-convert these 8 Reddit threads: […]Assistent: (ruft agent_batch_convert auf) 8/8 URLs erfolgreich konvertiert.

Einen gespeicherten Skill anwenden

Sie: What skills do I have, and can you apply “summarize” to this page: https://…Assistent: (ruft list_skills auf, dann agent_convert mit skill: "summarize") Hier ist die Seite als Markdown konvertiert, mit dem angewendeten summarize-Skill darunter…

Kombinieren Sie Tools in einer einzigen Konversation. Zum Beispiel: “Search my library for React docs, then get the full content of the most recent one.”

Fehlerbehebung

Tools erscheinen nach der Einrichtung nicht

Stellen Sie sicher, dass Sie die Anwendung nach dem Bearbeiten der Konfigurationsdatei neu gestartet haben. Überprüfen Sie, ob npx -y web2md-mcp-server in Ihrem Terminal erfolgreich ausgeführt wird.

Authentifizierungsfehler

Überprüfen Sie, ob WEB2MD_API_KEY ein gültiger w2m_-Schlüssel ist, oder ob ~/.web2md/config.json einen enthält (führen Sie im Zweifel npx web2md-cli login erneut aus). Sie können Ihren Schlüssel auf der API-Schlüssel-Seite überprüfen.

agent_convert / agent_batch_convert / bridge_convert_url schlagen fehl

Diese Tools erfordern ein geöffnetes Chrome mit installierter Web2MD-Erweiterung und — für die agent_*-Tools — zusätzlich den installierten Native Host. Siehe Agent Bridge für die Einrichtung.

npx kann das Paket nicht auflösen

Versuchen Sie zunächst, das Paket global zu installieren: npm install -g web2md-mcp-server, ändern Sie dann command auf web2md-mcp-server und entfernen Sie das args-Feld.

Erste Schritte

Kernfunktionen

Erweitert

Tarife

Übersicht

Verfügbare Tools

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 (veraltet)

Authentifizierung

Einrichtung

Anwendungsbeispiele

Fehlerbehebung

​Übersicht

​Verfügbare Tools

​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 (veraltet)

​Authentifizierung

​Einrichtung

​Anwendungsbeispiele

​Fehlerbehebung

Übersicht

Verfügbare Tools

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 (veraltet)

Authentifizierung

Einrichtung

Anwendungsbeispiele

Fehlerbehebung