> ## Documentation Index > Fetch the complete documentation index at: https://web2md.org/docs/llms.txt > Use this file to discover all available pages before exploring further. # Servidor MCP > Usa Web2MD desde Claude Desktop, Cursor y Windsurf ## 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)](https://modelcontextprotocol.io) — 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](https://web2md.org/dashboard/api-keys), o ejecuta `npx web2md-cli login` para autenticarte una vez y compartir la clave con la CLI automáticamente (ver [Autenticación](#authentication) 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](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/](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](/docs/es/advanced/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 `/.web2md-sync.json`); pasa `full: true` para volver a escanear todo. Es la misma sincronización que ejecuta `web2md sync` desde la [CLI](/docs/es/advanced/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: 1. La variable de entorno `WEB2MD_API_KEY`, si está definida. 2. En caso contrario, `~/.web2md/config.json` — el mismo archivo que escribe `npx web2md-cli login` (el flujo de device-login de la [CLI](/docs/es/advanced/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 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`: ```json theme={null} { "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: ```json theme={null} { "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: ```json theme={null} { "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: **Tú:** Convierte esta URL a markdown: [https://react.dev/learn/thinking-in-react](https://react.dev/learn/thinking-in-react) **Asistente:** *(invoca `convert_url`)* Aquí está el Markdown convertido de "Thinking in React"... **Tú:** Busca en mi library algo sobre autenticación, y luego trae el contenido completo del más reciente **Asistente:** *(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"... **Tú:** Sincroniza mi library en \~/notes/web2md **Asistente:** *(invoca `sync_library`)* Se sincronizaron 42 elementos nuevos, 118 ya estaban actualizados, 0 fallaron. **Tú:** Convierte por lotes estos 8 hilos de Reddit: \[...] **Asistente:** *(invoca `agent_batch_convert`)* Se convirtieron 8/8 URLs correctamente. **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 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. 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](https://web2md.org/dashboard/api-keys). 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](/docs/es/advanced/agent-bridge) para la configuración. Intenta instalar el paquete globalmente primero: `npm install -g web2md-mcp-server`, luego cambia `command` a `web2md-mcp-server` y elimina el campo `args`.