# חיפוש כלים ב-Claude Code: איך הסוכן מוצא את כלי ה-MCP הדרוש לו

> איך פועל חיפוש כלים ב-Claude Code: מה נטען להקשר מיד, מתי המנגנון מכבה את עצמו ואיך להגדיר את ENABLE_TOOL_SEARCH ואת alwaysLoad.

Source: https://ailoot.ai/blog/he/claude-code-tool-search-mcp-limit/
Canonical: https://ailoot.ai/blog/he/claude-code-tool-search-mcp-limit/
Language: he
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-055
Revision: sha256-364bb692a336b641b798971cace42b4e7ff7993ef1d7ef2a56248ce13874de4a


אם חיברתם כמה שרתי MCP ל-Claude Code, חיפוש כלים מאפשר לו לטעון לפי דרישה את הכלים הדרושים לו, בלי לטעון מראש כל הגדרה. בעת ההפעלה, הסוכן מקבל את שמות הכלים המושהים ואת ההוראות של השרתים, ואז מחפש בקטלוג את מה שהוא צריך. כך הוא יכול לעבוד עם מערך גדול של כלים: התיעוד של Anthropic מציין שדיוק הבחירה יורד כשיותר מ-30-50 כלים נטענים בבת אחת. זו הנחיה כללית, לא מדידה של ההפעלה שלכם. חיפוש כלים מופעל כברירת מחדל כשהמודל תומך בו, אך הפלטפורמה, פרוקסי או ההגדרות עשויים להשבית אותו.

