Сервер Tavily MCP

Сервер Tavily MCP предоставляет:

инструменты для поиска, извлечения, сопоставления и обхода
возможности поиска в сети в реальном времени через инструмент tavily-search
интеллектуальный парсинг и извлечение данных с веб-страниц через tavily-extract
мощный инструмент веб-картирования, создающий структурированную карту сайта
веб-краулер, который систематически исследует сайты

📚 Полезные ресурсы

[Руководство] по сочетанию Tavily MCP с Neo4j MCP server
[Руководство] по интеграции Tavily MCP с Cline в VS Code

Удалённый MCP сервер

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

Просто используйте URL удалённого MCP сервера вместе с вашим API-ключом Tavily:

https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>

Получите ваш Tavily API-ключ на tavily.com.

При этом клиент MCP может поддерживать передачу API-ключа через заголовок Authorization:

Authorization: Bearer <your-api-key>

Примечание: при использовании удалённого MCP вы можете задать параметры по умолчанию для всех запросов, добавив заголовок DEFAULT_PARAMETERS, содержащий JSON-объект с нужными значениями по умолчанию. Пример:

{"include_images":true, "search_depth": "basic", "max_results": 10}

Подключение к Claude Code

Claude Code — официальный CLI-инструмент Anthropic для Claude. Вы можете добавить Tavily MCP сервер с помощью команды claude mcp add. Существует два способа аутентификации:

Вариант 1: API Key в URL

Передайте API-ключ прямо в URL. Замените <your-api-key> на ваш реальный Tavily API key:

claude mcp add --transport http tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>

Вариант 2: OAuth-поток аутентификации

Добавьте сервер без API-key в URL:

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 search, extract, map и crawl.

Подключение к Cursor

Нажмите кнопку ⬆️ Add to Cursor ⬆️ — это выполнит большую часть работы за вас, но вам всё равно нужно отредактировать конфигурацию, чтобы добавить ваш API-ключ. Получить Tavily API-ключ можно здесь: tavily.com.

После нажатия кнопки вы будете переадресованы в 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-Remote в Cursor

{
  "mcpServers": {
    "tavily-remote-mcp": {
      "command": "npx mcp-remote https://mcp.tavily.com/mcp",
      "env": {}
    }
  }
}

Remote MCP Server OAuth Flow

Сервер Tavily Remote MCP поддерживает безопасную аутентификацию через OAuth, что позволяет безопасно подключаться и авторизоваться с совместимыми клиентами.

Как настроить OAuth-аутентификацию

A. С использованием MCP Inspector:

Откройте MCP Inspector и нажмите "Open Auth Settings".
Выберите OAuth-поток и выполните следующие шаги:
1. Метаданные обнаружения
2. Регистрация клиента
3. Подготовка авторизации
4. Запрос авторизации и получение кода авторизации
5. Запрос токена
6. Аутентификация завершена

По завершении вы получите access token, который позволяет безопасно выполнять аутентифицированные запросы к Tavily Remote MCP server.

B. С использованием других MCP-клиентов (пример: Cursor):

Вы можете настроить вашего MCP-клиента на использование OAuth без указания вашего Tavily API-ключа в URL. Например, в вашем mcp.json:

{
  "mcpServers": {
    "tavily-remote-mcp": {
      "command": "npx mcp-remote https://mcp.tavily.com/mcp",
      "env": {}
    }
  }
}

Если нужно очистить сохранённые учётные данные OAuth и повторно пройти аутентификацию, выполните:

rm -rf ~/.mcp-auth

Примечание:

OAuth-аутентификация необязательна. Вы всё равно можете использовать аутентификацию по API-ключу в любое время, добавив ваш Tavily API key в URL-запрос (?tavilyApiKey=...) или установив его в заголовке Authorization, как описано выше.

Выбор какого API Key использовать для OAuth

После успешной аутентификации по OAuth вы можете решить, какой API-key использовать, задав имя mcp_auth_default:

если в вашей личной учетной записи есть ключ с именем mcp_auth_default, этот ключ будет использоваться в процессе аутентификации
если ваша команда имеет ключ с именем mcp_auth_default, этот ключ будет использоваться
если у вас есть и личный, и командный ключ с именем mcp_auth_default, приоритет будет у личного ключа
если ключ mcp_auth_default не задан, будет использоваться ключ default из вашей личной учетной записи. Если ключ default отсутствует, будет использован первый доступный ключ

Локальный MCP

Требования 🔧

Перед началом убедитесь, что у вас есть:

Tavily API key

Если у вас нет Tavily API key, зарегистрируйтесь на бесплатный аккаунт здесь

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
На Windows: скачать Git for Windows

Запуск через NPX

npx -y tavily-mcp@latest

Конфигурация параметров по умолчанию ⚙️

Вы можете задать значения параметров по умолчанию для инструмента tavily-search, используя переменную окружения DEFAULT_PARAMETERS. Это позволяет настроить поведение поиска по умолчанию без необходимости указывать параметры в каждом запросе.

Пример конфигурации

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\"}"
      }
    }
  }
}

Идентификация конечного пользователя (Optional)

Вы можете опционально идентифицировать конечного пользователя, от имени которого выполняются запросы, задав переменную окружения TAVILY_HUMAN_ID. При установке Tavily MCP будет передавать её в заголовке X-Human-Id на каждом API-запросе, что позволяет проводить аналитику на уровне конкретного пользователя.

Это абсолютно необязательно — если не устанавливать, поведение не изменится.

{
  "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 пользователя) вместо реальных персональных данных, таких как электронная почта.

Благодарности ✨

Model Context Protocol для спецификации MCP
Anthropic за Claude Desktop