Как подключить Tavily к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Tavily, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Tavily + Gemini

Дайте своему ИИ веб-поиск в реальном времени, созданный для агентов, с Tavily: ищите в интернете или в новостях с коротким ответом и источниками, читайте страницы как чистый текст, стройте карты сайтов и обходите их, запускайте более долгие исследования и проверяйте свои кредиты.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

TAVILY_API_KEY

Шаг 1 — Получите учётные данные

1. Войдите на https://app.tavily.com. Бесплатный план включает 1 000 кредитов в месяц, карта не нужна.
2. Скопируйте API-ключ со страницы обзора (он начинается с tvly-) или создайте новый.
3. Вставьте его в TAVILY_API_KEY в том виде, в каком его показывает Tavily, без слова Bearer, и установите коннектор. Ключ отправляется только в Tavily.
4. Начните с tavily_get_usage: он показывает, сколько кредитов израсходовали ваш ключ и ваш план и сколько осталось.

Оплата из ваших собственных кредитов Tavily: поиск, извлечение, карты сайтов, обходы и исследовательские отчёты расходуют кредиты вашего аккаунта Tavily, и каждый ответ сообщает, сколько было потрачено. Коннектор использует экономные настройки по умолчанию, пока вы не попросите большего:

• Поиск: 1 кредит за базовый поиск, 2 за расширенный.
• Извлечение: 1 кредит за 5 страниц, 2 при расширенном извлечении.
• Карта сайта: 1 кредит за 10 найденных страниц.
• Обход: карта сайта плюс извлечение прочитанных страниц.
• Исследовательский отчёт: от 4 до 110 кредитов с моделью mini, от 15 до 250 с pro.

Что умеет: поиск по вебу, новостям и финансам с ранжированными источниками и необязательным коротким ответом, с ограничением по дате или по выбранным вами доменам; содержимое до 20 страниц в виде чистого markdown или только фрагменты, которые отвечают на вопрос; список страниц сайта (карта) или карта и извлечение за один раз (обход); а также исследовательские отчёты, которые исследовательский агент Tavily составляет по множеству поисковых запросов, на это уходит примерно от 30 секунд до нескольких минут.

Ограничение по времени: вызов через коннектор прерывается через 30 секунд, поэтому для обходов и карт по умолчанию заданы небольшие лимиты. Исследование выполняется в фоне: ИИ запускает его и проверяет статус, пока отчёт не будет готов.

Недоверенный контент: результаты поиска и страницы приходят из открытого интернета. ИИ воспринимает найденные в них инструкции как данные, а не как команды.

Частые ошибки: 401 означает, что ключ неверный, отозван или отсутствует. 432: ключ или план исчерпал кредиты; перейдите на более высокий план или поднимите лимит ключа в панели Tavily. 433: достигнут лимит pay-as-you-go для аккаунта; поднимите его в панели. 429: слишком много запросов за короткое время. 400 или 422: недопустимый параметр, например дата, записанная не в формате YYYY-MM-DD.

Коннектор не передаёт исследовательские отчёты потоком, не читает журналы запросов и не управляет использованием и ключами организации.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Tavily.

Доступные инструменты

Примеры запросов

• «Найдите новости за последнюю неделю о применении Закона ЕС об ИИ и дайте краткое резюме с источниками.»
• «Прочитайте эти три страницы с ценами и сравните тарифы в таблице.»
• «Постройте карту раздела документации нашего сайта и перечислите все страницы про аутентификацию.»
• «Подготовьте исследовательский отчёт о субсидиях на тепловые насосы в Германии в 2026 году и скажите, сколько кредитов он израсходовал.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT