MCP Server

Visão geral

O servidor MCP do Web2MD expõe o Web2MD como um conjunto de ferramentas que assistentes de IA podem chamar diretamente, usando o Model Context Protocol (MCP) — um padrão aberto para conectar modelos de IA a ferramentas e fontes de dados externas. Depois de configurado, você pode pedir ao Claude, Cursor ou Windsurf para converter páginas, buscar e sincronizar sua Library, fazer conversão em lote com a extensão do Chrome, ou aplicar uma Skill salva — sem sair da conversa.

O servidor MCP requer uma chave de API do Web2MD (plano PRO). Gere uma no painel, ou execute npx web2md-cli login para autenticar uma vez e compartilhar a chave com o CLI automaticamente (veja Autenticação abaixo).

Ferramentas disponíveis

O servidor MCP oferece 11 ferramentas, agrupadas pelo que fazem:

Ferramenta	Descrição
`convert_url`	Converte qualquer URL em Markdown limpo via o conversor no servidor
`bridge_convert_url`	Converte uma URL através da sua extensão do Chrome via HTTP — para Reddit, páginas renderizadas por JS, ou páginas protegidas por login
`agent_convert`	Converte uma URL através da extensão do Chrome via native messaging (mesmos casos de uso de `bridge_convert_url`, transporte diferente)
`agent_batch_convert`	Converte em lote até 50 URLs através da extensão do Chrome via native messaging
`search_library`	Busca na sua Library salva por palavra-chave e/ou tag
`get_library_items`	Busca o Markdown completo de itens da Library por id
`sync_library`	Sincroniza sua Library com um diretório local como arquivos Markdown
`list_skills`	Lista as Skills salvas na sua conta em nuvem do Web2MD
`get_skill`	Busca o corpo completo de uma Skill por id ou nome
`semantic_search`	Descontinuada — use `search_library` + `get_library_items` em vez disso
`get_conversion`	Descontinuada — use `search_library` + `get_library_items` em vez disso

convert_url

Busca uma URL no servidor e retorna o conteúdo da página como Markdown, com título, contagem de palavras e tempo de leitura. Suporta as mesmas opções de conversão da REST API (includeImages, includeLinks). Exemplo de prompt: “Convert this URL to markdown: https://docs.example.com/getting-started”

bridge_convert_url

Converte uma URL buscando seu HTML através da sua extensão do Chrome em execução (via uma ponte HTTP local), depois convertendo esse HTML em Markdown no servidor. Use isso para páginas que o servidor não consegue acessar diretamente — Reddit, sites protegidos por login, ou páginas fortemente renderizadas por JS. Requer o Chrome aberto com a extensão do Web2MD instalada; o ID da extensão é descoberto automaticamente a partir da sua chave de API. Exemplo de prompt: “Use the bridge to convert this Reddit thread: https://reddit.com/r/…“

agent_convert

Converte uma URL da mesma forma que bridge_convert_url — através da sua extensão do Chrome — mas pelo canal de native messaging do Agent Bridge em vez de HTTP. Aceita um parâmetro skill opcional: passe um id ou nome de Skill e seu corpo é anexado ao Markdown retornado, para que o agente possa agir sobre ele imediatamente. Requer o Chrome em execução com a extensão e o host nativo instalados. Exemplo de prompt: “Convert this page with the summarize skill applied: https://…“

agent_batch_convert

Mesmo transporte de agent_convert, mas recebe um array de até 50 URLs e as converte sequencialmente em uma única chamada. Ideal para trazer múltiplas threads do Reddit ou páginas renderizadas por JS de uma vez. Exemplo de prompt: “Batch-convert these 12 URLs to Markdown: […]“

search_library

Busca na sua Library do Web2MD — cada página que você salvou — por palavra-chave (compara com o título e o conteúdo completo da página) e/ou tag, das mais recentes para as mais antigas. Retorna metadados compactos (id, título, url, data, tags), não o Markdown completo. Contas no plano gratuito veem apenas os itens mais recentes nos resultados; a ferramenta avisa quando os resultados foram truncados. Exemplo de prompt: “Search my library for anything about authentication”

get_library_items

Busca o conteúdo completo em Markdown de itens da Library por id (até 20 por chamada — use search_library primeiro para encontrar os ids). As respostas podem ser grandes; para páginas longas, agrupe 5 ou menos ids por chamada. Exemplo de prompt: “Get the full content of library items abc123 and def456”

sync_library

Sincroniza toda a sua Library com um diretório local como arquivos Markdown, organizados por tag com frontmatter. Incremental por padrão (rastreia um cursor em <dir>/.web2md-sync.json); passe full: true para reescanear tudo. É a mesma sincronização que web2md sync executa a partir do CLI — use a superfície que melhor se encaixa no seu fluxo de trabalho. Exemplo de prompt: “Sync my library to ~/notes/web2md, tag ‘research’ only”

