Tavily

Tavily MCP Sunucusu

Tavily MCP sunucusu şunları sağlar:

• arama, çıkarma, haritalama, tarama araçları
• tavily-search aracı ile gerçek zamanlı web arama yetenekleri
• tavily-extract aracı ile web sayfalarından akıllı veri çıkarma
• Web sitesinin yapılandırılmış bir haritasını oluşturan güçlü web haritalama aracı
• Web sitelerini sistematik olarak keşfeden web tarayıcı

📚 Yararlı Kaynaklar

• Tavily MCP'yi Neo4j MCP sunucusuyla birleştirme üzerine Eğitim
• Tavily MCP'yi VS Code'da Cline ile entegre etme üzerine Eğitim

Uzak MCP Sunucusu

Yerel olarak çalıştırmak yerine doğrudan Tavily'nin uzak MCP sunucusuna bağlanın. Bu, yerel kurulum veya yapılandırma gerektirmeden sorunsuz bir deneyim sağlar.

Tavily API anahtarınızla birlikte uzak MCP sunucu URL'sini kullanmanız yeterlidir:

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

Tavily API anahtarınızı tavily.com adresinden alın.

Alternatif olarak, MCP istemcisi bunu destekliyorsa API anahtarınızı bir Authorization başlığı aracılığıyla iletebilirsiniz:

Authorization: Bearer <your-api-key>

Not: Uzak MCP kullanırken, istenen varsayılanları içeren bir JSON nesnesi barındıran DEFAULT_PARAMETERS başlığı ekleyerek tüm istekler için varsayılan parametreler belirleyebilirsiniz. Örnek:

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

Claude Code'a Bağlanma

Claude Code, Anthropic'in Claude için resmi CLI aracıdır. Tavily MCP sunucusunu claude mcp add komutunu kullanarak ekleyebilirsiniz. Kimlik doğrulamanın iki yolu vardır:

Seçenek 1: URL'de API Anahtarı

API anahtarınızı doğrudan URL'de iletin. <your-api-key> kısmını gerçek Tavily API anahtarınız ile değiştirin:

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

Seçenek 2: OAuth Kimlik Doğrulama Akışı

Sunucuyu URL'de API anahtarı olmadan ekleyin:

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

Ekledikten sonra kimlik doğrulama akışını tamamlamanız gerekecek:

1. Claude Code'u başlatmak için claude komutunu çalıştırın
2. MCP sunucu yönetimini açmak için /mcp yazın
3. Tavily sunucusunu seçin ve kimlik doğrulama sürecini tamamlayın

İpucu: Tavily MCP sunucusunu tüm projelerinizde küresel olarak kullanılabilir hale getirmek için her iki komuta da --scope user ekleyin:

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

Yapılandırıldıktan sonra Tavily arama, çıkarma, haritalama ve tarama araçlarına erişiminiz olacak.

Cursor'a Bağlanma

⬆️ Cursor'a Ekle ⬆️ düğmesine tıklayın, bu işin çoğunu sizin için yapacaktır ancak yine de API ANAHTARINIZI eklemek için yapılandırmayı düzenlemeniz gerekecektir. Tavily API anahtarını buradan alabilirsiniz.

düğmeye tıkladığınızda Cursor'a yönlendirilmelisiniz ...

Adım 1

Yükle düğmesine tıklayın

Adım 2

MCP'nin şimdi yüklendiğini görmelisiniz, mavi kaydırıcı zaten açık değilse manuel olarak açın. Ayrıca kendi Tavily API anahtarınızı eklemek için yapılandırmayı düzenlemeniz gerekir.

Adım 3

Ardından your-api-key eklemeniz gereken mcp.json dosyanıza yönlendirileceksiniz.

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

Uzak MCP Sunucusu OAuth Akışı

Tavily Uzak MCP sunucusu, uyumlu istemcilerle sorunsuz bir şekilde bağlanmanıza ve yetkilendirme yapmanıza olanak tanıyan güvenli OAuth kimlik doğrulamasını destekler.

OAuth Kimlik Doğrulaması Nasıl Kurulur

A. MCP Inspector Kullanarak:

• MCP Inspector'ı açın ve "Open Auth Settings"e tıklayın.
• OAuth akışını seçin ve şu adımları tamamlayın:
  1. Meta veri keşfi
  2. İstemci kaydı
  3. Yetkilendirme hazırlığı
  4. Yetkilendirme isteği ve yetkilendirme kodunu alma
  5. Belirteç isteği
  6. Kimlik doğrulama tamamlandı