[תיעוד Ailoot: API, מפתחות והגדרה](https://ailoot.ai/docs/).

## מה קורה להקשר ללא חיפוש כלים

כל שרת MCP מחובר מוסיף את הכלים שלו לרשימת הדברים שהסוכן יכול להפעיל. ללא חיפוש כלים, ההגדרות שלהם — שם, תיאור וסכמת פרמטרים — נטענות מראש להקשר. השרתים מתחברים ברקע כשמתחילה הפעלה. אם נדרש כלי משרת שעדיין לא סיים להתחבר, Claude Code ממתין באמצעות הכלי הפנימי `WaitForMcpServers`. אפשר להעריך בנפרד, עבור כל חיבור, כמה כלים ואסימונים שרת מסוים מוסיף.

התיעוד הרשמי של Anthropic מציג שני נתונים משוערים (מספרים כלליים, ללא שיטת מדידה מצוינת):

- 50 כלים עשויים לתפוס 10-20 אלף אסימוני הקשר;
- הדיוק בבחירת הכלי הנכון יורד כשיותר מ-30-50 כלים נטענים בבת אחת.

## איך להעריך את חיפוש הכלים לפי ההגדרות

כדי להבין אם חיפוש כלים אמור לפעול בהפעלה הנוכחית, בדקו את התנאים הבאים:

- איזה מודל משיב — Sonnet/Haiku/Opus 4.5 או חדש יותר: המנגנון זמין; מודל ישן יותר: הוא אינו זמין;
- האם `ANTHROPIC_BASE_URL` מוגדר למארח לא סטנדרטי — במקרה כזה, המנגנון כבוי כברירת מחדל, אלא אם הופעל במפורש באמצעות `ENABLE_TOOL_SEARCH`;
- מה הערך של המשתנה `ENABLE_TOOL_SEARCH` — `false` משבית את המנגנון לחלוטין; `auto`/`auto:N` מפעיל אותו רק כשהיקף ההגדרות מגיע לסף מסוים;
- האם `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` מוגדר — בהיעדר הגדרות מנוהלות של הארגון, הוא משאיר את חיפוש הכלים כבוי גם אם המשתמש הגדיר `ENABLE_TOOL_SEARCH`;
- האם הכלי `ToolSearch` חסום באמצעות `permissions.deny` בהגדרות — הגבלה כזאת משביתה את החיפוש;
- באיזו פלטפורמה משתמשים — המנגנון אינו זמין בפריסות Microsoft Foundry ב-Azure, ואילו ב-Google Cloud Agent Platform התנהגותו תלויה בגרסת Claude Code ובמודל.

הבדיקה הזאת מאפשרת להעריך את המצב לפי התצורה, אך לא לצפות בו בתוך ההפעלה. סעיף MCP וסעיף חיפוש הכלים בתיעוד Agent SDK אינם מתארים מחוון ישיר בממשק שמציג “חיפוש כלים: פועל/כבוי”. היעדר אזכור בשני המסמכים האלה אינו מוכיח שאין מחוון כזה בשום מקום.

אפשר להגדיר את המשתנה לפני תחילת ההפעלה, למשל `ENABLE_TOOL_SEARCH=auto:15 claude`. כדי להבטיח שהכלים של שרת מסוים תמיד ייטענו, השתמשו בשדה `alwaysLoad: true` בתצורת השרת. הוא זמין לכל סוגי השרתים; התנאים והמגבלות מתוארים בהמשך, בסעיף alwaysLoad.

## איך פועל חיפוש כלים

כשחיפוש כלים מופעל, בתחילת ההפעלה נטענים להקשר רק שמות הכלים המושהים וההוראות של השרת. הוראות השרת מתארות לאילו משימות השרת מתאים. כשמשימה דורשת יכולת שעדיין אינה בהקשר, הסוכן מחפש בעצמו בקטלוג כלי מתאים.

התיעוד של Agent SDK מתאר את מנגנון החיפוש בפירוט רב יותר: כברירת מחדל, חיפוש יחיד טוען עד חמישה מהכלים הרלוונטיים ביותר מהקטלוג. הם נשארים זמינים בתורות הבאים של ההפעלה עד שה-SDK מצמצם את ההודעות שבהן הסוכן מצא אותם. לאחר הצמצום, כלים שהתגלו קודם עשויים להיפלט מההקשר, והסוכן מחפש אותם שוב בפעם הבאה שיידרשו. הקטלוג תומך בעד 10 000 כלים. תיעוד MCP של Claude Code עצמו אינו מציין את הנתונים המסוימים האלה, אך מתאר את אותו עיקרון של טעינה מושהית.

לפי התיעוד של Agent SDK, כל חיפוש מוסיף סבב הלוך ושוב אחד. התיעוד אינו מפרט בדיוק מה כולל הסבב הזה. עבור Claude Code, תיעוד MCP מתאר גם הבדל בדיווח על שגיאות: ללא חיפוש כלים, Claude Code אינו מודיע למודל על כשל בחיבור לשרתים. כשהחיפוש מופעל, המודל מקבל מידע על השרת שלא הצליח להתחבר ועל השגיאה שהתרחשה.

Claude Code אינו קובע מגבלה קבועה על מספר הכלים משרת יחיד. המגבלה המעשית היא תקציב חלון ההקשר של ההפעלה המסוימת.

הגדרת כלים היא אחת המשימות הכרוכות בניהול ההקשר של סוכן AI.



## מתי חיפוש כלים מושבת כברירת מחדל

המנגנון מופעל כברירת מחדל, אך פעולתו תלויה במודל, במארח ה-API ובפלטפורמה.

**מודל.** חיפוש כלים דורש מודל שתומך בבלוקים מסוג tool_reference: Claude Sonnet 4.5, Claude Haiku 4.5, Claude Opus 4.5 או גרסה מאוחרת יותר. עבור מודלים ישנים יותר, Claude Code טוען את הגדרות הכלים מראש.

**מארח API.** Claude Code משבית חיפוש כלים כשהמשתנה `ANTHROPIC_BASE_URL` מצביע למארח של צד שלישי: רוב הפרוקסים אינם מעבירים את בלוקי tool_reference המיוחדים. הדבר חל בעת התחברות ל-Claude דרך שער או שרת פרוקסי משלכם, במקום ישירות דרך הכתובת של Anthropic. הסיבה להשבתה היא `ANTHROPIC_BASE_URL` לא סטנדרטי; אופן התשלום על המינוי אינו גורם לכך כשלעצמו. אפשר להגדיר במפורש את `ENABLE_TOOL_SEARCH` כדי לעקוף את ההתנהגות הזאת. אם הפרוקסי עצמו אינו תומך בבלוקי tool_reference, אילוץ הפעלת המנגנון יגרום לשגיאת בקשה. במקרה כזה, לא תהיה חזרה לטעינת ההגדרות מראש.

**פלטפורמת פריסה.** חיפוש כלים אינו פועל בפריסות Microsoft Foundry שמתארחות ב-Azure: השרת דוחה את הבקשה, ו-`ENABLE_TOOL_SEARCH` אינו עוקף זאת. ב-Google Cloud Agent Platform, לפני Claude Code בגרסה 2.1.221, המנגנון היה כבוי בכל המודלים, אלא אם `ENABLE_TOOL_SEARCH=true` הוגדר במפורש. החל מגרסה זו, הוא מופעל כברירת מחדל ב-Opus/Sonnet/Haiku 4.5 ובגרסאות חדשות יותר. עבור מודלים ישנים יותר בפלטפורמה, Claude Code עדיין טוען את כל הכלים מראש, כי תשתית השרת שלהם דוחה את הכותרת הפנימית הנדרשת.

למשתנה `ENABLE_TOOL_SEARCH` יש חמש הגדרות אפשריות:

- לא מוגדר — ההתנהגות הרגילה, למעט החריגים המפורטים למעלה;
- `true` — המנגנון מופעל במודלים שתומכים בו, למעט שני מקרים: Azure Foundry ומודלים ישנים יותר ב-Agent Platform; בקשות שנשלחות דרך פרוקסי שאינו תומך בבלוקי tool_reference ייכשלו;
- `auto` — Claude Code טוען כלים מראש כל עוד ההגדרות המשולבות שלהם תופסות פחות מ-10% מחלון ההקשר, ועובר לטעינה מושהית כשהסף הזה נחצה;
- `auto:N` — אותו עיקרון, עם סף אחוזים שנקבע ידנית;
- `false` — המנגנון מושבת לחלוטין וכל הכלים נטענים מראש.

יש גם את המשתנה `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`: אם הוא מוגדר, חיפוש הכלים נשאר כבוי, והגדרת `ENABLE_TOOL_SEARCH` בידי המשתמש אינה משנה זאת. החריג הוא מצב שבו הארגון משאיר את חיפוש הכלים מופעל באמצעות הגדרות מנוהלות, הזמינות החל מגרסה 2.1.227 של Claude Code.

## מה עושה alwaysLoad ואיך הוא משפיע על ההקשר וההפעלה

השדה `alwaysLoad: true` בתצורת שרת זמין לכל סוגי השרתים. בעזרתו, כל הכלים של אותו שרת נטענים להקשר בתחילת ההפעלה, ללא קשר להגדרת `ENABLE_TOOL_SEARCH`. הסוכן אינו צריך לחפש אותם לפני השימוש.

לטעינה תמידית של כלים יש שתי השלכות. כל כלי שנטען מראש תופס חלק מההקשר שהיה זמין אחרת למשימה עצמה. בנוסף, תחילת ההפעלה ממתינה עד שהשרת יתחבר, במסגרת זמן ההמתנה הרגילה של חמש שניות.

החריג הוא שרת מרוחק עם רשומה תקפה שמורה במטמון: הוא מספק את הכלים מהמטמון בלי להתחבר, ואינו מעכב את תחילת ההפעלה. מטמון הגילוי כבוי כברירת מחדל, אלא אם הוא כבר הופעל בחשבון במהלך ההשקה ההדרגתית של התכונה. אפשר גם להפעיל אותו במפורש באמצעות `MCP_DISCOVERY_CACHE=1`. החריג של ההפעלה המהירה חל כשהמטמון פעיל ומכיל רשומה תקפה. כלים עם `alwaysLoad` עדיין תופסים מקום בהקשר באופן קבוע, בין שהסוכן היה זקוק להם בעבודה דרך החיפוש ובין שלא.

למי שכותבים שרת MCP משלהם: הוראות השרת עוזרות ל-Claude להבין מתי לחפש את הכלים שלו, בדומה ל-Skills. Claude Code מקצר כברירת מחדל את התיאור של כל כלי ואת ההוראות של כל שרת ל-2048 תווים, לכן הציבו את הפרטים הקריטיים בהתחלה.

בחירת הדרך להרחבת Claude Code תלויה ביותר ממספר שרתי ה-MCP המחוברים. המדריכים [Claude Code: כמה הרחבות להשאיר פעילות בו-זמנית](https://ailoot.ai/blog/he/claude-code-skills-subagents-mcp-plugins/) ו-[מה לבחור ב-Claude Code: Skills, Subagents, MCP או Plugins](https://ailoot.ai/blog/he/skills-subagents-mcp-plugins-claude-code/) בוחנים את Skills, Subagents, MCP ו-Plugins עבור משימות שונות. להגדרה של שרתי MCP מסוימים צעד אחר צעד, ראו [שרתי MCP ל-Claude Code: שילובים מוכנים](https://ailoot.ai/blog/he/mcp-servers-claude-code/).

## מה הלאה

עבור מערך של פחות מכ-10 כלים שההגדרות שלהם נכנסות להקשר בלי קושי, התיעוד של Agent SDK מציין שטעינת כולם בבת אחת בדרך כלל מהירה יותר. עם זאת, בהתנהגות ברירת המחדל של Claude Code, כשהמשתנה אינו מוגדר ואף אחת מהמגבלות שלמעלה אינה חלה, חיפוש כלים מופעל וטעינת כלי MCP נדחית עד לחיפוש, למעט שרתים עם `alwaysLoad`.

במקרה זה, אפשר להגדיר במפורש `ENABLE_TOOL_SEARCH=auto`: ההגדרות ייטענו מראש כל עוד הנפח המשולב שלהן קטן מ-10% מחלון ההקשר, והחיפוש יופעל כשהסף יושג. אפשרות נוספת היא `ENABLE_TOOL_SEARCH=false` אם ידוע לכם שהמערך לא יגדל. במקרה כזה, Claude Code יפסיק להודיע למודל על כשלים בחיבור לשרת, כפי שתואר למעלה.

במקרים אחרים, בדקו שוב את תנאי הפעולה כשהסביבה משתנה:

- עברו ל-Sonnet/Haiku/Opus 4.5 או לגרסה חדשה יותר אם ההפעלה משתמשת במודל ישן יותר;
- אם החיבור משתמש ב-`ANTHROPIC_BASE_URL` לא סטנדרטי, הגדירו במפורש `ENABLE_TOOL_SEARCH=true` רק כשהפרוקסי עצמו מעביר בלוקי tool_reference;
- ודאו שפלטפורמת הפריסה אינה ברשימת החריגים: Azure Foundry או מודלים ישנים יותר ב-Google Cloud Agent Platform.

אם התנאים מתקיימים וההגדרות אינן חוסמות את החיפוש, תוכלו לחבר את שרתי ה-MCP הדרושים לכם. השתמשו ב-`alwaysLoad` רק עבור שרתים שהכלים שלהם דרושים בכל תור של ההפעלה; את האחרים השאירו לטעינה באמצעות חיפוש.

<div class="section" role="doc-bibliography" aria-label="Sources">

### מקורות

- [MCP ב-Claude Code, סעיף “Scale with MCP tool search” — התיעוד הרשמי של Anthropic](https://code.claude.com/docs/en/mcp.md)
- [חיפוש כלים ב-Agent SDK — התיעוד הרשמי של Anthropic](https://code.claude.com/docs/en/agent-sdk/tool-search.md)

</div>



אם אתם זקוקים לגישה למודלים של AI דרך Ailoot, בקרו ב-[Ailoot](https://ailoot.ai/).

## שאלות ותשובות: חיפוש כלים ב-Claude Code: איך הסוכן מוצא את כלי ה-MCP הדרוש לו

### למה חיפוש כלים עלול להיכשל מאחורי פרוקסי גם כשהוא מופעל?

מארח API של צד שלישי צריך לתמוך בבלוקי tool_reference. כפיית ENABLE_TOOL_SEARCH אינה יכולה להוסיף את התמיכה; פרוקסי לא תואם עלול לדחות את הבקשה במקום לעבור לטעינה מראש.

### מתי להגדיר alwaysLoad לשרת MCP?

השתמשו בו כשכלי השרת דרושים בכל תור. אז כל הגדרות הכלים שלו תופסות הקשר בזמן האתחול, והאתחול עשוי להמתין לחיבור אלא אם קיימת רשומה תקפה במטמון גילוי הכלים.


## Ailoot · החברה ופורטפוליו הפרויקטים שלה

Ailoot נשענת על ניסיון תפעולי מצטבר, בסיס לקוחות רחב, שירות יציב ובקרה שוטפת של KPI.

החברה ופורטפוליו הפרויקטים שלה: מיליוני לקוחות; מכירות בהיקף של מיליארדים מדי חודש.

Ailoot משתמשת בניסיון התפעולי הזה כדי לספק גישת API ליכולות AI במוצרי לקוחות, בסוכנים, באפליקציות ובאוטומציות.