Tavily MCP — Claude Code MCP 서버

실시간 웹 검색·콘텐츠 추출·사이트 맵/크롤을 제공하는 공식 Tavily MCP 서버. LLM 친화적 검색 결과에 특화.

Tavily MCP는 Tavily에서 공식 제공하는 MCP(Model Context Protocol) 서버로, Claude Code 같은 LLM 에이전트에 실시간 웹 검색과 웹 콘텐츠 처리 능력을 붙여 줍니다. Tavily는 LLM·AI 에이전트의 리서치 용도로 설계된 검색 API로, 일반 검색엔진의 원시 결과 대신 모델이 바로 활용하기 좋은 형태로 정제된 결과를 돌려주는 데 특화돼 있습니다. 이를 MCP로 연결하면, 모델이 학습 시점 이후의 최신 정보나 사이트의 실제 내용을 도구 호출로 직접 가져와 답변에 반영할 수 있습니다.

주요 기능은 크게 네 가지입니다. (1) 웹 검색: 자연어 질의로 관련 출처를 찾고 LLM이 소화하기 쉬운 형태로 결과를 받습니다. (2) 콘텐츠 추출(extraction): 특정 URL의 본문 텍스트를 깔끔하게 추출해 노이즈를 줄입니다. (3) 사이트 맵/크롤링: 사이트 구조를 파악하거나 여러 페이지를 순회해 자료를 모읍니다. (4) 리서치 워크플로 지원: 검색→추출→정리로 이어지는 조사 작업을 도구 호출 단위로 자동화합니다.

이런 점에서 다음과 같은 사용자에게 유용합니다. 최신 사실 확인이나 출처 기반 답변이 필요한 사람, 경쟁/시장 조사처럼 여러 페이지를 모아 정리해야 하는 사람, 문서·기사 본문을 추출해 요약·분석하려는 사람, 에이전트형 워크플로에 "웹을 읽는" 능력을 더하려는 개발자입니다. 설치는 HTTP 트랜스포트 기반 원격 서버로 등록하며 Tavily API 키가 필요합니다. 구체적 도구 이름·매개변수·요금/사용량 정책은 버전에 따라 달라질 수 있으니 공식 문서(github.com/tavily-ai/tavily-mcp) 확인을 권장합니다.

언제 쓰나

모델이 학습 데이터에 없는 최신 정보를 가져와야 하거나, 출처 기반·사실 확인이 중요한 답변을 만들 때 적합합니다. 특정 URL의 본문을 추출해 요약·분석하거나, 사이트 여러 페이지를 크롤해 자료를 모으는 리서치 작업, 시장·경쟁 조사, 문서 수집 자동화에도 잘 맞습니다. 반대로 단발성·오프라인 작업이나 웹 접근이 불필요한 코드 작업에는 굳이 붙일 필요가 없습니다.

설치

claude mcp add --transport http tavily "https://mcp.tavily.com/mcp/?tavilyApiKey=<TAVILY_API_KEY>"

HTTP 트랜스포트 기반 원격 MCP 서버로 등록하며, 동작에 Tavily API 키(TAVILY_API_KEY)가 필요합니다. 키는 Tavily 계정에서 발급받아야 하고, 무료/유료 등급별 사용량·기능 제한이 적용될 수 있으니 등록 전 본인 요금제와 한도를 확인하세요. URL 쿼리스트링에 키가 포함되는 형태이므로 키 노출에 주의해야 합니다. 제공되는 도구 이름·옵션은 버전에 따라 달라질 수 있어 공식 저장소 문서로 최신 사양 확인을 권장합니다.

필요 키(직접 발급, 플레이스홀더): TAVILY_API_KEY

보안 주의

동작에 Tavily API 키(TAVILY_API_KEY)가 필요하며, 설치 명령에서 키가 URL 쿼리스트링에 들어가므로 셸 히스토리·로그·설정 파일·화면 공유로 유출되기 쉽습니다. 키는 비밀로 관리하고 커밋·출력 금지, 유출 시 즉시 회전하세요. 검색·추출은 외부 API로 질의가 전송되므로 사내 비밀·개인정보가 검색어로 새어 나가지 않게 주의해야 합니다. 또한 가져온 웹 본문에 프롬프트 인젝션(악성 지시문)이 섞여 있을 수 있으니, 추출 결과를 신뢰된 명령으로 다루지 말고 데이터로만 취급하세요. 사용량 기반 과금 가능성도 점검이 필요합니다.

자주 묻는 질문

Tavily MCP를 쓰려면 별도 API 키가 필요한가요?

네. Tavily 계정에서 발급한 TAVILY_API_KEY가 필요하며, 이 키로 검색·추출·크롤 요청이 인증됩니다. 등급별 사용량 한도와 과금 정책이 있을 수 있으니 본인 요금제를 확인하세요.

일반 웹 검색과 무엇이 다른가요?

Tavily는 LLM·AI 에이전트의 리서치 용도로 설계돼, 원시 검색 결과 대신 모델이 바로 활용하기 좋게 정제된 결과를 돌려주는 데 특화돼 있습니다. 검색뿐 아니라 URL 콘텐츠 추출과 사이트 맵/크롤도 함께 제공합니다.

가져온 웹 콘텐츠를 그대로 신뢰해도 되나요?

아니요. 외부 웹 본문에는 프롬프트 인젝션 같은 악성 지시가 섞일 수 있으므로 추출 결과는 명령이 아닌 데이터로만 다뤄야 합니다. 중요한 사실은 출처를 직접 확인하는 것이 안전합니다.