Tavily MCP

tavily-ai/tavily-mcp· Проверено 12.11.2026· 2,5 тыс.на GitHub

Подключает агента к поиску Tavily: свежая выдача по запросу, текст страниц по ссылкам, карта и обход сайта и многошаговое исследование темы с отчётом.

2 реализации:

Сервер на стороне Tavily, ставить ничего не нужно. Ключ передаётся заголовком Authorization; Claude Code умеет входить и через OAuth.

Как подключить

Что сделать до подключения

Ключ API Tavily или вход в аккаунт Tavily через OAuth

Authorization

app.tavily.com → бесплатная регистрация → ключ API; передаётся как Bearer <ключ>

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http tavily https://mcp.tavily.com/mcp \
  --header 'Authorization: Bearer <ключ Tavily>'

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.tavily]
url = "https://mcp.tavily.com/mcp"
http_headers = { "Authorization" = "Bearer <ключ Tavily>" }

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "tavily": {
      "url": "https://mcp.tavily.com/mcp",
      "headers": {
        "Authorization": "Bearer <ключ Tavily>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "tavily": {
      "type": "http",
      "url": "https://mcp.tavily.com/mcp",
      "headers": {
        "Authorization": "Bearer <ключ Tavily>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "tavily": {
      "httpUrl": "https://mcp.tavily.com/mcp",
      "headers": {
        "Authorization": "Bearer <ключ Tavily>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "tavily": {
      "httpUrl": "https://mcp.tavily.com/mcp",
      "headers": {
        "Authorization": "Bearer <ключ Tavily>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "tavily": {
        "type": "remote",
        "url": "https://mcp.tavily.com/mcp",
        "headers": {
          "Authorization": "Bearer <ключ Tavily>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://mcp.tavily.com/mcp
Request headers: Authorization: Bearer <ключ Tavily>

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "tavily": {
      "url": "https://mcp.tavily.com/mcp",
      "headers": {
        "Authorization": "Bearer <ключ Tavily>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

tavily_searchищет в интернете

tavily_extractдостаёт текст страниц по ссылкам

tavily_mapсобирает адреса страниц сайта

tavily_crawlобходит сайт с заданной глубиной

Запускается у вас через npx; без ключа работает в бесключевом режиме, где доступны только поиск и извлечение текста.

Как подключить

Что сделать до подключения

Node.js 20 или новее

Ключ API Tavily: бесплатная регистрация на app.tavily.com

TAVILY_API_KEY

app.tavily.com → бесплатная регистрация → ключ API

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'TAVILY_API_KEY=<ключ Tavily>' --transport stdio tavily-mcp \
  -- npx -y tavily-mcp@latest

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.tavily-mcp]
command = "npx"
args = ["-y", "tavily-mcp@latest"]

[mcp_servers.tavily-mcp.env]
TAVILY_API_KEY = "<ключ Tavily>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "<ключ Tavily>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "tavily-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "<ключ Tavily>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "<ключ Tavily>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "<ключ Tavily>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "tavily-mcp": {
        "type": "local",
        "command": ["npx", "-y", "tavily-mcp@latest"],
        "environment": {
          "TAVILY_API_KEY": "<ключ Tavily>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "<ключ Tavily>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "<ключ Tavily>"
      }
    }
  }
}

Инструменты сервера

tavily_searchищет в интернете

tavily_extractдостаёт текст страниц по ссылкам

tavily_mapсобирает адреса страниц сайта

tavily_crawlобходит сайт с заданной глубиной

tavily_researchисследует тему по многим источникам

tavily_feedbackотправляет отзыв о выдаче

Что попросить агента

«Найди последние новости про <тема> за неделю»Агент вызовет tavily_search с ограничением по времени

«Прочитай <адрес статьи> и выпиши только то, что касается <вопрос>»Агент вызовет tavily_extract с запросом для отбора нужных фрагментов

«Покажи структуру сайта <домен> и собери страницы раздела <раздел>»Агент вызовет tavily_map, затем tavily_crawl по нужному разделу

«Подготовь обзор рынка <тема> по нескольким источникам»Агент вызовет tavily_research и вернёт отчёт

Для каких задач

Найти свежие новости и факты, которых нет в знаниях модели

Прочитать страницу или PDF по ссылке и оставить только куски по теме

Собрать структуру сайта и обойти нужный раздел

Подготовить отчёт по теме из многих источников через tavily_research

Искать только по выбранным сайтам или исключить лишние домены

Ограничения

Все запросы обрабатывает облако Tavily и списывают лимит вашего ключа

Без ключа локальный сервер даёт только tavily_search и tavily_extract, остальные инструменты отвечают, что нужен ключ

Если не работает

После смены аккаунта OAuth сервер не переподключается

Удалите сохранённые данные входа командой rm -rf ~/.mcp-auth и пройдите вход заново.

Запросы перестали работать и просят переподключиться

Пропал доступ к аккаунту или удалён его ключ. Переподключитесь и выберите аккаунт: сам Tavily аккаунт не меняет.

Ошибка Invalid API key

Проверьте значение TAVILY_API_KEY или заголовка Authorization: ключ неверный или удалён.

Ошибка Usage limit exceeded

Сервис ответил кодом 429: лимит запросов по этому ключу исчерпан.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Tavily Remote MCPразработчик сервиса	Tavily	2,5 тыс.	HTTP	токен	4	5 ноября 2026
Tavily MCP (локальный)разработчик сервиса	Tavily	2,5 тыс.	локально	токен	6	5 ноября 2026

Частые вопросы

Как подключить к Claude Code?

Выполните claude mcp add --transport http tavily https://mcp.tavily.com/mcp, затем в Claude Code наберите /mcp, выберите Tavily и пройдите вход. С флагом --scope user сервер будет доступен во всех проектах.

Как задать параметры поиска по умолчанию?

Для локального сервера — переменной DEFAULT_PARAMETERS с JSON, например {"include_images": true, "max_results": 15, "search_depth": "advanced"}. Для удалённого — заголовком DEFAULT_PARAMETERS с тем же JSON.

С какого аккаунта списываются запросы при входе через OAuth?

При каждом подключении Tavily спрашивает, личный это аккаунт или организация. Используется ключ mcp_auth_default этого аккаунта, Tavily создаёт его сам, если ключа нет.

Чем Tavily отличается от Firecrawl?

Оба ищут и читают страницы. У Tavily есть tavily_research — исследование темы с готовым отчётом. Firecrawl шире: разбор PDF, клики в браузере, слежение за страницами.

Работает ли сервер из России?

Поиск идёт через облако Tavily, поэтому нужен доступ к tavily.com из вашей сети и аккаунт Tavily; регистрация бесплатная.

Tavily MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы