Tavily

Server MCP Tavily

Server MCP Tavily menyediakan:

• alat pencarian, ekstraksi, pemetaan, perayapan
• Kemampuan pencarian web waktu nyata melalui alat tavily-search
• Ekstraksi data cerdas dari halaman web melalui alat tavily-extract
• Alat pemetaan web canggih yang membuat peta terstruktur dari situs web
• Perayap web yang menjelajahi situs web secara sistematis

📚 Sumber Daya Bermanfaat

• Tutorial tentang menggabungkan Tavily MCP dengan server Neo4j MCP
• Tutorial tentang mengintegrasikan Tavily MCP dengan Cline di VS Code

Server MCP Jarak Jauh

Hubungkan langsung ke server MCP jarak jauh Tavily alih-alih menjalankannya secara lokal. Ini memberikan pengalaman yang mulus tanpa memerlukan instalasi atau konfigurasi lokal.

Cukup gunakan URL server MCP jarak jauh dengan kunci API Tavily Anda:

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

Dapatkan kunci API Tavily Anda dari tavily.com.

Atau, Anda dapat mengirimkan kunci API Anda melalui header Authorization jika klien MCP mendukung ini:

Authorization: Bearer <your-api-key>

Catatan: Saat menggunakan MCP jarak jauh, Anda dapat menentukan parameter default untuk semua permintaan dengan menyertakan header DEFAULT_PARAMETERS yang berisi objek JSON dengan default yang Anda inginkan. Contoh:

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

Hubungkan ke Claude Code

Claude Code adalah alat CLI resmi Anthropic untuk Claude. Anda dapat menambahkan server MCP Tavily menggunakan perintah claude mcp add. Ada dua cara untuk mengautentikasi:

Opsi 1: Kunci API di URL

Kirimkan kunci API Anda langsung di URL. Ganti <your-api-key> dengan kunci API Tavily Anda yang sebenarnya:

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

Opsi 2: Alur Autentikasi OAuth

Tambahkan server tanpa kunci API di URL:

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

Setelah menambahkan, Anda perlu menyelesaikan alur autentikasi:

1. Jalankan claude untuk memulai Claude Code
2. Ketik /mcp untuk membuka manajemen server MCP
3. Pilih server Tavily dan selesaikan proses autentikasi

Kiat: Tambahkan --scope user ke salah satu perintah untuk membuat server MCP Tavily tersedia secara global di semua proyek Anda:

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

Setelah dikonfigurasi, Anda akan memiliki akses ke alat pencarian, ekstraksi, pemetaan, dan perayapan Tavily.

Hubungkan ke Cursor

Klik tombol ⬆️ Tambahkan ke Cursor ⬆️, ini akan melakukan sebagian besar pekerjaan untuk Anda tetapi Anda masih perlu mengedit konfigurasi untuk menambahkan KUNCI API Anda. Anda bisa mendapatkan kunci API Tavily di sini.

setelah Anda mengklik tombol tersebut, Anda akan diarahkan ke Cursor ...

Langkah 1

Klik tombol instal

Langkah 2

Anda akan melihat MCP sekarang terinstal, jika sakelar biru belum diaktifkan, aktifkan secara manual. Anda juga perlu mengedit konfigurasi untuk menyertakan kunci API Tavily Anda sendiri.

Langkah 3

Anda kemudian akan diarahkan ke file mcp.json Anda di mana Anda harus menambahkan your-api-key.

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

Alur OAuth Server MCP Jarak Jauh

Server MCP Jarak Jauh Tavily mendukung autentikasi OAuth yang aman, memungkinkan Anda untuk terhubung dan mengotorisasi dengan lancar dengan klien yang kompatibel.

Cara Mengatur Autentikasi OAuth

A. Menggunakan MCP Inspector:

• Buka MCP Inspector dan klik "Open Auth Settings".
• Pilih alur OAuth dan selesaikan langkah-langkah ini:
  1. Penemuan metadata
  2. Pendaftaran klien
  3. Mempersiapkan otorisasi
  4. Meminta otorisasi dan mendapatkan kode otorisasi
  5. Permintaan token
  6. Autentikasi selesai

