שרת MCP מאומת: Tavily
התשובה הקצרה
אומת לאחרונה 2026-08-03
שרת ה-MCP של Tavily נותן לעוזר AI מנוע חיפוש אמיתי: הוא יכול לחפש ברשת החיה, לשלוף את הטקסט הקריא מתוך עמוד, לסרוק אתר, למפות את הכתובות שלו ולהריץ מחקר ארוך יותר ממספר מקורות. Tavily בונה ומפרסמת אותו בעצמה, בשתי צורות שהן שתיהן רשמיות. יש שרת מתארח בכתובת mcp.tavily.com שכל לקוח יכול להתחבר אליו על גבי HTTPS, ויש חבילת npm שמריצים על ה-Mac. הרצנו את שתיהן באותו יום עם מפתח ששמור מקומית, ספרנו את כל 5 הכלים, ביצענו חיפוש אמיתי אחד שחזר עם תוצאות חיות, ושמרנו את הפלט הגולמי, כולל השגיאות המדויקות שהשרת מחזיר כשהמפתח חסר, שגוי או כשהארגומנטים לא שלמים. מלכודת שם אחת שכדאי להכיר לפני שמתחילים: שם החבילה הוא tavily-mcp, בלי scope. בעמוד התיעוד של Tavily עצמה מופיע תג שכתוב בו @tavily/mcp, ואין חבילה בשם הזה ב-npm. [1][4][7][2]
אימות
השיטה
הרצנו את חבילת ה-npm עם npx על גבי stdio, השלמנו את לחיצת היד של MCP, קראנו ל-tools/list והרצנו קריאת כלי אמיתית אחת שחיפשה ברשת החיה. ההזדהות נעשתה עם מפתח API של Tavily ששמור כבר על ה-Mac הזה, שנקרא ישירות מהגדרות ה-MCP המקומיות על ידי סקריפט הבדיקה ואינו מודפס בשום מקום: כל שורה שהסקריפט שומר עוברת קודם שלב הסתרה. טבלת הכלים למטה היא תשובת ה-tools/list, מילה במילה. אחר כך פתחנו חיבור שני, הפעם לנקודת הקצה המתארחת של Tavily בכתובת https://mcp.tavily.com/mcp/ על גבי Streamable HTTP עם אותו מפתח, והיא ענתה עם אותם חמישה כלים. שתי הפעלות נוספות נעשו בכוונה כדי לשבור דברים: אחת בלי מפתח בכלל, ואחת עם מפתח מזויף. שתי השגיאות מודפסות בהמשך.
הודעת הפתיחה של השרת
Tavily MCP server running on stdio
קריאת כלי אמיתית אחת
tools/call tavily_search {"query": "what is MCP"}Detailed Results: Title: MCP 101: Understanding the Model Context Protocol URL: https://www.itential.com/resource/blog/mcp-101-understanding-the-model-context-protocol Content: ## What is MCP?
שורות אמיתיות מהתוצאה שנלכדה: מספיק כדי להוכיח שהקריאה נענתה.
כלים
השרת ענה ל-tools/list עם 5 כלים בתאריך 2026-08-03. השמות, התיאורים והפרמטרים למטה הם המילים שלו עצמו, מועתקים מהתשובה הזו וללא עריכה.
| כלי | מה הוא עושה |
|---|---|
| tavily_searchquery*search_depthtopictime_rangestart_dateend_datemax_resultsinclude_imagesinclude_image_descriptionsinclude_raw_contentinclude_domainsexclude_domainscountryinclude_faviconexact_match | Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs. |
| tavily_extracturls*extract_depthinclude_imagesformatinclude_faviconquery | Extract content from URLs. Returns raw page content in markdown or text format. |
| tavily_crawlurl*max_depthmax_breadthlimitinstructionsselect_pathsselect_domainsallow_externalextract_depthformatinclude_favicon | Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth. |
| tavily_mapurl*max_depthmax_breadthlimitinstructionsselect_pathsselect_domainsallow_external | Map a website's structure. Returns a list of URLs found starting from the base URL. |
| tavily_researchinput*model | Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings. Rate limit: 20 requests per minute. |
פרמטרים המסומנים ב-* הם חובה.
התקנה
העתיקו את הבלוק של האפליקציה שלכם. כל אחד מהם הוא ההגדרה המדויקת שאיתה אימתנו את השרת.
פתחו את הקובץ ~/Library/Application Support/Claude/claude_desktop_config.json (בתוך Claude Desktop: Settings, אחר כך Developer, אחר כך Edit Config) והוסיפו:
{
"mcpServers": {
"tavily-mcp": {
"command": "npx",
"args": [
"-y",
"tavily-mcp@latest"
],
"env": {
"TAVILY_API_KEY": "tvly-YOUR_API_KEY-here"
}
}
}
}הדביקו את המפתח שלכם, ואז סגרו ופתחו מחדש את Claude Desktop. קובץ ההגדרות הזה יודע להפעיל פקודות בלבד, ולכן אם אתם מעדיפים את השרת המתארח של Tavily, גשרו אליו: הגדירו את command ל-npx ואת args ל-mcp-remote ואחריו https://mcp.tavily.com/mcp/?tavilyApiKey=your-key. [7][9]
פקודה אחת בטרמינל. זהו השרת המתארח, ולכן אין מה להתקין:
claude mcp add tavily --transport http "https://mcp.tavily.com/mcp/?tavilyApiKey=tvly-YOUR_API_KEY-here"
הוסיפו --scope user כדי שהשרת יהיה זמין בכל הפרויקטים ולא רק בזה. שתי חלופות להכנסת המפתח לכתובת: מחקו את המחרוזת שאחרי סימן השאלה והריצו /mcp בתוך Claude Code כדי להשלים תהליך OAuth בדפדפן, או ותרו על החשבון לגמרי עם --header "X-Tavily-Access-Mode: keyless", שמקנה גישה לחיפוש ולחילוץ בלבד. [7][8][10]
הוסיפו ל-~/.cursor/mcp.json עבור כל הפרויקטים, או ל-.cursor/mcp.json בתוך פרויקט אחד:
{
"mcpServers": {
"tavily-mcp": {
"command": "npx",
"args": [
"-y",
"tavily-mcp@latest"
],
"env": {
"TAVILY_API_KEY": "tvly-YOUR_API_KEY-here"
}
}
}
}Cursor קורא את הקובץ מחדש אחרי הפעלה מחדש. התייחסו לקובץ הזה כמו לכל קובץ שיש בו מפתח: זה טקסט פשוט על הדיסק, לכן שמרו אותו מחוץ למאגר קוד שאתם דוחפים. [7][11]
בלי קובץ JSON ובלי טרמינל. ב-Routines: Settings, אחר כך Assistant, אחר כך Connections, אחר כך Add MCP Server. העבירו את הטופס ל-Command (stdio) והזינו:
Name Tavily Command npx Arguments -y tavily-mcp@latest Environment Variables TAVILY_API_KEY tvly-YOUR_API_KEY-here
הערך בשדה ה-Arguments מתפצל לפי רווחים, לכן השאירו בו בדיוק שלוש המילים האלה. המפתח נכנס ל-Environment Variables, אף פעם לא ל-Arguments. לחצו קודם על Test Connection: שרת תקין עונה עם מספר הכלים שלו, חמישה עבור השרת הזה. אם אתם מעדיפים את השרת המתארח, השאירו את הטופס במצב URL (SSE/HTTP) והזינו https://mcp.tavily.com/mcp/ עם המפתח שלכם כטוקן ה-bearer. [12][7]
בלי טרמינל
אם מעולם לא פתחתם את הטרמינל ואין לכם כוונה להתחיל, זה המסלול שלכם. Routines היא אפליקציית Mac שמריצה שרתי MCP בשבילכם: ממלאים כמה שדות פעם אחת, והכלים של השרת זמינים ל-AI שלכם בצ׳אט ובשגרות מתוזמנות. העיקוף היחיד הוא המפתח של Tavily, וזה לוקח בערך שתי דקות.
01
הורידו את האפליקציה מ-getroutines.ai/download, גררו אותה ל-Applications והתחברו.
02
הירשמו ב-tavily.com, פתחו את עמוד API Keys בלוח הבקרה והעתיקו את המפתח שמתחיל ב-tvly-. המסלול החינמי מספיק כדי לנסות את כל מה שבעמוד הזה. אם אתם רוצים רק חיפוש וחילוץ ומעדיפים לא להירשם בכלל, דלגו על השלב הזה: השרת רץ גם בלי מפתח, וקטע פתרון התקלות למטה מסביר בדיוק מה משתנה.
03
חזרה ב-Routines, לחצו על החשבון שלכם בתחתית סרגל הצד ובחרו Settings. פתחו את הקטע Assistant, אחר כך את הלשונית Connections, גללו אל MCP Servers ולחצו על Add MCP Server.
04
הטופס נפתח במצב URL (SSE/HTTP). העבירו אותו ל-Command (stdio): חבילת ה-npm היא פקודה, לא כתובת אינטרנט. Name: Tavily. Command: npx. Arguments: -y tavily-mcp@latest, בדיוק שלוש המילים האלה.
05
ב-Environment Variables הוסיפו את TAVILY_API_KEY עם המפתח שמתחיל ב-tvly-. לחצו Test Connection: Routines מפעילה את השרת בלי לשמור אותו ומדווחת כמה כלים היא מצאה, חמישה עבור השרת הזה. אחר כך לחצו Add Server.
06
הכלים עובדים בצ׳אט מיד. כדי לתת לשגרה מתוזמנת להשתמש בהם, פתחו את השגרה, מצאו את הכרטיס Tools & connections וסמנו את השרת תחת Apps.
רעיונות לשגרות
אחרי שהשרת מחובר, שגרה מתוזמנת יכולה להשתמש בכלים שלו גם כשאתם לא מול המסך. העתיקו פרומפט, הדביקו אותו ב-Routines ובחרו שעה. הפרומפטים כתובים באנגלית בכוונה, מדביקים אותם בדיוק כפי שהם.
Every Monday at 8:00, search the web for news from the last seven days about my three main competitors, group what you find by company, and save it as competitor-watch.md in my Notes folder with a link under every line.
Every Tuesday at 9:00, extract the text of the pricing pages I listed in pricing-urls.md, compare each one with last week's copy saved in the same folder, and write only the changes to pricing-changes.md.
Every Friday at 15:00, research what changed this week in the topic I track, gather it from several sources, and write a one-page brief to research-brief.md with the three most useful links at the bottom.
פתרון תקלות
שגיאות אמיתיות שנלכדו בריצת האימות, מודפסות בדיוק כפי שהשרת החזיר אותן.
מה רואים
[tavily-mcp] no TAVILY_API_KEY set; running in keyless mode. Search and extract are available; other tools will return a message explaining that an API key is required.
הפתרון
זו המלכודת שכדאי להכיר. בלי מפתח השרת לא יוצא ולא מתלונן: הוא עולה למצב keyless חינמי שבו חיפוש וחילוץ ממשיכים לענות, כך שהכל נראה תקין עד שסריקה נכשלת. גרמנו לזה בכוונה כשביטלנו את TAVILY_API_KEY. אם החיפושים עובדים אבל מרגישים מוגבלים בקצב, קראו את פלט ההפעלה: השורה הזו היא כל האזהרה שתקבלו. ב-Routines המפתח נכנס ל-Environment Variables, ב-Claude Desktop וב-Cursor הוא נכנס לבלוק env.
מה רואים
This Tavily endpoint requires an API key. Keyless Tavily currently supports Search and Extract only. Retry using Search or Extract, or sign up at https://tavily.com for a Tavily API key. Continuation options: - Agentic payment (x402): - Sign up for a Tavily API key:
הפתרון
אותו מצב keyless, מהצד השני. זה מה ש-tavily_crawl החזיר לנו כשלא היה מפתח, ו-tavily_map ו-tavily_research מתנהגים באותה צורה. זו תוצאת כלי רגילה ולא קריסה, ולכן עוזר AI עלול לדווח על זה כסירוב מנומס במקום כבעיית הגדרה. הוסיפו מפתח אמיתי וכל חמשת הכלים עונים.
מה רואים
{"error":"Search failed","status":401,"detail":{"error":"Unauthorized: missing or invalid API key."},"documentation":"https://docs.tavily.com/documentation/api-reference/endpoint/search"}הפתרון
זו התשובה של Tavily, לא של השרת: המפתח שלכם הגיע אליהם והם דחו אותו. יצרנו את זה בכוונה כשקראנו לשרת המתארח עם מפתח מומצא. בדקו שהעתקתם את המפתח כולו כולל הקידומת tvly-, שלא הדבקתם אותו עם רווח בסוף, ושהוא לא הוחלף בלוח הבקרה. שימו לב שהחיבור מצליח כך או כך: לחיצת היד אינה מאומתת, ולכן מפתח שגוי מתגלה רק בקריאה האמיתית הראשונה.
מה רואים
Tavily API error: [{"type":"missing","loc":["body","query"],"msg":"Field required","input":{"api_key":"tvly-REDACTED","raw_input":{"api_key":"tvly-REDACTED"}}}]
Documentation: https://docs.tavily.com/documentation/api-reference/endpoint/searchהפתרון
ארגומנט חובה לא הגיע. גרמנו לזה כשקראנו ל-tavily_search בלי query בכלל, וזה מה שקורה כשעוזר בונה את הקריאה ממשתנה ריק. אמרו במילים פשוטות מה לחפש והארגומנט יתמלא מעצמו. שווה לשים לב לדבר אחד בפלט: Tavily מחזירה את מפתח ה-API שלכם בתוך גוף השגיאה. שני הערכים tvly-REDACTED למעלה הם העריכה היחידה שנעשתה בטקסט שנלכד בעמוד הזה, והם שם בדיוק כי ההחזרה הזו אמיתית.
הפתרון
הפקודה npx שייכת ל-Node.js. אם Node לא מותקן על ה-Mac, ההגדרות של Claude Desktop, Cursor ו-Routines למעלה ייכשלו כולן בשלב ההפעלה עוד לפני שהשרת מספיק לומר משהו. התקינו Node מ-nodejs.org, הפעילו מחדש את לקוח ה-MCP ונסו שוב. השרת המתארח בכתובת mcp.tavily.com עוקף את זה לגמרי: הוא לא צריך Node ולא צריך התקנה.
שאלות נפוצות
זו תוכנה קטנה שיושבת בין עוזר AI לבין ממשק החיפוש של Tavily ומדברת Model Context Protocol. אחרי החיבור, עוזר כמו Claude יכול לחפש ברשת החיה, לקרוא עמוד, לסרוק או למפות אתר ולהריץ מחקר ארוך יותר, במקום לנחש ממה שלמד לפני תאריך הידע שלו. Tavily מפרסמת אותו, ואתם יכולים להריץ את חבילת ה-npm על ה-Mac על גבי stdio או להפנות את הלקוח שלכם לנקודת הקצה המתארחת שלהם על גבי HTTPS. [5][7]
השרת הרץ חושף 5 כלים: tavily_search לחיפוש חי ברשת, tavily_extract לשליפת תוכן קריא מתוך כתובות, tavily_crawl לסריקת אתר מעמוד התחלה, tavily_map לרשימת הכתובות שהאתר מכיל, ו-tavily_research למחקר ממספר מקורות ש-Tavily מגבילה לעשרים בקשות בדקה. הטבלה למעלה היא פלט ה-tools/list החי, מילה במילה, והשרת המתארח ענה עם אותם חמישה.
לכל היכולות, כן: מפתח של Tavily שמתחיל ב-tvly-, מחשבון חינמי ב-tavily.com. לחיפוש וחילוץ בלבד, לא. אימתנו את זה כשהרצנו את השרת בלי מפתח: הוא עולה למצב keyless, חיפוש וחילוץ ממשיכים לעבוד מול שכבה חינמית מוגבלת בקצב, וסריקה, מיפוי ומחקר מחזירים הודעה שמבקשת להירשם. המשמעות היא שמפתח חסר לא נראה ככישלון, וזה הסעיף הראשון בפתרון התקלות למעלה. [8][6]
הוא קורא את הרשת הפתוחה ולא שולח שום דבר שלכם מלבד השאילתה והמפתח, כך שסיכון הגישה לקבצים שמלווה שרתים מקומיים אינו רלוונטי כאן. שני דברים כן דורשים תשומת לב. חלק מההגדרות המתועדות מכניסות את המפתח לתוך כתובת גלויה, שנשמרת בהיסטוריית הפקודות ובקובצי הגדרות, ולכן עדיף משתנה סביבה, כותרת bearer או תהליך OAuth. ותוצאות חיפוש הן טקסט שזרים כתבו: התייחסו לכל מה שהכלי מביא כאל קלט לא מהימן, בדיוק כמו לקישור באימייל. [7]
לא. ב-Routines ממלאים את השדות בהגדרות ולוחצים Test Connection; המדריך למעלה מראה כל לחיצה, כולל הצד של Tavily. Claude Desktop דורש עריכה חד-פעמית של קובץ JSON קטן. רק Claude Code הוא כלי טרמינל מטבעו. [12][9]
כל לקוח MCP. לקוחות שמפעילים פקודה מקומית, כמו Claude Desktop, Cursor ו-Routines, מריצים את חבילת ה-npm על גבי stdio. לקוחות שמתחברים לכתובת אינטרנט, כמו Claude Code ו-Routines במצב URL, מתחברים לנקודת הקצה המתארחת. לקוח שיודע רק את הצורה המקומית עדיין יכול להגיע לשרת המתארח דרך הגשר mcp-remote, וזו הצורה שמופיעה בבלוק של Claude Desktop למעלה. [7][10][11][12]
כי אלה שתי בניות שונות של אותו מוצר, ולכדנו את שתיהן באותו יום. חבילת ה-npm שהרצנו דיווחה על עצמה tavily-mcp 0.2.21, וזה תואם לגרסה במאגר. נקודת הקצה המתארחת ב-mcp.tavily.com דיווחה על עצמה tavily-mcp 3.4.5 והציעה יכולות נוספות שלבנייה המקומית אין, ביניהן prompts ו-resources. רשימת הכלים הייתה זהה בשתיהן, וזה החלק שחשוב כשבוחרים ביניהן. [1]
מקורות
כל מה שבעמוד הזה שלא ראינו בעצמנו בריצה מקושר כאן, עם התאריך שבו קראנו אותו. לגבי השאר, הריצה עצמה היא הקבלה.
[1]
Latest version 0.2.21, published 2026-07-10, license MIT.
[2]
Returns not found. The scoped name shown as a badge label on Tavily's docs page is not a published package; the real one is unscoped.
[3]
[4]
2,288 stars, MIT license, not archived, last push 2026-07-30, per the GitHub API.
[5]
Remote and local install paths, client configs, and the optional DEFAULT_PARAMETERS and TAVILY_HUMAN_ID variables.
[6]
The keyless fallback when TAVILY_API_KEY is unset, and the five tool names.
[7]
The hosted endpoint, the local npm install, and the Claude Desktop, Claude Code and Cursor config shapes.
[8]
The keyless header mode, which covers search and extract only, and the rate limits that come with it.
[9]
The official Claude Desktop quickstart and the config file location.
[10]
The claude mcp add syntax, the --transport http flag, --scope user, and custom headers.
[11]
The mcp.json shape, including the env block, and the file locations.
[12]
How Routines runs one-click OAuth connectors and any MCP server.
העמוד הזה מתאר את Tavily כפי שהתנהג בריצה מתוארכת אחת על Mac אחד. גרסאות משתנות: אם משהו כאן כבר לא תואם למה שאתם רואים, תאריך הלכידה בראש העמוד אומר בן כמה הצילום.
מאחורי המדריך הזה
Routines, האפליקציה שמאחורי המדריך הזה, מריצה שרתי MCP כמו זה בלי טרמינל: כך עובדים המחברים. התקצירים שהיא כותבת נשארים קובצי markdown על ה-Mac שלכם, ואין חשבון ענן לשלם. להורדת Routines