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 no seu histórico de conversões ou recuperar Markdown salvo sem sair da conversa.O servidor MCP requer uma chave de API do Web2MD (plano PRO). Gere uma no painel.
Ferramentas disponíveis
O servidor MCP oferece três ferramentas:convert_url
Busca uma URL e retorna o conteúdo da página como Markdown. Suporta as mesmas opções de conversão da REST API. Exemplo de prompt: “Convert this URL to markdown: https://docs.example.com/getting-started”semantic_search
Busca em todas as suas conversões salvas anteriormente usando uma consulta em linguagem natural. Retorna uma lista de conversões correspondentes com títulos, URLs e pontuações de relevância. Exemplo de prompt: “Search my saved pages for articles about database indexing”get_conversion
Recupera o conteúdo completo em Markdown de uma conversão salva específica pelo seu ID. Útil para trazer um documento completo para o contexto depois de encontrá-lo comsemantic_search.
Exemplo de prompt: “Get the full content of conversion abc123”
Configuração
- Claude Desktop
- Cursor
- Windsurf
Abra o arquivo de configuração do Claude Desktop:Reinicie o Claude Desktop. Você deve ver as ferramentas do Web2MD aparecerem no seletor de ferramentas.
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
web2md em mcpServers: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
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 conversões salvas
Buscar conversões salvas
Você: Search my saved pages for anything about authenticationAssistente: (chama
semantic_search) Encontrei 3 conversões salvas relacionadas a autenticação:- “OAuth 2.0 Guide” — salva há 2 dias
- “JWT Best Practices” — salva na semana passada
- …
Recuperar uma conversão completa
Recuperar uma conversão completa
Você: Get the full content of conversion abc123Assistente: (chama
get_conversion) Aqui está o conteúdo completo em Markdown…Solução de problemas
As ferramentas não aparecem depois da configuração
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 web2md-mcp executa com sucesso no seu terminal.Erros de autenticação
Erros de autenticação
Confira se sua
WEB2MD_API_KEY está correta e se sua assinatura PRO está ativa. Você pode verificar sua chave na página de chaves de API.npx não consegue resolver o pacote
npx não consegue resolver o pacote
Tente instalar o pacote globalmente primeiro:
npm install -g web2md-mcp, depois altere o command para web2md-mcp e remova o campo args.