Tavily

Tavily MCP Server

Der Tavily MCP-Server bietet:

• Such-, Extraktions-, Mapping- und Crawling-Tools
• Echtzeit-Websuchfunktionen über das tavily-search-Tool
• Intelligente Datenextraktion aus Webseiten über das tavily-extract-Tool
• Leistungsstarkes Web-Mapping-Tool, das eine strukturierte Karte einer Website erstellt
• Web-Crawler, der Websites systematisch erkundet

📚 Hilfreiche Ressourcen

• Tutorial zur Kombination von Tavily MCP mit dem Neo4j MCP-Server
• Tutorial zur Integration von Tavily MCP mit Cline in VS Code

Remote MCP-Server

Verbinden Sie sich direkt mit dem Remote-MCP-Server von Tavily, anstatt ihn lokal auszuführen. Dies bietet ein nahtloses Erlebnis ohne lokale Installation oder Konfiguration.

Verwenden Sie einfach die Remote-MCP-Server-URL mit Ihrem Tavily-API-Schlüssel:

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

Holen Sie sich Ihren Tavily-API-Schlüssel von tavily.com.

Alternativ können Sie Ihren API-Schlüssel über einen Authorization-Header übergeben, wenn der MCP-Client dies unterstützt:

Authorization: Bearer <your-api-key>

Hinweis: Bei Verwendung des Remote-MCP können Sie Standardparameter für alle Anfragen festlegen, indem Sie einen DEFAULT_PARAMETERS-Header mit einem JSON-Objekt Ihrer gewünschten Standardwerte einfügen. Beispiel:

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

Mit Claude Code verbinden

Claude Code ist das offizielle CLI-Tool von Anthropic für Claude. Sie können den Tavily MCP-Server mit dem Befehl claude mcp add hinzufügen. Es gibt zwei Möglichkeiten zur Authentifizierung:

Option 1: API-Schlüssel in der URL

Übergeben Sie Ihren API-Schlüssel direkt in der URL. Ersetzen Sie <your-api-key> durch Ihren tatsächlichen Tavily-API-Schlüssel:

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

Option 2: OAuth-Authentifizierungsablauf

Fügen Sie den Server ohne API-Schlüssel in der URL hinzu:

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

Nach dem Hinzufügen müssen Sie den Authentifizierungsablauf abschließen:

1. Führen Sie claude aus, um Claude Code zu starten
2. Geben Sie /mcp ein, um die MCP-Serververwaltung zu öffnen
3. Wählen Sie den Tavily-Server aus und schließen Sie den Authentifizierungsprozess ab

Tipp: Fügen Sie --scope user zu einem der Befehle hinzu, um den Tavily MCP-Server global in all Ihren Projekten verfügbar zu machen:

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

Nach der Konfiguration haben Sie Zugriff auf die Tavily-Tools für Suche, Extraktion, Mapping und Crawling.

Mit Cursor verbinden

Klicken Sie auf die Schaltfläche ⬆️ Zu Cursor hinzufügen ⬆️, dies erledigt den Großteil der Arbeit für Sie, aber Sie müssen die Konfiguration noch bearbeiten, um Ihren API-SCHLÜSSEL hinzuzufügen. Einen Tavily-API-Schlüssel erhalten Sie hier.

Sobald Sie auf die Schaltfläche klicken, sollten Sie zu Cursor weitergeleitet werden ...

Schritt 1

Klicken Sie auf die Schaltfläche „Installieren“

Schritt 2

Sie sollten sehen, dass der MCP jetzt installiert ist. Wenn der blaue Schieberegler noch nicht aktiviert ist, aktivieren Sie ihn manuell. Sie müssen außerdem die Konfiguration bearbeiten, um Ihren eigenen Tavily-API-Schlüssel einzufügen.

Schritt 3

Sie werden dann zu Ihrer mcp.json-Datei weitergeleitet, wo Sie your-api-key hinzufügen müssen.

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

Remote MCP-Server OAuth-Ablauf

Der Tavily Remote MCP-Server unterstützt sichere OAuth-Authentifizierung, sodass Sie sich nahtlos mit kompatiblen Clients verbinden und autorisieren können.

So richten Sie die OAuth-Authentifizierung ein

A. Mit MCP Inspector:

• Öffnen Sie den MCP Inspector und klicken Sie auf „Auth-Einstellungen öffnen“.
• Wählen Sie den OAuth-Ablauf und führen Sie diese Schritte aus:
  1. Metadaten-Erkennung
  2. Client-Registrierung
  3. Autorisierung vorbereiten
  4. Autorisierung anfordern und den Autorisierungscode erhalten
  5. Token-Anforderung
  6. Authentifizierung abgeschlossen

