/ 디렉터리 / 플레이그라운드 / Tavily MCP
● 공식 tavily-ai 🔑 본인 키 필요

Tavily MCP

제작: tavily-ai · tavily-ai/tavily-mcp

Tavily MCP는 에이전트 웹 검색, 페이지 추출, 사이트 맵 및 크롤링을 제공합니다. 이미 LLM용으로 형식이 지정되어 있으므로 스크랩된 마크업에 토큰을 낭비하지 않습니다.

Tavily는 AI 에이전트를 위해 설계된 검색 API입니다. 답변은 50KB의 HTML이 아닌 소스가 포함된 깨끗한 텍스트로 반환됩니다. MCP 서버는 실제 연구 워크플로우로 구성할 수 있는 네 가지 도구(검색, 추출, 매핑, 크롤링)를 제공합니다. tavily.com의 무료 API 키가 필요합니다. Claude Desktop, Cursor, Windsurf, Claude Code에서 바로 작동합니다. npx를 통해 설치하세요.

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

tavily-mcp.replay ▶ 준비됨
0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ],
      "env": {
        "TAVILY_API_KEY": "tvly-..."
      }
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ],
      "env": {
        "TAVILY_API_KEY": "tvly-..."
      }
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ],
      "env": {
        "TAVILY_API_KEY": "tvly-..."
      }
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ],
      "env": {
        "TAVILY_API_KEY": "tvly-..."
      }
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "tavily-mcp",
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@latest"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json
{
  "context_servers": {
    "tavily-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "tavily-mcp@latest"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add tavily-mcp -- npx -y tavily-mcp@latest

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Tavily MCP

모델 중단 이후 발생한 일에 대한 질문에 답하세요.

👤 새로운 정보가 필요한 질문이 있는 경우 Claude를 사용하는 사람 ⏱ ~5 min beginner

언제 쓸까: 2026년 릴리스, 최근 CVE, 새 가격 페이지 또는 현재 시장에 대해 질문하면 모델은 알지 못하므로 직접 확인해야 합니다.

사전 조건
  • 타빌리 API 키 — tavily.com에 가입하세요(무료 등급 = 통화 1,000건/월)
  • Tavily MCP 설치 — 위의 구성 블록을 클라이언트의 MCP 설정에 붙여넣습니다.
흐름
  1. 직접 물어보세요
    이번 달 Claude Sonnet 4.7에서 Anthropic은 무엇을 출시했습니까? Tavily를 사용하여 공지사항을 찾고 출처와 함께 요약하세요.✓ 복사됨
    → 상담원이 tavily_search를 호출하고 연결된 소스가 포함된 요약을 반환합니다.
  2. 단일 소스에 대한 심층 분석
    두 번째 소스는 가장 권위 있어 보입니다. tavily_extract를 사용하여 전체 텍스트를 가져오고 컨텍스트 창에 대한 정확한 줄을 인용하세요.✓ 복사됨
    → URL + 단락 번호를 포함한 직접 인용

결과: 현재 인용된 답변을 한 번에 - 수동으로 검색할 필요가 없습니다.

함정
  • 반환된 SEO 정크를 먼저 검색하세요. — 사이트 힌트 추가: '... anthropic.com 또는 anthropic의 공식 블로그에서'
  • 소스에서 요약이 표류함 — 직접 인용 필요 - '다른 말로 표현하되 숫자, 날짜, 이름을 정확하게 유지'
함께 쓰기: filesystem · memory

한 세션으로 경쟁 제품 스캔 수행

👤 PM, 창립자, 마케팅 담당자 ⏱ ~30 min intermediate

언제 쓸까: 하루가 끝날 때까지 특정 기능 카테고리에 대한 모든 경쟁업체에 대한 한 페이지 분량의 개요가 필요합니다.

흐름
  1. 경쟁사 발굴
    Tavily를 이용해 '중소기업용 AI 네이티브 CRM'에서 우리와 경쟁하는 상위 8개 제품을 찾아보세요. 각각에 대해 이름, URL, 한 줄, 창립 연도를 반환합니다.✓ 복사됨
    → 소스 링크가 포함된 구조화된 8행 테이블
  2. 각 사이트 지도
    각 경쟁업체에 대해 사이트를 tavily_map하여 가격 및 기능 페이지를 찾으세요. URL을 반환합니다.✓ 복사됨
    → 경쟁사당 URL 2개
  3. 가격 추출
    tavily_각 가격 페이지를 추출하고 비교 그리드(요금제 이름, 월별 가격, 상위 3개 차별화 요소)를 구축합니다.✓ 복사됨
    → 깨끗한 그리드; 셀은 가격 페이지 URL을 인용합니다.

결과: 소스와 공유 가능한 요약 — 30분 안에 PMM 슬라이드 준비가 완료되었습니다.

함정
  • JS 렌더링 및 추출 가격 책정이 누락되었습니다. — render=on을 사용하여 tavily_crawl로 돌아가거나 /pricing 사이트맵을 직접 누르세요.
함께 쓰기: filesystem

실시간으로 검증된 링크가 포함된 튜토리얼 작성

👤 기술 작가, DevRel ⏱ ~25 min intermediate

언제 쓸까: 방법을 게시하고 있으며 모든 외부 링크는 오늘 올바른 콘텐츠로 연결되어야 합니다.

흐름
  1. 후보심사 수집
    tavily_search를 사용하여 'OAuth 2.1 PKCE 흐름'에 대한 상위 5개 표준 문서 페이지를 찾습니다. 블로그보다 RFC 및 공급업체 문서를 선호하세요.✓ 복사됨
    → 각각 짧은 근거가 포함된 URL 5개
  2. 하나하나 확인해보세요
    tavily_extract 각 URL. 각각에 대해 페이지에 여전히 PKCE가 포함되어 있는지 확인하고 리디렉션되거나 오래된 것으로 보이는 항목에 플래그를 지정하세요.✓ 복사됨
    → URL별 실시간 평가
  3. 초안에 포함
    페이지의 실제 제목과 일치하는 앵커 텍스트를 사용하여 확인된 URL만 인용하도록 튜토리얼 초안을 다시 작성하세요.✓ 복사됨
    → 업데이트된 초안 모든 링크 텍스트가 실제 페이지 제목과 일치합니다.

결과: 데드 링크가 없고 정확한 앵커 텍스트가 포함된 튜토리얼이 게시되었습니다.

함께 쓰기: filesystem

조합

다른 MCP와 조합해 10배 효율

tavily-mcp + filesystem

검색하고 디스크로 추출한 다음 다시 가져오지 않고 로컬로 분석합니다.

Tavily에서 최근 OWASP 상위 10개 소스를 검색하여 추출하고 /research/owasp/에 저장한 다음 오프라인에서 콘텐츠를 비교합니다.✓ 복사됨
tavily-mcp + memory

세션 간에 지속되는 연구 저널 작성

각 Tavily 검색에 대해 한 줄짜리 메모와 URL을 'project:acme' 아래 메모리에 저장하세요. 다음 세션, 재사용하세요.✓ 복사됨
tavily-mcp + context7

웹 컨텍스트용 Tavily + 라이브러리 문서용 Context7 - 혼동하지 마세요.

문서 관련 질문에는 Context7을 사용하세요. 뉴스, 블로그 게시물 및 도서관 색인에 없는 모든 항목에 대해 Tavily를 사용합니다.✓ 복사됨

도구

이 MCP가 노출하는 것

도구입력언제 호출비용
tavily_search query: str, max_results?: int, search_depth?: 'basic'|'advanced', include_domains?: str[] 기본 도구 - 하나의 쿼리, URL이 포함된 LLM 지원 스니펫 1 API call
tavily_extract urls: str[], extract_depth?: 'basic'|'advanced' 이미 URL이 있고 깨끗한 텍스트를 원합니다. HTML이나 광고가 없습니다. 1 API call per URL
tavily_map url: str, max_depth?: int, categories?: str[] 사이트 구조 검색 - 추출/크롤링 전에 유용함 1 API call
tavily_crawl url: str, max_depth?: int, limit?: int, instructions?: str 소규모 사이트 또는 문서 섹션의 광범위한 수집 - 비용이 많이 들기 때문에 URL을 이미 알고 있는 경우 추출을 선호합니다. Multiple API calls (one per page)

비용 및 제한

운영 비용

API 쿼터
무료 등급 = 월별 API 호출 1,000개 월 $30부터 확장 계획
호출당 토큰
~500~5000개의 깨끗한 콘텐츠 토큰을 반환합니다. 이는 원시 HTML보다 훨씬 적습니다.
금액
무료 등급에는 개인의 일일 사용이 포함됩니다. 무거운 작업 흐름에는 비용이 필요합니다
tavily_crawl보다 tavily_search를 선호합니다. 검색은 한 번의 호출이고 크롤링은 N입니다. 실제로 폭이 필요한 경우에만 크롤링합니다.

보안

권한, 시크릿, 파급범위

자격 증명 저장: env var의 TAVILY_API_KEY(MCP 구성의 env 블록에 설정됨)
데이터 외부 송신: 귀하가 전달하는 쿼리와 URL은 api.tavily.com으로 전송됩니다. 쿼리 문자열에 독점 정보를 붙여넣지 마세요.

문제 해결

자주 발생하는 오류와 해결

401 무단

MCP 구성에서 TAVILY_API_KEY를 다시 확인하세요. env 블록은 최상위 수준이 아닌 서버 구성 내부에 있습니다.

확인: Call any Tavily tool; if the error persists, rotate the key in tavily.com dashboard
실제 쿼리에도 불구하고 빈 결과

틈새 주제의 경우 검색 심도를 '기본'에서 '고급'으로 전환하세요. 신뢰할 수 있는 소스에 대한 편향을 위해 include_domains를 추가하세요.

확인: Repeat with search_depth: 'advanced'
tavily_extract는 페이월로 된 횡설수설을 반환합니다.

Tavily는 robots.txt를 따르고 페이월을 존중합니다. 페이월 콘텐츠의 경우 연결할 수 없다는 점에 유의하세요. 우회하려고 시도하지 마세요.

429 비율 제한

무료 등급 = 60RPM. 시간을 두고 통화하거나 tavily.com에서 업그레이드하세요. MCP는 한 번 자동으로 백오프된 후 오류를 표시합니다.

확인: Check usage in tavily.com dashboard

대안

Tavily MCP 다른 것과 비교

대안언제 쓰나단점/장점
exa-mcp-serverExa의 신경/임베딩 스타일 검색 및 유사성을 원합니다.다양한 쿼리 유형에 따라 결과 품질이 다릅니다. 둘 다 LLM 조정되었습니다
fetchURL이 있고 HTML → 마크다운만 원하고 검색은 필요하지 않습니다.검색이 없습니다. 구조화된 추출물 없음; 당신은 URL 발견을 처리합니다
perplexity-ask원시 결과가 아닌 Perplexity를 통해 합성된 연구 수준의 답변을 원합니다.더 높은 대기 시간, 더 높은 비용, 더 적은 구성 가능성 - 하나의 큰 도구입니다.
firecrawl-mcp-server핵심 워크플로로 과도한 크롤링이나 JS 렌더링이 필요한 경우더 비싸다; 일회성 조회에 대한 과잉

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기