Tavily MCP
- 추천0
- GitHub 별2.5K
- 검색원격 연결라이선스MIT
Tavily 검색 · 추출 · 사이트 맵 · 크롤 도구로 에이전트에 실시간 웹 검색을 주는 MCP 서버(원격 · 로컬 NPX)
연결 · 설치 방법은 설치 탭에 정리했어요.
설명
Tavily MCP 서버
Tavily MCP 서버가 제공하는 것:
- 검색, 추출, 맵, 크롤 도구
- tavily-search 도구로 하는 실시간 웹 검색
- tavily-extract 도구로 하는 웹 페이지의 지능형 데이터 추출
- 웹사이트의 구조화된 지도를 만드는 강력한 웹 매핑 도구
- 웹사이트를 체계적으로 탐색하는 웹 크롤러
📚 도움이 되는 자료
원격 MCP 서버
로컬에서 실행하는 대신 Tavily의 원격 MCP 서버에 바로 연결하세요. 로컬 설치나 설정 없이 매끄럽게 쓸 수 있습니다.
Tavily API 키와 함께 원격 MCP 서버 주소를 쓰면 됩니다.
https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>
tavily.com에서 Tavily API 키를 받으세요.
MCP 클라이언트가 지원한다면 API 키를 Authorization 헤더로 넘길 수도 있습니다.
Authorization: Bearer <your-api-key>
참고: 원격 MCP를 쓸 때는 원하는 기본값이 담긴 JSON 객체를 DEFAULT_PARAMETERS 헤더에 넣어 모든 요청의 기본 매개변수를 정할 수 있습니다. 예:
{"include_images":true, "search_depth": "basic", "max_results": 10}
Claude Code에 연결하기
Claude Code는 Anthropic의 공식 Claude CLI 도구입니다. claude mcp add 명령으로 Tavily MCP 서버를 추가할 수 있습니다. 인증 방법은 두 가지입니다.
방법 1: 주소에 API 키 넣기
API 키를 주소에 직접 넣으세요. <your-api-key>를 실제 Tavily API 키로 바꾸세요.
claude mcp add --transport http tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>
방법 2: OAuth 인증 흐름
주소에 API 키 없이 서버를 추가합니다.
claude mcp add --transport http tavily https://mcp.tavily.com/mcp
추가한 뒤에는 인증 흐름을 마쳐야 합니다.
claude를 실행해 Claude Code를 시작합니다/mcp를 입력해 MCP 서버 관리를 엽니다- Tavily 서버를 골라 인증을 마칩니다
팁: 두 명령 중 아무 곳에나 --scope user를 붙이면 모든 프로젝트에서 Tavily MCP 서버를 쓸 수 있습니다.
claude mcp add --transport http --scope user tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>
설정하고 나면 Tavily의 검색, 추출, 맵, 크롤 도구를 쓸 수 있습니다.
Cursor에 연결하기
⬆️ Add to Cursor ⬆️ 버튼을 누르세요. 대부분 알아서 해 주지만, API 키를 넣으려면 설정을 직접 고쳐야 합니다. Tavily API 키는 여기에서 받을 수 있습니다.
버튼을 누르면 Cursor로 이동합니다 ...
1단계
설치 버튼을 누릅니다.

2단계
이제 MCP가 설치된 것이 보입니다. 파란 스위치가 켜져 있지 않다면 직접 켜세요. 자신의 Tavily API 키를 넣도록 설정도 고쳐야 합니다.