Tamamlandığında, Tavily Uzak MCP sunucusuna güvenli bir şekilde kimliği doğrulanmış istekler yapmanızı sağlayan bir erişim belirteci alacaksınız.

B. Diğer MCP İstemcilerini Kullanarak (Örnek: Cursor):

MCP istemcinizi, URL'ye Tavily API anahtarınızı eklemeden OAuth kullanacak şekilde yapılandırabilirsiniz. Örneğin, mcp.json dosyanızda:

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

Saklanan OAuth kimlik bilgilerini temizlemeniz ve yeniden kimlik doğrulamanız gerekirse şunu çalıştırın:

rm -rf ~/.mcp-auth

Not:

• OAuth kimlik doğrulaması isteğe bağlıdır. Yukarıda açıklandığı gibi, Tavily API anahtarınızı URL sorgu parametresine (?tavilyApiKey=...) ekleyerek veya Authorization başlığında ayarlayarak istediğiniz zaman API anahtarı kimlik doğrulamasını kullanmaya devam edebilirsiniz.

OAuth İçin Hangi API Anahtarının Kullanılacağını Seçme

Başarılı OAuth kimlik doğrulamasından sonra, hangi API anahtarının kullanılacağını mcp_auth_default olarak adlandırarak kontrol edebilirsiniz:

• Kişisel hesabınızda mcp_auth_default adında bir anahtar ayarlarsanız, bu anahtar kimlik doğrulama akışı için kullanılacaktır.
• mcp_auth_default adında bir anahtara sahip bir takımın parçasıysanız, bu anahtar kimlik doğrulama akışı için kullanılacaktır.
• mcp_auth_default adında hem kişisel bir anahtarınız hem de bir takım anahtarınız varsa, kişisel anahtar öncelikli olacaktır.
• Hiçbir mcp_auth_default anahtarı ayarlanmamışsa, kişisel hesabınızdaki default anahtarı kullanılacaktır. Hiçbir default anahtarı ayarlanmamışsa, mevcut ilk anahtar kullanılacaktır.

Yerel MCP

Ön Koşullar 🔧

Başlamadan önce şunlara sahip olduğunuzdan emin olun:

• Tavily API anahtarı
  • Tavily API anahtarınız yoksa, buradan ücretsiz bir hesap için kaydolabilirsiniz
• Claude Desktop veya Cursor
• Node.js (v20 veya üstü)
  • Node.js kurulumunuzu şu komutu çalıştırarak doğrulayabilirsiniz:
    • node --version
• Git kurulu (yalnızca Git kurulum yöntemi kullanılıyorsa gereklidir)
  • macOS'te: brew install git
  • Linux'ta:
    • Debian/Ubuntu: sudo apt install git
    • RedHat/CentOS: sudo yum install git
  • Windows'ta: Git for Windows indirin

NPX ile Çalıştırma

npx -y tavily-mcp@latest 

Varsayılan Parametre Yapılandırması ⚙️

DEFAULT_PARAMETERS ortam değişkenini kullanarak tavily-search aracı için varsayılan parametre değerleri ayarlayabilirsiniz. Bu, her istekte bu parametreleri belirtmeden varsayılan arama davranışını yapılandırmanıza olanak tanır.

Örnek Yapılandırma

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

İstemciden Örnek Kullanım

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

Son Kullanıcıyı Tanımlama (İsteğe Bağlı)

İsteklerin adına yapıldığı son kullanıcıyı, TAVILY_HUMAN_ID ortam değişkenini ayarlayarak isteğe bağlı olarak tanımlayabilirsiniz. Ayarlandığında, Tavily MCP bunu her API çağrısında X-Human-Id başlığı olarak iletir ve kullanıcı bazında analitiği etkinleştirir.

Bu tamamen isteğe bağlıdır — ayarlanmadığında davranış değişmez.

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

Gizlilik notu: Tavily, human_id değerini depolamadan önce sunucu tarafında (SHA-256) hash'ler, böylece ham değer asla kalıcı olarak saklanmaz. Yine de, mümkün olduğunda e-postalar gibi ham PII yerine opak tanımlayıcıları (ör. dahili bir kullanıcı kimliği) tercih edin.

Teşekkürler ✨

• MCP spesifikasyonu için Model Context Protocol
• Claude Desktop için Anthropic