Tavily MCP – inteligentna wyszukiwarka internetowa dla AI

Q: Czy potrzebujesz klucza API Tavily?

Tak, do działania potrzebujesz klucza Tavily API key. Możesz przekazać go w adresie serwera MCP albo przez nagłówek Authorization: Bearer, jeśli Twój klient MCP to obsługuje.

Q: Czym różni się tavily-search od tavily-extract?

tavily-search służy do wyszukiwania aktualnych informacji w internecie. tavily-extract służy do wyciągania danych z konkretnych stron internetowych.

Q: Do czego służy narzędzie map?

Narzędzie map tworzy uporządkowaną mapę witryny. Dzięki temu możesz sprawdzić strukturę strony i zobaczyć, jakie obszary są dostępne do dalszej analizy.

Q: Kiedy warto użyć narzędzia crawl?

Narzędzie crawl przydaje się, gdy chcesz systematycznie przejść przez strony w obrębie witryny. Możesz je wykorzystać wtedy, gdy jedna podstrona nie wystarcza i potrzebujesz szerszego sprawdzenia serwisu.

Q: Czy możesz ustawić domyślne parametry wyszukiwania?

Tak. Możesz użyć DEFAULT_PARAMETERS, aby ustawić domyślne zachowanie dla tavily-search. Możesz określić na przykład pobieranie obrazów, liczbę wyników albo głębokość wyszukiwania.

Opis
Działanie
Instalacja
FAQ

Tavily MCP Server

Tavily MCP Server to serwer MCP, który daje Twojemu asystentowi AI dostęp do wyszukiwania, pobierania i analizowania informacji z internetu. Dzięki niemu możesz korzystać z aktualnych danych z sieci bez ręcznego przeglądania wielu stron. AI może wyszukiwać informacje, wyciągać dane z konkretnych stron, mapować witryny oraz systematycznie sprawdzać ich zawartość. Tavily MCP Server możesz połączyć zdalnie przez gotowy adres MCP albo uruchomić lokalnie przez NPX. Do działania potrzebujesz klucza Tavily API key.

Dostępne narzędzia

tavily-search – wyszukuje informacje w internecie w czasie rzeczywistym, aby AI mogło pracować na aktualnych wynikach.
tavily-extract – wyciąga dane ze stron internetowych i pomaga zamienić treść strony w użyteczne informacje.
map – tworzy uporządkowaną mapę witryny, dzięki czemu możesz zobaczyć strukturę dostępnych stron.
crawl – systematycznie przechodzi przez strony w obrębie witryny i pomaga zebrać jej zawartość.

Najważniejsze możliwości

Możesz wyszukiwać aktualne informacje z poziomu rozmowy z AI.
Możesz wyciągać dane z wybranych stron internetowych.
Możesz tworzyć strukturę witryny, aby łatwiej zrozumieć jej układ.
Możesz używać crawl, gdy chcesz sprawdzić większą część strony.
Możesz ustawić domyślne parametry wyszukiwania dla kolejnych zapytań.

Sposoby połączenia

Możesz korzystać ze zdalnego serwera MCP Tavily bez lokalnej instalacji. W takim wariancie podajesz adres zdalnego serwera oraz swój klucz API. Możesz też uruchomić Tavily MCP lokalnie przez npx. Ten wariant wymaga Node.js w wersji 20 lub nowszej.

Uwierzytelnianie

Tavily MCP Server obsługuje klucz API przekazany w adresie serwera. Możesz też użyć nagłówka Authorization: Bearer, jeśli Twój klient MCP to wspiera. W zdalnym wariancie możesz również skorzystać z OAuth. To pozwala połączyć serwer bez umieszczania klucza API bezpośrednio w adresie.

Konfiguracja domyślnych parametrów

Możesz ustawić domyślne parametry dla narzędzia tavily-search. Służy do tego zmienna DEFAULT_PARAMETERS. Dzięki temu nie musisz za każdym razem wpisywać tych samych ustawień. Możesz na przykład ustawić domyślne pobieranie obrazów, liczbę wyników lub głębokość wyszukiwania.

Identyfikacja osoby korzystającej

Opcjonalnie możesz ustawić zmienną TAVILY_HUMAN_ID. Pozwala ona przekazywać identyfikator osoby, w imieniu której wykonywane są zapytania. Ta funkcja służy do analityki per osoba. Tavily hashuje ten identyfikator po stronie serwera, więc surowa wartość nie jest zapisywana.

⚠️ Uwaga: Nie wklejaj publicznie swojego klucza API. Traktuj go jak hasło do usługi Tavily.

Jak działa Tavily MCP Server?

Tavily MCP Server działa jak połączenie między Twoim asystentem AI a usługą Tavily. Przepływ jest prosty: Ty → AI → Tavily MCP Server → Tavily → internet. Ty wpisujesz polecenie, a AI korzysta z narzędzi Tavily, aby wyszukać, pobrać lub uporządkować informacje ze stron. Dzięki temu AI może pracować na aktualnych danych z internetu. Może też analizować konkretne strony, sprawdzać strukturę witryny albo systematycznie przeglądać jej zawartość.