Nach Abschluss erhalten Sie ein Zugriffstoken, mit dem Sie sicher authentifizierte Anfragen an den Tavily Remote MCP-Server stellen können.

B. Mit anderen MCP-Clients (Beispiel: Cursor):

Sie können Ihren MCP-Client so konfigurieren, dass er OAuth verwendet, ohne Ihren Tavily-API-Schlüssel in die URL aufzunehmen. Zum Beispiel in Ihrer mcp.json:

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

Wenn Sie gespeicherte OAuth-Anmeldeinformationen löschen und sich erneut authentifizieren müssen, führen Sie aus:

rm -rf ~/.mcp-auth

Hinweis:

• Die OAuth-Authentifizierung ist optional. Sie können jederzeit weiterhin die API-Schlüssel-Authentifizierung verwenden, indem Sie Ihren Tavily-API-Schlüssel in den URL-Abfrageparameter (?tavilyApiKey=...) einfügen oder ihn im Authorization-Header festlegen, wie oben beschrieben.

Auswählen, welcher API-Schlüssel für OAuth verwendet wird

Nach erfolgreicher OAuth-Authentifizierung können Sie steuern, welcher API-Schlüssel verwendet wird, indem Sie ihn mcp_auth_default nennen:

• Wenn Sie in Ihrem persönlichen Konto einen Schlüssel mit dem Namen mcp_auth_default festlegen, wird dieser Schlüssel für den Authentifizierungsablauf verwendet.
• Wenn Sie Teil eines Teams sind, das einen Schlüssel mit dem Namen mcp_auth_default hat, wird dieser Schlüssel für den Authentifizierungsablauf verwendet.
• Wenn Sie sowohl einen persönlichen Schlüssel als auch einen Team-Schlüssel mit dem Namen mcp_auth_default haben, wird der persönliche Schlüssel priorisiert.
• Wenn kein mcp_auth_default-Schlüssel festgelegt ist, wird der default-Schlüssel in Ihrem persönlichen Konto verwendet. Wenn kein default-Schlüssel festgelegt ist, wird der erste verfügbare Schlüssel verwendet.

Lokaler MCP

Voraussetzungen 🔧

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

• Tavily-API-Schlüssel
  • Wenn Sie keinen Tavily-API-Schlüssel haben, können Sie sich hier für ein kostenloses Konto registrieren
• Claude Desktop oder Cursor
• Node.js (v20 oder höher)
  • Sie können Ihre Node.js-Installation überprüfen, indem Sie Folgendes ausführen:
    • node --version
• Git installiert (nur erforderlich, wenn Sie die Git-Installationsmethode verwenden)
  • Unter macOS: brew install git
  • Unter Linux:
    • Debian/Ubuntu: sudo apt install git
    • RedHat/CentOS: sudo yum install git
  • Unter Windows: Laden Sie Git für Windows herunter

Ausführen mit NPX

npx -y tavily-mcp@latest 

Konfiguration von Standardparametern ⚙️

Sie können Standardparameterwerte für das tavily-search-Tool mithilfe der Umgebungsvariablen DEFAULT_PARAMETERS festlegen. Dadurch können Sie das Standard-Suchverhalten konfigurieren, ohne diese Parameter in jeder Anfrage angeben zu müssen.

Beispielkonfiguration

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

Beispielverwendung vom Client

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

Identifizierung des Endbenutzers (Optional)

Sie können optional den Endbenutzer identifizieren, in dessen Auftrag Anfragen gestellt werden, indem Sie die Umgebungsvariable TAVILY_HUMAN_ID festlegen. Wenn festgelegt, leitet Tavily MCP diese bei jedem API-Aufruf als X-Human-Id-Header weiter und ermöglicht so benutzerbezogene Analysen.

Dies ist vollständig optional – lassen Sie die Variable nicht gesetzt, und das Verhalten bleibt unverändert.

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

Datenschutzhinweis: Tavily hasht human_id serverseitig (SHA-256) vor der Speicherung, sodass der Rohwert niemals gespeichert wird. Bevorzugen Sie dennoch nach Möglichkeit undurchsichtige Identifikatoren (z. B. eine interne Benutzer-ID) gegenüber rohen personenbezogenen Daten wie E-Mails.

Danksagungen ✨

• Model Context Protocol für die MCP-Spezifikation
• Anthropic für Claude Desktop