Servidor MCP

Descripción general

El servidor MCP de Web2MD expone Web2MD como un conjunto de herramientas que los asistentes de IA pueden invocar directamente, usando el Model Context Protocol (MCP) — un estándar abierto para conectar modelos de IA con herramientas y fuentes de datos externas. Una vez configurado, puedes pedirle a Claude, Cursor o Windsurf que convierta páginas, busque y sincronice tu Library, haga conversión por lotes con la extensión de Chrome, o traiga una Skill guardada — sin salir de la conversación.

El servidor MCP requiere una clave de API de Web2MD (plan PRO). Genera una desde el panel, o ejecuta npx web2md-cli login para autenticarte una vez y compartir la clave con la CLI automáticamente (ver Autenticación más abajo).

Herramientas disponibles

El servidor MCP ofrece 11 herramientas, agrupadas por lo que hacen:

Herramienta	Descripción
`convert_url`	Convierte cualquier URL a Markdown limpio mediante el conversor del lado del servidor
`bridge_convert_url`	Convierte una URL a través de tu extensión de Chrome vía HTTP — para Reddit, páginas renderizadas con JS o protegidas por login
`agent_convert`	Convierte una URL a través de la extensión de Chrome vía native messaging (mismos casos de uso que `bridge_convert_url`, distinto transporte)
`agent_batch_convert`	Convierte por lotes hasta 50 URLs a través de la extensión de Chrome vía native messaging
`search_library`	Busca en tu Library guardada por palabra clave y/o etiqueta
`get_library_items`	Obtiene el Markdown completo de elementos de la Library por id
`sync_library`	Sincroniza tu Library con un directorio local como archivos Markdown
`list_skills`	Lista las Skills guardadas en tu cuenta cloud de Web2MD
`get_skill`	Obtiene el cuerpo completo de una Skill por id o nombre
`semantic_search`	Obsoleta — usa `search_library` + `get_library_items` en su lugar
`get_conversion`	Obsoleta — usa `search_library` + `get_library_items` en su lugar

convert_url

Obtiene una URL del lado del servidor y devuelve el contenido de la página como Markdown, con título, recuento de palabras y tiempo de lectura. Admite las mismas opciones de conversión que la API REST (includeImages, includeLinks). Ejemplo de prompt: “Convierte esta URL a markdown: https://docs.example.com/getting-started”

bridge_convert_url

Convierte una URL obteniendo su HTML a través de tu extensión de Chrome en ejecución (mediante un puente HTTP local), y luego convierte ese HTML a Markdown del lado del servidor. Úsala para páginas a las que el servidor no puede acceder directamente — Reddit, sitios protegidos por login, o páginas fuertemente renderizadas con JS. Requiere Chrome abierto con la extensión de Web2MD instalada; el ID de la extensión se descubre automáticamente a partir de tu clave de API. Ejemplo de prompt: “Usa el bridge para convertir este hilo de Reddit: https://reddit.com/r/…“

agent_convert

Convierte una URL de la misma forma que bridge_convert_url — a través de tu extensión de Chrome — pero por el canal de native messaging de Agent Bridge en lugar de HTTP. Acepta un parámetro opcional skill: pasa un id o nombre de Skill y su contenido se añade al Markdown devuelto para que el agente pueda actuar sobre él de inmediato. Requiere Chrome en ejecución con la extensión y el host nativo instalados. Ejemplo de prompt: “Convierte esta página aplicando la skill summarize: https://…“

agent_batch_convert

Mismo transporte que agent_convert, pero toma un array de hasta 50 URLs y las convierte secuencialmente en una sola llamada. Ideal para traer muchos hilos de Reddit o páginas renderizadas con JS de una sola vez. Ejemplo de prompt: “Convierte por lotes estas 12 URLs a Markdown: […]“

search_library

Busca en tu Library de Web2MD — cada página que has guardado — por palabra clave (coincide con el título y el contenido completo de la página) y/o etiqueta, de más reciente a más antigua. Devuelve metadatos compactos (id, título, url, fecha, etiquetas), no el Markdown completo. Las cuentas del plan Free solo ven los elementos más recientes en los resultados; la herramienta te avisa cuando los resultados fueron truncados. Ejemplo de prompt: “Busca en mi library algo sobre autenticación”

get_library_items

Obtiene el contenido Markdown completo de elementos de la Library por id (hasta 20 por llamada — usa primero search_library para encontrar los ids). Las respuestas pueden ser grandes; para páginas largas, agrupa 5 ids o menos por llamada. Ejemplo de prompt: “Obtén el contenido completo de los elementos de library abc123 y def456”

sync_library

Sincroniza toda tu Library con un directorio local como archivos Markdown, organizados por etiqueta con frontmatter. Incremental por defecto (registra un cursor en <dir>/.web2md-sync.json); pasa full: true para volver a escanear todo. Es la misma sincronización que ejecuta web2md sync desde la CLI — usa la superficie que mejor se adapte a tu flujo de trabajo. Ejemplo de prompt: “Sincroniza mi library en ~/notes/web2md, solo la etiqueta ‘research‘“