Podstawowy przepływ pracy

Ty zadajesz pytanie albo opisujesz, jakich danych potrzebujesz.
AI wybiera odpowiednie narzędzie Tavily, na przykład search, extract, map lub crawl.
Tavily MCP Server przekazuje zapytanie do Tavily przez zdalny serwer MCP albo lokalne uruchomienie.
Tavily wykonuje zadanie, na przykład wyszukuje informacje lub analizuje stronę.
AI otrzymuje wynik i może go podsumować, porównać albo wykorzystać w dalszej pracy.

Jak możesz z niego korzystać?

Jeśli szukasz aktualnych informacji, AI może użyć narzędzia tavily-search. To pozwala wyszukiwać dane w czasie rzeczywistym. Jeśli masz konkretną stronę do sprawdzenia, AI może użyć tavily-extract. To narzędzie wyciąga informacje z treści strony. Jeśli chcesz poznać strukturę witryny, AI może skorzystać z narzędzia map. Gdy potrzebujesz przejrzeć większą część strony, może użyć narzędzia crawl.

Praktyczne przykłady użycia

1. Wyszukanie aktualnych informacji

Możesz zapytać AI o informacje, których nie masz w plikach ani w rozmowie. Tavily MCP Server pozwala wtedy użyć wyszukiwania internetowego. AI może zebrać wyniki i przedstawić Ci je w bardziej czytelnej formie. Nie musisz samodzielnie przechodzić przez wiele stron.

2. Wyciągnięcie danych z konkretnej strony

Możesz podać adres strony i poprosić AI o pobranie najważniejszych informacji. Tavily MCP Server przekaże zadanie do narzędzia tavily-extract. To przydaje się, gdy chcesz szybko zamienić treść strony w konkretne dane. AI może potem pomóc Ci je uporządkować.

3. Sprawdzenie struktury witryny

Możesz poprosić AI o sprawdzenie, jak zbudowana jest dana strona. Narzędzie map tworzy uporządkowaną mapę witryny. Jeśli chcesz przeanalizować większą część serwisu, AI może użyć narzędzia crawl. Wtedy Tavily systematycznie eksploruje strony w obrębie witryny.

💡 Wskazówka: Gdy zależy Ci na aktualnych danych, poproś AI o wyszukiwanie. Gdy masz konkretny link, poproś o wyciągnięcie danych z tej strony.

Zdalne i lokalne działanie

Tavily MCP Server możesz połączyć zdalnie przez adres MCP. W tym wariancie nie musisz uruchamiać serwera lokalnie. Możesz też uruchomić go lokalnie przez npx. Ten sposób wymaga Node.js w wersji 20 lub nowszej oraz klucza API Tavily.

Domyślne ustawienia zapytań

Możesz ustawić domyślne parametry dla wyszukiwania przez DEFAULT_PARAMETERS. Dzięki temu AI może korzystać z tych samych ustawień w kolejnych zapytaniach. Możesz ustawić na przykład pobieranie obrazów, liczbę wyników albo głębokość wyszukiwania. Nie musisz wtedy powtarzać tych parametrów za każdym razem.

⚠️ Uwaga: Klucz API Tavily pozwala korzystać z usługi. Nie publikuj go na stronie ani w publicznych miejscach.

Instalacja Tavily MCP Server

Tavily MCP Server możesz połączyć zdalnie albo uruchomić lokalnie przez NPX. Najprostszy wariant to zdalny serwer MCP Tavily. Wtedy nie musisz instalować serwera na swoim komputerze. Potrzebujesz tylko klucza Tavily API key.

⚠️ Uwaga: Nie publikuj swojego klucza API. Traktuj go jak hasło do usługi Tavily.

Połączenie ze zdalnym serwerem MCP

Możesz połączyć się bezpośrednio ze zdalnym serwerem Tavily MCP przez adres URL z kluczem API.

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

Zamień <your-api-key> na swój prawdziwy klucz API Tavily. Jeśli Twój klient MCP obsługuje nagłówek autoryzacji, możesz przekazać klucz także w taki sposób:

Authorization: Bearer <your-api-key>

Domyślne parametry dla zdalnego MCP

Przy zdalnym połączeniu możesz ustawić domyślne parametry dla zapytań. Służy do tego nagłówek DEFAULT_PARAMETERS.

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

Dzięki temu możesz określić na przykład liczbę wyników, głębokość wyszukiwania albo dołączanie obrazów.

Połączenie z Claude Code

W Claude Code możesz dodać Tavily MCP Server poleceniem claude mcp add.

Opcja 1: klucz API w adresie URL

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

Ten wariant przekazuje Twój klucz API bezpośrednio w adresie serwera.

Opcja 2: logowanie przez OAuth

claude mcp add --transport http tavily https://mcp.tavily.com/mcp

Po dodaniu serwera uruchom Claude Code, wpisz /mcp, wybierz serwer Tavily i przejdź przez proces autoryzacji.

