개요
Web2MD MCP server는 Model Context Protocol (MCP) — AI 모델을 외부 도구 및 데이터 소스에 연결하기 위한 개방형 표준 — 을 사용하여 Web2MD를 AI 어시스턴트가 직접 호출할 수 있는 도구 세트로 노출합니다. 설정을 완료하면 대화창을 벗어나지 않고도 Claude, Cursor, Windsurf에게 페이지 변환, 변환 기록 검색, 저장된 Markdown 조회를 요청할 수 있습니다.MCP server를 사용하려면 Web2MD API key(PRO 플랜)가 필요합니다. dashboard에서 발급받으세요.
사용 가능한 도구
MCP server는 세 가지 도구를 제공합니다.convert_url
URL을 가져와 페이지 콘텐츠를 Markdown으로 반환합니다. REST API와 동일한 변환 옵션을 지원합니다. 예시 프롬프트: “이 URL을 markdown으로 변환해줘: https://docs.example.com/getting-started”semantic_search
자연어 쿼리를 사용해 이전에 저장한 모든 변환 기록을 검색합니다. 제목, URL, 관련도 점수가 포함된 일치하는 변환 목록을 반환합니다. 예시 프롬프트: “저장한 페이지 중에서 데이터베이스 인덱싱 관련 글을 찾아줘”get_conversion
특정 저장된 변환의 전체 Markdown 콘텐츠를 ID로 조회합니다.semantic_search로 찾은 문서를 완전한 형태로 컨텍스트에 가져올 때 유용합니다.
예시 프롬프트: “conversion abc123의 전체 내용을 가져와줘”
설정
- Claude Desktop
- Cursor
- Windsurf
Claude Desktop 설정 파일을 여세요.Claude Desktop을 재시작하세요. 도구 선택창에 Web2MD 도구가 나타나는 것을 확인할 수 있습니다.
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
mcpServers 아래에 web2md 항목을 추가하세요.사용 예시
MCP server가 실행 중이면 AI 어시스턴트에서 자연어를 사용할 수 있습니다.페이지를 Markdown으로 변환
페이지를 Markdown으로 변환
사용자: 이 URL을 markdown으로 변환해줘: https://react.dev/learn/thinking-in-react어시스턴트: (
convert_url 호출) “Thinking in React”의 변환된 Markdown입니다…저장된 변환 검색
저장된 변환 검색
사용자: 저장한 페이지 중에서 인증 관련 내용을 찾아줘어시스턴트: (
semantic_search 호출) 인증 관련 저장된 변환을 3개 찾았습니다.- “OAuth 2.0 Guide” — 2일 전 저장
- “JWT Best Practices” — 지난주 저장
- …
전체 변환 내용 조회
전체 변환 내용 조회
사용자: conversion abc123의 전체 내용을 가져와줘어시스턴트: (
get_conversion 호출) 전체 Markdown 콘텐츠입니다…문제 해결
설정 후 도구가 나타나지 않아요
설정 후 도구가 나타나지 않아요
설정 파일을 수정한 뒤 애플리케이션을 재시작했는지 확인하세요. 터미널에서
npx web2md-mcp가 정상적으로 실행되는지 확인하세요.인증 오류가 발생해요
인증 오류가 발생해요
WEB2MD_API_KEY가 올바른지, PRO 구독이 활성화되어 있는지 다시 확인하세요. API keys 페이지에서 키를 확인할 수 있습니다.npx가 패키지를 찾지 못해요
npx가 패키지를 찾지 못해요
먼저 패키지를 전역으로 설치해보세요:
npm install -g web2md-mcp. 그런 다음 command를 web2md-mcp로 변경하고 args 필드를 제거하세요.