Tavily MCP einrichten: Websuche und Seitenextraktion
Tavily MCP lokal einrichten: JSON-Beispiel, API-Key und getrennte Tests für Suche und Extraktion. Quellen prüfen und Fehler gezielt eingrenzen.
Eine Recherche besteht oft aus zwei Aufgaben: eine geeignete Seite finden und den relevanten Inhalt daraus lesen. Planen Sie dafür zwei getrennte Prüfungen. Wählen Sie zunächst ein öffentliches Thema mit einer bekannten Originalquelle. Legen Sie fest, welchen Absatz Sie am Ende benötigen. Damit bleibt auch bei einer leeren Antwort sichtbar, ob bereits die Suche keinen passenden Treffer fand oder erst das Lesen der Seite scheiterte.
Suche und Extraktion getrennt planen
Tavily dokumentiert die Werkzeuge tavily-search und tavily-extract. Für den hier gezeigten lokalen Start verwendet das Repository tavily-mcp@latest mit TAVILY_API_KEY. Zusätzlich beschreibt der Anbieter einen entfernten MCP-Zugang. Diese Anleitung behandelt den lokalen Start. Vergleichen Sie die Herkunft in der Tavily-Suche und im Verzeichnis für Webdaten.
| Aufgabe | Ihre Eingabe | Prüfergebnis |
|---|---|---|
| Suche | Ein präziser Suchsatz | Geeignete Originaladresse gefunden |
| Extraktion | Eine ausgewählte öffentliche URL | Gesuchter Abschnitt enthalten |
| Abgleich | Dieselbe Seite im Browser | Inhalt und Kontext stimmen überein |
Lokalen Zugang konfigurieren
Das Beispiel passt zu Clients mit mcpServers als JSON-Wurzel. Ersetzen Sie den Platzhalter in Ihrer lokalen Datei und erhalten Sie vorhandene Einträge. Für ein anderes Format helfen die Clientübersicht und der Konverter. Geben Sie in öffentliche Prüfwerkzeuge nur bereinigte Beispiele ohne echte Zugangswerte ein. Entscheidend ist, dass der Client das Startprogramm tatsächlich erreichen kann.
{
"mcpServers": {
"tavily": {
"command": "npx",
"args": [
"-y",
"tavily-mcp@latest"
],
"env": {
"TAVILY_API_KEY": "YOUR_TAVILY_API_KEY"
}
}
}
}
Der Zusatz @latest folgt dem veröffentlichten Repository-Beispiel und legt keine feste Version fest. Notieren Sie nach dem Test den tatsächlich verwendeten Stand. Für eine wiederholbare Übergabe sollten Paketstand und Clientversion zusammen bekannt sein. Ein erfolgreicher Start allein belegt noch keine funktionierende Suche: Erst ein abgeschlossener Werkzeugaufruf zeigt, ob der Zugang in Ihrer Umgebung bis zum Dienst reicht.
Eine Quelle finden und anschließend lesen
Lesen Sie nach der Verbindung die Werkzeugliste und die aktuellen Eingabeschemata. Notieren Sie, welche Such- und Extraktionswerkzeuge tatsächlich angeboten werden.
Führen Sie eine begrenzte Suche zu Ihrer öffentlichen Testfrage durch. Wählen Sie eine passende Originalquelle aus den zurückgegebenen Adressen.
Übergeben Sie diese einzelne Adresse an das Extraktionswerkzeug. Prüfen Sie, ob der vorher festgelegte Abschnitt enthalten ist.
Öffnen Sie dieselbe URL im Browser und vergleichen Sie Überschrift, Abschnitt und Veröffentlichungszusammenhang. Dokumentieren Sie fehlende Teile ausdrücklich.
Ein zurückgelieferter Titel oder eine kurze Zusammenfassung ist noch kein Beleg für den gesamten Seiteninhalt. Schreiben Sie zu Ihrer Aussage die konkrete Fundstelle auf. Wenn die Seite inzwischen verändert wurde, halten Sie die beiden Abrufzeiten fest. Wiederholen Sie für eine Gegenprobe dieselbe Frage, bevor Sie zusätzliche Filter oder weitere Seiten einbeziehen. So lässt sich eine Änderung am Verfahren vom veränderten Inhalt unterscheiden.
Leere Ergebnisse und Verbindungsfehler unterscheiden
Keine Werkzeugliste weist zunächst auf die Verbindung oder den Startweg. Eine vorhandene Liste mit fehlgeschlagenem Aufruf verlangt dagegen die konkrete Fehlermeldung des Dienstes. Prüfen Sie Zugang und Kontingent in Ihrem Anbieterbereich. Bei einer leeren Extraktion öffnen Sie genau die zurückgegebene Adresse im Browser: Eine Weiterleitung, Anmeldung oder nachgeladene Ansicht kann einen anderen Prüfweg erfordern. Ein leerer Text ist kein Beleg dafür, dass die Aussage auf der Website fehlt.
Verwenden Sie für die technische Eingrenzung den Fehler-Navigator. Für die Auswahl eines anderen Suchwegs stehen die Brave-Anleitung und der Recherchevergleich bereit. Wenn Sie lediglich eine bekannte URL lesen möchten, beginnen Sie mit einem einzelnen Abruf statt mit einer offenen Suche. Das macht den nächsten Versuch leichter nachvollziehbar.
- Muss ich Suche und Extraktion immer gemeinsam nutzen?
- Nein. Wenn Sie die Adresse schon kennen, können Sie die Leseprüfung direkt mit dieser URL planen.
- Ist eine leere Extraktion ein negatives Suchergebnis?
- Nein. Suche und Seitenabruf sind getrennte Schritte. Prüfen Sie, welcher davon keine verwertbare Antwort geliefert hat.
- Ist der lokale Start vollständig offline?
- Nein. Der lokale MCP-Prozess nutzt den externen Tavily-Dienst. Berücksichtigen Sie das bei der Wahl Ihrer Testanfragen.
- Kann ich denselben Versuch später wiederholen?
- Notieren Sie Paketversion, Eingaben und Zeitpunkt. Suchergebnisse und Seiteninhalte können sich auch bei unveränderter Einrichtung ändern.
Herstellerquellen am 1. Oktober 2026 geprüft. Die Prüfpläne sind redaktionelle Vorschläge.
- Tavily: MCP-Dokumentation
Abrufbefehl anzeigen
curl -s https://docs.tavily.com/documentation/mcp - Tavily: Repository und lokaler Start
Abrufbefehl anzeigen
curl -s https://github.com/tavily-ai/tavily-mcp