tavily-mcp — MCP-сервер для Claude Code: поиск в вебе и разбор страниц
Даёт агенту инструменты поиска, извлечения данных, карты сайта и обхода страниц через Tavily. Пригодится, когда нужен свежий веб-контекст прямо в редакторе.
claude mcp add --env TAVILY_API_KEY=<TAVILY_API_KEY> --env DEFAULT_PARAMETERS=<DEFAULT_PARAMETERS> --transport stdio tavily-mcp -- npx -y tavily-mcpЧто делает tavily-mcp
tavily-mcp подключает к ассистенту четыре инструмента: tavily-search ищет в вебе, tavily-extract вытаскивает данные со страниц, map строит структуру сайта, crawl обходит его по ссылкам. Работает как локально через npx -y tavily-mcp, так и удалённо — по адресу https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>. Второй вариант не требует ничего ставить на машину.
Для локального запуска нужен Node.js v20 или выше и ключ Tavily. Ключ передаётся переменной TAVILY_API_KEY; через неё же можно задать DEFAULT_PARAMETERS — JSON с параметрами по умолчанию для всех запросов, например {"include_images":true, "search_depth": "basic", "max_results": 10}. Удалённый сервер умеет OAuth: добавьте его без ключа в URL, откройте /mcp в Claude и пройдите авторизацию. Без ключа и без OAuth инструменты не заработают.
Если ключей в аккаунте несколько, OAuth возьмёт тот, что назван mcp_auth_default; личный приоритетнее командного. Сбросить сохранённые учётные данные можно командой rm -rf ~/.mcp-auth — это пригодится, когда авторизация зависла на старом ключе.
Какие задачи решает
- найти свежую документацию по библиотеке, которой нет в обучающих данных модели
- вытащить текст и таблицы с чужой страницы без ручного копирования
- построить карту разделов сайта перед парсингом
- обойти сайт по ссылкам и собрать нужные страницы
- подключить веб-поиск к агенту в Cursor или Claude
Примеры запросов агенту
- Найди через tavily-search, как в последней версии Next.js настраивается middleware.
- Извлеки tavily-extract оглавление и цены с этой страницы.
- Построй карту сайта docs.example.com и покажи разделы про авторизацию.
Как установить tavily-mcp
Командой платформы
claude mcp add --env TAVILY_API_KEY=<TAVILY_API_KEY> --env DEFAULT_PARAMETERS=<DEFAULT_PARAMETERS> --transport stdio tavily-mcp -- npx -y tavily-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add tavily-mcp --env TAVILY_API_KEY=<TAVILY_API_KEY> --env DEFAULT_PARAMETERS=<DEFAULT_PARAMETERS> -- npx -y tavily-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"tavily-mcp": {
"command": "npx",
"args": [
"-y",
"tavily-mcp"
],
"env": {
"TAVILY_API_KEY": "<TAVILY_API_KEY>",
"DEFAULT_PARAMETERS": "<DEFAULT_PARAMETERS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"tavily-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"tavily-mcp"
],
"env": {
"TAVILY_API_KEY": "<TAVILY_API_KEY>",
"DEFAULT_PARAMETERS": "<DEFAULT_PARAMETERS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e TAVILY_API_KEY=<TAVILY_API_KEY> -e DEFAULT_PARAMETERS=<DEFAULT_PARAMETERS> tavily-mcp npx -y tavily-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о tavily-mcp
Как установить tavily-mcp в Claude Code?
Выполните claude mcp add tavily-mcp -e TAVILY_API_KEY=<TAVILY_API_KEY> -- npx -y tavily-mcp. Если нужны параметры по умолчанию, используйте вариант с --env DEFAULT_PARAMETERS=<DEFAULT_PARAMETERS> и --transport stdio.
Что делает tavily-mcp?
Даёт ассистенту четыре инструмента: поиск в вебе, извлечение данных со страниц, построение карты сайта и обход сайта по ссылкам.
Можно ли подключить без локальной установки?
Да, есть удалённый сервер по адресу https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>. Ключ можно передать в URL или заголовком Authorization: Bearer <your-api-key>, а если клиент поддерживает OAuth — пройти авторизацию без ключа.