Setelah selesai, Anda akan menerima token akses yang memungkinkan Anda membuat permintaan terautentikasi dengan aman ke Server MCP Jarak Jauh Tavily.

B. Menggunakan Klien MCP Lain (Contoh: Cursor):

Anda dapat mengonfigurasi klien MCP Anda untuk menggunakan OAuth tanpa menyertakan kunci API Tavily Anda di URL. Misalnya, di mcp.json Anda:

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

Jika Anda perlu menghapus kredensial OAuth yang tersimpan dan mengautentikasi ulang, jalankan:

rm -rf ~/.mcp-auth

Catatan:

• Autentikasi OAuth bersifat opsional. Anda masih dapat menggunakan autentikasi kunci API kapan saja dengan menyertakan kunci API Tavily Anda di parameter kueri URL (?tavilyApiKey=...) atau dengan mengaturnya di header Authorization, seperti yang dijelaskan di atas.

Memilih Kunci API Mana yang Digunakan untuk OAuth

Setelah autentikasi OAuth berhasil, Anda dapat mengontrol kunci API mana yang digunakan dengan menamainya mcp_auth_default:

• Jika Anda menetapkan kunci bernama mcp_auth_default di akun pribadi Anda, kunci itu akan digunakan untuk alur autentikasi.
• Jika Anda adalah bagian dari tim yang memiliki kunci bernama mcp_auth_default, kunci itu akan digunakan untuk alur autentikasi.
• Jika Anda memiliki keduanya kunci pribadi dan kunci tim bernama mcp_auth_default, kunci pribadi akan diprioritaskan.
• Jika tidak ada kunci mcp_auth_default yang ditetapkan, kunci default di akun pribadi Anda akan digunakan. Jika tidak ada kunci default yang ditetapkan, kunci pertama yang tersedia akan digunakan.

MCP Lokal

Prasyarat 🔧

Sebelum Anda memulai, pastikan Anda memiliki:

• Kunci API Tavily
  • Jika Anda tidak memiliki kunci API Tavily, Anda dapat mendaftar untuk akun gratis di sini
• Claude Desktop atau Cursor
• Node.js (v20 atau lebih tinggi)
  • Anda dapat memverifikasi instalasi Node.js Anda dengan menjalankan:
    • node --version
• Git terinstal (hanya diperlukan jika menggunakan metode instalasi Git)
  • Di macOS: brew install git
  • Di Linux:
    • Debian/Ubuntu: sudo apt install git
    • RedHat/CentOS: sudo yum install git
  • Di Windows: Unduh Git untuk Windows

Menjalankan dengan NPX

npx -y tavily-mcp@latest 

Konfigurasi Parameter Default ⚙️

Anda dapat menetapkan nilai parameter default untuk alat tavily-search menggunakan variabel lingkungan DEFAULT_PARAMETERS. Ini memungkinkan Anda untuk mengonfigurasi perilaku pencarian default tanpa menentukan parameter ini di setiap permintaan.

Contoh Konfigurasi

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

Contoh penggunaan dari Klien

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

Mengidentifikasi Pengguna Akhir (Opsional)

Anda dapat secara opsional mengidentifikasi pengguna akhir yang atas namanya permintaan dibuat dengan menetapkan variabel lingkungan TAVILY_HUMAN_ID. Saat ditetapkan, Tavily MCP meneruskannya sebagai header X-Human-Id pada setiap panggilan API, memungkinkan analitik per pengguna.

Ini sepenuhnya opsional — biarkan tidak ditetapkan dan perilaku tidak berubah.

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

Catatan privasi: Tavily melakukan hash human_id di sisi server (SHA-256) sebelum penyimpanan, sehingga nilai mentah tidak pernah disimpan. Meskipun demikian, lebih baik gunakan pengidentifikasi buram (misalnya ID pengguna internal) daripada PII mentah seperti email jika memungkinkan.

Ucapan Terima Kasih ✨

• Model Context Protocol untuk spesifikasi MCP
• Anthropic untuk Claude Desktop