list_skills

Lista as Skills salvas na sua conta em nuvem do Web2MD como um array compacto (id, nome, descrição). Use get_skill para buscar uma por completo. Exemplo de prompt: “What skills do I have saved?“

get_skill

Busca o corpo completo, no estilo SKILL.md, de uma Skill por id ou nome — suas instruções, descrição e conteúdo na íntegra. Use list_skills primeiro se não souber o id. Exemplo de prompt: “Get my ‘summarize’ skill”

semantic_search / get_conversion (descontinuadas)

Essas duas ferramentas são anteriores à Library. Ainda funcionam, mas enxergam apenas conversões salvas pela antiga API de histórico, não a Library completa — novas integrações devem usar search_library e get_library_items.

Autenticação

O servidor resolve a chave de API nesta ordem:

Variável de ambiente WEB2MD_API_KEY, se definida.
Caso contrário, ~/.web2md/config.json — o mesmo arquivo escrito por npx web2md-cli login (o fluxo de login por dispositivo do CLI). Execute login uma vez e tanto o CLI quanto o servidor MCP capturam a chave automaticamente, sem precisar de bloco env.

Se nenhuma das duas for encontrada, o servidor inicia, mas toda chamada de ferramenta retorna um erro de autenticação com uma dica para definir a chave ou executar login.

Configuração

Claude Desktop
Cursor
Windsurf

Abra o arquivo de configuração do Claude Desktop:

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

Adicione a entrada web2md em mcpServers:

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

Se você já executou npx web2md-cli login, pode remover o bloco env inteiramente — o servidor lê a chave de ~/.web2md/config.json.Reinicie o Claude Desktop. Você deve ver as ferramentas do Web2MD aparecerem no seletor de ferramentas.

Abra o arquivo de configuração MCP do Cursor em ~/.cursor/mcp.json e adicione:

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

Reinicie o Cursor para carregar o novo servidor.

Abra o arquivo de configuração MCP do Windsurf em ~/.windsurf/mcp.json e adicione:

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

Reinicie o Windsurf para carregar o novo servidor.

Exemplos de uso

Com o servidor MCP em execução, você pode usar linguagem natural no seu assistente de IA:

Converter uma página em Markdown

Você: Convert this URL to markdown: https://react.dev/learn/thinking-in-reactAssistente: (chama convert_url) Aqui está o Markdown convertido de “Thinking in React”…

Buscar e trazer conteúdo da sua Library

Você: Search my library for anything about authentication, then get the full content of the most recent oneAssistente: (chama search_library, depois get_library_items) Encontrei 3 itens relacionados a autenticação. Aqui está o conteúdo completo do mais recente, “OAuth 2.0 Guide”…

Sincronizar sua Library localmente

Você: Sync my library to ~/notes/web2mdAssistente: (chama sync_library) 42 itens novos sincronizados, 118 já atualizados, 0 com falha.

Conversão em lote com a extensão

Você: Batch-convert these 8 Reddit threads: […]Assistente: (chama agent_batch_convert) 8/8 URLs convertidas com sucesso.

Aplicar uma Skill salva

Você: What skills do I have, and can you apply “summarize” to this page: https://…Assistente: (chama list_skills, depois agent_convert com skill: "summarize") Aqui está a página convertida em Markdown, com a skill de resumo aplicada logo abaixo…

Combine ferramentas em uma única conversa. Por exemplo: “Search my library for React docs, then get the full content of the most recent one.”

Solução de problemas

As ferramentas não aparecem depois da configuração

Certifique-se de ter reiniciado o aplicativo depois de editar o arquivo de configuração. Verifique se npx -y web2md-mcp-server executa com sucesso no seu terminal.

Erros de autenticação

Confira se WEB2MD_API_KEY é uma chave w2m_ válida, ou se ~/.web2md/config.json tem uma (execute novamente npx web2md-cli login se não tiver certeza). Você pode verificar sua chave na página de chaves de API.

agent_convert / agent_batch_convert / bridge_convert_url falham

Essas ferramentas requerem o Chrome aberto com a extensão do Web2MD instalada e — para as ferramentas agent_* — o host nativo também instalado. Veja Agent Bridge para a configuração.

npx não consegue resolver o pacote

Tente instalar o pacote globalmente primeiro: npm install -g web2md-mcp-server, depois altere o command para web2md-mcp-server e remova o campo args.

Primeiros passos

Recursos principais

Avançado

Planos

Visão geral

Ferramentas disponíveis

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

Autenticação

Configuração

Exemplos de uso

Solução de problemas

​Visão geral

​Ferramentas disponíveis

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

​Autenticação

​Configuração

​Exemplos de uso

​Solução de problemas

Visão geral

Ferramentas disponíveis

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

Autenticação

Configuração

Exemplos de uso

Solução de problemas