Dostęp globalny w Claude Code

Możesz dodać parametr –scope user, aby Tavily MCP Server był dostępny we wszystkich Twoich projektach.

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

Połączenie z Cursor

W Cursor możesz dodać zdalny serwer MCP Tavily przez konfigurację mcp.json. Po dodaniu serwera uzupełnij konfigurację własnym kluczem API.

{
  "mcpServers": {
    "tavily-remote-mcp": {
      "command": "npx -y mcp-remote https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>",
      "env": {}
    }
  }
}

Zamień <your-api-key> na swój klucz API Tavily.

OAuth w zdalnym serwerze MCP

Tavily Remote MCP Server obsługuje też OAuth. Dzięki temu możesz połączyć serwer bez wpisywania klucza API w adresie URL. W Cursor możesz użyć takiej konfiguracji:

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

Jeśli chcesz usunąć zapisane dane OAuth i zalogować się ponownie, użyj polecenia:

rm -rf ~/.mcp-auth

ℹ️ Info: OAuth jest opcjonalny. Możesz nadal używać klucza API w adresie URL albo w nagłówku Authorization.

Uruchomienie lokalne przez NPX

Możesz też uruchomić Tavily MCP Server lokalnie na swoim komputerze. Do lokalnego uruchomienia potrzebujesz:

Tavily API key – klucza API do usługi Tavily.
Claude Desktop albo Cursor – klienta, który połączy się z serwerem MCP.
Node.js w wersji 20 lub nowszej – środowiska potrzebnego do uruchomienia pakietu.
Git – tylko wtedy, gdy korzystasz z metody instalacji przez Git.

Aby uruchomić serwer przez NPX, użyj polecenia:

npx -y tavily-mcp@latest

Konfiguracja lokalna z kluczem API

W kliencie MCP możesz dodać konfigurację, która uruchamia Tavily MCP przez NPX i przekazuje klucz API.

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Zamień your-api-key-here na swój klucz API Tavily.

Domyślne ustawienia wyszukiwania

Możesz ustawić domyślne parametry dla narzędzia tavily-search. Służy do tego zmienna DEFAULT_PARAMETERS.

export DEFAULT_PARAMETERS='{"include_images": true}'

Możesz też dodać więcej ustawień w konfiguracji klienta MCP.

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

Opcjonalna identyfikacja osoby korzystającej

Możesz ustawić zmienną TAVILY_HUMAN_ID, jeśli chcesz przekazywać identyfikator osoby, w imieniu której wykonywane są zapytania.

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here",
        "TAVILY_HUMAN_ID": "your-user-id"
      }
    }
  }
}

Ta opcja jest dobrowolna. Jeśli jej nie ustawisz, działanie serwera pozostaje bez zmian.

💡 Wskazówka: Przy identyfikatorze osoby lepiej używaj wewnętrznego ID zamiast adresu e-mail.

FAQ – Tavily MCP Server

Do czego służy Tavily MCP Server?

Tavily MCP Server pozwala Twojemu asystentowi AI korzystać z narzędzi Tavily. Możesz wyszukiwać informacje w internecie, wyciągać dane ze stron, mapować witryny i uruchamiać crawl.

Czy musisz instalować Tavily MCP Server lokalnie?

Nie. Możesz połączyć się ze zdalnym serwerem MCP Tavily przez gotowy adres URL. Możesz też uruchomić serwer lokalnie przez npx, jeśli wolisz taki wariant.

Czy potrzebujesz klucza API Tavily?

Tak, do działania potrzebujesz klucza Tavily API key. Możesz przekazać go w adresie serwera MCP albo przez nagłówek Authorization: Bearer, jeśli Twój klient MCP to obsługuje.

Czym różni się tavily-search od tavily-extract?

tavily-search służy do wyszukiwania aktualnych informacji w internecie. tavily-extract służy do wyciągania danych z konkretnych stron internetowych.

Do czego służy narzędzie map?

Narzędzie map tworzy uporządkowaną mapę witryny. Dzięki temu możesz sprawdzić strukturę strony i zobaczyć, jakie obszary są dostępne do dalszej analizy.

Kiedy warto użyć narzędzia crawl?

Narzędzie crawl przydaje się, gdy chcesz systematycznie przejść przez strony w obrębie witryny. Możesz je wykorzystać wtedy, gdy jedna podstrona nie wystarcza i potrzebujesz szerszego sprawdzenia serwisu.

Czy możesz ustawić domyślne parametry wyszukiwania?

Tak. Możesz użyć DEFAULT_PARAMETERS, aby ustawić domyślne zachowanie dla tavily-search. Możesz określić na przykład pobieranie obrazów, liczbę wyników albo głębokość wyszukiwania.

Czy OAuth jest wymagany?

Nie. OAuth jest opcjonalny. Możesz nadal korzystać z klucza API w adresie URL albo przekazać go przez nagłówek autoryzacji.

Kompatybilne między innmi z:

SZYBKA INSTALACJA

Code

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