list_skills

Lista las Skills guardadas en tu cuenta cloud de Web2MD como un array compacto (id, nombre, descripción). Usa get_skill para obtener una en detalle. Ejemplo de prompt: “¿Qué skills tengo guardadas?“

get_skill

Obtiene el cuerpo completo, al estilo SKILL.md, de una Skill por id o nombre — sus instrucciones, descripción y contenido completo. Usa primero list_skills si no conoces el id. Ejemplo de prompt: “Obtén mi skill ‘summarize‘“

semantic_search / get_conversion (obsoletas)

Estas dos herramientas son anteriores a la Library. Siguen funcionando pero solo ven conversiones guardadas a través de la antigua API de historial, no la Library completa — las nuevas integraciones deberían usar search_library y get_library_items en su lugar.

Autenticación

El servidor resuelve la clave de API en este orden:

La variable de entorno WEB2MD_API_KEY, si está definida.
En caso contrario, ~/.web2md/config.json — el mismo archivo que escribe npx web2md-cli login (el flujo de device-login de la CLI). Ejecuta login una vez y tanto la CLI como el servidor MCP recogen la clave automáticamente, sin necesidad de un bloque env.

Si no se encuentra ninguna, el servidor arranca pero cada llamada a una herramienta devuelve un error de autenticación con una sugerencia para definir la clave o ejecutar login.

Configuración

Claude Desktop
Cursor
Windsurf

Abre tu archivo de configuración de Claude Desktop:

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

Añade la entrada web2md bajo mcpServers:

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

Si ya ejecutaste npx web2md-cli login, puedes omitir por completo el bloque env — el servidor lee la clave desde ~/.web2md/config.json.Reinicia Claude Desktop. Deberías ver aparecer las herramientas de Web2MD en el selector de herramientas.

Abre tu archivo de configuración MCP de Cursor en ~/.cursor/mcp.json y añade:

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

Reinicia Cursor para cargar el nuevo servidor.

Abre tu archivo de configuración MCP de Windsurf en ~/.windsurf/mcp.json y añade:

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

Reinicia Windsurf para cargar el nuevo servidor.

Ejemplos de uso

Una vez que el servidor MCP está en ejecución, puedes usar lenguaje natural en tu asistente de IA:

Convertir una página a Markdown

Tú: Convierte esta URL a markdown: https://react.dev/learn/thinking-in-reactAsistente: (invoca convert_url) Aquí está el Markdown convertido de “Thinking in React”…

Buscar y traer de tu Library

Tú: Busca en mi library algo sobre autenticación, y luego trae el contenido completo del más recienteAsistente: (invoca search_library, luego get_library_items) Encontré 3 elementos relacionados con autenticación. Aquí está el contenido completo del más reciente, “OAuth 2.0 Guide”…

Sincronizar tu Library localmente

Tú: Sincroniza mi library en ~/notes/web2mdAsistente: (invoca sync_library) Se sincronizaron 42 elementos nuevos, 118 ya estaban actualizados, 0 fallaron.

Convertir por lotes con la extensión

Tú: Convierte por lotes estos 8 hilos de Reddit: […]Asistente: (invoca agent_batch_convert) Se convirtieron 8/8 URLs correctamente.

Aplicar una Skill guardada

Tú: ¿Qué skills tengo, y puedes aplicar “summarize” a esta página?: https://…Asistente: (invoca list_skills, luego agent_convert con skill: "summarize") Aquí está la página convertida a Markdown, con la skill summarize aplicada debajo…

Combina herramientas en una misma conversación. Por ejemplo: “Busca en mi library documentación sobre React, y luego trae el contenido completo del más reciente.”

Solución de problemas

Las herramientas no aparecen después de configurar

Asegúrate de haber reiniciado la aplicación después de editar el archivo de configuración. Verifica que npx -y web2md-mcp-server se ejecute correctamente en tu terminal.

Errores de autenticación

Verifica que WEB2MD_API_KEY sea una clave w2m_ válida, o que ~/.web2md/config.json tenga una (vuelve a ejecutar npx web2md-cli login si no estás seguro). Puedes verificar tu clave en la página de claves de API.

agent_convert / agent_batch_convert / bridge_convert_url fallan

Estas herramientas requieren Chrome abierto con la extensión de Web2MD instalada, y — para las herramientas agent_* — el host nativo también instalado. Consulta Agent Bridge para la configuración.

npx no logra resolver el paquete

Intenta instalar el paquete globalmente primero: npm install -g web2md-mcp-server, luego cambia command a web2md-mcp-server y elimina el campo args.

Primeros pasos

Funciones principales

Avanzado

Planes

Descripción general

Herramientas 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 (obsoletas)

Autenticación

Configuración

Ejemplos de uso

Solución de problemas

​Descripción general

​Herramientas 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 (obsoletas)

​Autenticación

​Configuración

​Ejemplos de uso

​Solución de problemas

Descripción general

Herramientas 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 (obsoletas)

Autenticación

Configuración

Ejemplos de uso

Solución de problemas