MCP Server

Обзор

MCP-сервер Web2MD предоставляет Web2MD в виде набора инструментов, которые AI-ассистенты могут вызывать напрямую, используя Model Context Protocol (MCP) — открытый стандарт для подключения AI-моделей к внешним инструментам и источникам данных. После настройки вы можете попросить Claude, Cursor или Windsurf преобразовать страницы, найти нужную страницу в истории преобразований или получить сохранённый Markdown, не выходя из диалога.

Для работы MCP-сервера требуется API-ключ Web2MD (тариф PRO). Создайте его в панели управления.

Доступные инструменты

MCP-сервер предоставляет три инструмента:

Инструмент	Описание
`convert_url`	Преобразование любого URL в чистый Markdown
`semantic_search`	Поиск по сохранённым преобразованиям на естественном языке
`get_conversion`	Получение полного Markdown сохранённого преобразования по ID

convert_url

Загружает страницу по URL и возвращает её содержимое в формате Markdown. Поддерживает те же параметры преобразования, что и REST API. Пример запроса: «Преобразуй эту ссылку в markdown: https://docs.example.com/getting-started»

semantic_search

Выполняет поиск по всем ранее сохранённым преобразованиям с помощью запроса на естественном языке. Возвращает список подходящих преобразований с заголовками, URL и оценкой релевантности. Пример запроса: «Найди среди моих сохранённых страниц статьи об индексации баз данных»

get_conversion

Возвращает полное содержимое Markdown конкретного сохранённого преобразования по его ID. Полезно для добавления целого документа в контекст после того, как он найден с помощью semantic_search. Пример запроса: «Покажи полное содержимое преобразования abc123»

Настройка

Claude Desktop
Cursor
Windsurf

Откройте файл конфигурации Claude Desktop:

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

Добавьте запись web2md в раздел mcpServers:

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

Перезапустите Claude Desktop. Инструменты Web2MD должны появиться в списке доступных инструментов.

Откройте файл конфигурации MCP для Cursor по пути ~/.cursor/mcp.json и добавьте:

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

Перезапустите Cursor, чтобы загрузить новый сервер.

Откройте файл конфигурации MCP для Windsurf по пути ~/.windsurf/mcp.json и добавьте:

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

Перезапустите Windsurf, чтобы загрузить новый сервер.

Примеры использования

После запуска MCP-сервера вы можете использовать естественный язык в своём AI-ассистенте:

Преобразование страницы в Markdown

Вы: Преобразуй эту ссылку в markdown: https://react.dev/learn/thinking-in-reactАссистент: (вызывает convert_url) Вот преобразованный Markdown для страницы «Thinking in React»…

Поиск среди сохранённых преобразований

Вы: Найди среди моих сохранённых страниц что-нибудь про аутентификациюАссистент: (вызывает semantic_search) Я нашёл 3 сохранённых преобразования, связанных с аутентификацией:

«OAuth 2.0 Guide» — сохранено 2 дня назад
«JWT Best Practices» — сохранено на прошлой неделе
…

Получение полного преобразования

Вы: Покажи полное содержимое преобразования abc123Ассистент: (вызывает get_conversion) Вот полное содержимое в формате Markdown…

Комбинируйте инструменты в рамках одного диалога. Например: «Найди среди моих преобразований документацию по React, а затем покажи полное содержимое самого последнего».

Устранение неполадок

Инструменты не появляются после настройки

Убедитесь, что вы перезапустили приложение после редактирования файла конфигурации. Проверьте, что команда npx web2md-mcp успешно выполняется в терминале.

Ошибки аутентификации

Убедитесь, что ваш WEB2MD_API_KEY указан верно и подписка PRO активна. Проверить ключ можно на странице API-ключей.

npx не может разрешить пакет

Попробуйте сначала установить пакет глобально: npm install -g web2md-mcp, затем измените command на web2md-mcp и удалите поле args.

Начало работы

Основные функции

Дополнительно

Тарифы

Обзор

Доступные инструменты

convert_url

semantic_search

get_conversion

Настройка

Примеры использования

Устранение неполадок

​Обзор

​Доступные инструменты

​convert_url

​semantic_search

​get_conversion

​Настройка

​Примеры использования

​Устранение неполадок

Обзор

Доступные инструменты

convert_url

semantic_search

get_conversion

Настройка

Примеры использования

Устранение неполадок