3단계
그러면 mcp.json 파일로 이동하는데, 거기에 your-api-key를 넣어야 합니다.
{
"mcpServers": {
"tavily-remote-mcp": {
"command": "npx -y mcp-remote https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>",
"env": {}
}
}
}
원격 MCP 서버 OAuth 흐름
Tavily 원격 MCP 서버는 안전한 OAuth 인증을 지원해서, 호환되는 클라이언트에서 매끄럽게 연결하고 승인할 수 있습니다.
OAuth 인증을 설정하는 방법
A. MCP Inspector 쓰기:
- MCP Inspector를 열고 "Open Auth Settings"를 누릅니다.
- OAuth 흐름을 고르고 다음 단계를 마칩니다.
- 메타데이터 탐색
- 클라이언트 등록
- 승인 준비
- 승인 요청과 승인 코드 받기
- 토큰 요청
- 인증 완료
마치면 액세스 토큰을 받으며, 이 토큰으로 Tavily 원격 MCP 서버에 안전하게 인증된 요청을 보낼 수 있습니다.
B. 다른 MCP 클라이언트 쓰기(예: Cursor):
Tavily API 키를 주소에 넣지 않고 OAuth를 쓰도록 MCP 클라이언트를 설정할 수 있습니다. 예를 들어 mcp.json에서:
{
"mcpServers": {
"tavily-remote-mcp": {
"command": "npx mcp-remote https://mcp.tavily.com/mcp",
"env": {}
}
}
}
저장된 OAuth 자격 증명을 지우고 다시 인증해야 한다면 다음을 실행하세요.
rm -rf ~/.mcp-auth
💡 참고 OAuth 인증은 선택 사항입니다. 위에서 설명한 대로 Tavily API 키를 주소의 쿼리 매개변수(
?tavilyApiKey=...)에 넣거나Authorization헤더에 설정해서 API 키 인증을 언제든 쓸 수 있습니다.
OAuth에 쓸 계정 고르기
연결할 때마다 Tavily는 개인 계정을 쓸지 소속 조직 중 하나를 쓸지 묻습니다. Tavily 로그인을 바꾸려면 Use a different account를 고르세요.
- 쓰는 키: 그 계정의
mcp_auth_default키입니다. 없으면 Tavily가 만듭니다. - 조직 키: 다른 구성원이 만든 키이거나 조직이 키 접근을 제한해도 쓰입니다.
- 개인 계정이 꺼진 경우: 소속 조직이 개인 계정을 끄면 Personal은 표시되지 않습니다.
- 접근을 잃은 경우: 계정에 접근할 수 없게 되었거나 키가 삭제되면 요청이 실패하고 다시 연결하라고 안내합니다. Tavily는 스스로 계정을 바꾸지 않습니다.
로컬 MCP
준비물 🔧
시작하기 전에 다음을 갖추세요.
- Tavily API 키
- Tavily API 키가 없다면 여기에서 무료 계정으로 가입할 수 있습니다
- Claude Desktop 또는 Cursor
- Node.js(v20 이상)
- 다음 명령으로 Node.js 설치를 확인할 수 있습니다:
node --version
- Git 설치(Git 설치 방식을 쓸 때만 필요)
- macOS:
brew install git - Linux:
- Debian/Ubuntu:
sudo apt install git - RedHat/CentOS:
sudo yum install git
- Debian/Ubuntu:
- Windows: Git for Windows를 내려받습니다
- macOS:
NPX로 실행하기
npx -y tavily-mcp@latest
기본 매개변수 설정 ⚙️
DEFAULT_PARAMETERS 환경 변수로 tavily-search 도구의 기본 매개변수 값을 정할 수 있습니다. 요청마다 이 매개변수를 지정하지 않아도 기본 검색 동작을 설정할 수 있습니다.
설정 예시
export DEFAULT_PARAMETERS='{"include_images": true}'
클라이언트에서 쓰는 예시
{
"mcpServers": {
"tavily-mcp": {
"command": "npx",
"args": ["-y", "tavily-mcp@latest"],
"env": {
"TAVILY_API_KEY": "your-api-key-here",
"DEFAULT_PARAMETERS": "{\"include_images\": true, \"max_results\": 15, \"search_depth\": \"advanced\"}"
}
}
}
}
최종 사용자 구분하기(선택)
TAVILY_HUMAN_ID 환경 변수를 정해 요청을 보내는 대상 최종 사용자를 구분할 수 있습니다. 정하면 Tavily MCP는 모든 API 호출에 X-Human-Id 헤더로 이 값을 전달해 사용자별 분석을 가능하게 합니다.
이것은 전적으로 선택 사항입니다. 정하지 않으면 동작은 그대로입니다.
{
"mcpServers": {
"tavily-mcp": {
"command": "npx",
"args": ["-y", "tavily-mcp@latest"],
"env": {
"TAVILY_API_KEY": "your-api-key-here",
"TAVILY_HUMAN_ID": "your-user-id"
}
}
}
}
개인정보 참고: Tavily는 저장하기 전에 서버에서 human_id를 해시(SHA-256)하므로 원래 값은 저장되지 않습니다. 그래도 가능하면 이메일 같은 개인정보 대신 불투명한 식별자(예: 내부 사용자 ID)를 쓰세요.
감사의 말 ✨
- MCP 사양을 만든 Model Context Protocol
- Claude Desktop을 만든 Anthropic
저장소: tavily-ai/tavily-mcp