Claude Code-та құрал іздеу: агент қажетті MCP құралын қалай табады

Claude Code-қа бірнеше MCP серверін қосқан болсаңыз, құрал іздеу оған әр анықтаманы алдын ала жүктемей, қажет құралдарды сұраныс бойынша жүктеуге мүмкіндік береді. Іске қосылғанда агент кейін жүктелетін құралдардың атаулары мен сервер нұсқауларын алады, содан соң қажет нәрсені каталогтан іздейді. Бұл оған көптеген құралдармен жұмыс істеуге көмектеседі: Anthropic құжаттамасында бір мезгілде 30-50-ден көп құрал жүктелгенде таңдау дәлдігі төмендейтіні айтылған. Бұл — жалпы нұсқаулық, сіздің сеансыңызда өлшенген көрсеткіш емес. Модель қолдаса, құрал іздеу әдепкіде қосулы болады, бірақ платформа, прокси немесе баптаулар оны өшіруі мүмкін.

Ailoot құжаттамасы: API, кілттер және баптау.

Құрал іздеусіз контекстпен не болады#

Әр қосылған 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 орнатқанның өзінде ол құрал іздеуді өшіреді;
• баптаулардағы permissions.deny арқылы ToolSearch құралына тыйым салынған-салынбағанын — мұндай шектеу іздеуді өшіреді;
• қай платформа қолданылатынын — механизм Azure жүйесіндегі Microsoft Foundry орналастыруларында қолжетімсіз, ал Google Cloud Agent Platform жүйесіндегі жұмысы Claude Code нұсқасы мен модельге байланысты.

Бұл тексеру баптауларға қарап күйді бағалауға мүмкіндік береді, бірақ сеанс ішінде бақылауға мүмкіндік бермейді. Agent SDK құжаттамасындағы MCP бөлімі мен құрал іздеу бөлімі интерфейсте «құрал іздеу: қосулы/өшірулі» деген тікелей индикаторды сипаттамайды. Осы екі құжатта бұл туралы айтылмауы мұндай индикатор еш жерде жоқ екенін дәлелдемейді.

Сеансты бастамас бұрын айнымалыны, мысалы, ENABLE_TOOL_SEARCH=auto:15 claude түрінде орнатуға болады. Белгілі бір сервердің құралдары әрдайым жүктеліп тұруы үшін сол сервердің баптауындағы alwaysLoad: true өрісін пайдаланыңыз. Ол сервердің барлық түріне қолжетімді; шарттары мен шектеулері төмендегі alwaysLoad бөлімінде сипатталған.

Құрал іздеу қалай жұмыс істейді#

Құрал іздеу қосылғанда, сеанс басталған сәтте контекстке тек кейін жүктелетін құралдардың атаулары мен сервер нұсқаулары ғана жүктеледі. Сервер нұсқаулары сервердің қандай тапсырмаларға пайдалы екенін сипаттайды. Тапсырмаға контексте әлі жоқ мүмкіндік қажет болғанда, агент каталогтан лайықты құралды өзі іздейді.

Agent SDK құжаттамасында іздеу механизмі толығырақ сипатталған: әдепкіде бір іздеу каталогтағы ең сәйкес бес құралға дейін жүктейді. Агент оларды тапқан хабарламаларды SDK ықшамдағанша, олар сеанстың кейінгі кезектерінде қолжетімді болып қалады. Ықшамдаудан кейін бұрын табылған құралдар контекстен шығып қалуы мүмкін, сондықтан келесіде қажет болғанда агент оларды қайта іздейді. Каталог 10 000 құралға дейін қолдайды. Claude Code-тың өз MCP құжаттамасында бұл нақты көрсеткіштер берілмеген, бірақ кейін жүктеу қағидасы сипатталған.

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 хосты. ANTHROPIC_BASE_URL айнымалысы үшінші тарап хостына бағытталса, Claude Code құрал іздеуді өшіреді: проксилердің көбі арнайы tool_reference блоктарын өткізбейді. Бұл Anthropic мекенжайына тікелей қосылмай, Claude-қа өз шлюзіңіз немесе прокси серверіңіз арқылы қосылғанда қолданылады. Өшіру себебі — стандартты емес ANTHROPIC_BASE_URL; жазылым ақысын қалай төлейтініңіз бұған өздігінен себеп болмайды. Бұл әрекетті өзгерту үшін ENABLE_TOOL_SEARCH айнымалысын арнайы орнатуға болады. Егер проксидің өзі tool_reference блоктарын қолдамаса, механизмді мәжбүрлеп қосу сұрау қатесіне әкеледі. Мұндай жағдайда ол анықтамаларды алдын ала жүктеуге көшпейді.

Орналастыру платформасы. Құрал іздеу Azure жүйесінде орналасқан Microsoft Foundry орналастыруларында жұмыс істемейді: сервер сұрауды қабылдамайды, ал 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 орнатуы мұны өзгертпейді. Ерекшелік — Claude Code 2.1.227 нұсқасынан бастап қолжетімді басқарылатын баптаулар арқылы ұйым құрал іздеуді қосулы ұстайтын жағдай.

alwaysLoad не істейді және ол контекст пен іске қосылуға қалай әсер етеді#

Сервер баптауындағы alwaysLoad: true өрісі сервердің барлық түріне қолжетімді. Ол қолданылғанда, ENABLE_TOOL_SEARCH мәніне қарамастан, сол сервердің барлық құралы іске қосылғанда контекстке жүктеледі. Агентке оларды қолданар алдында іздеудің қажеті жоқ.

Құралдарды әрдайым жүктеудің екі салдары бар. Алдын ала жүктелген әр құрал тапсырманың өзіне жұмсауға болатын контекстің бір бөлігін алады. Бұған қоса, сеанстың іске қосылуы осы сервердің қосылуын стандартты бес секундтық күту шегінде күтеді.

Ерекшелік — жарамды кэштелген жазбасы бар қашықтағы сервер: ол қосылмай-ақ құралдарды кэштен береді және іске қосылуды кешіктірмейді. Функцияны кезең-кезеңімен тарату кезінде тіркелгіге алдын ала қосылмаған болса, табу кэші әдепкіде өшірулі болады. Оны MCP_DISCOVERY_CACHE=1 арқылы да арнайы қосуға болады. Жылдам іске қосылу ерекшелігі кэш белсенді болып, ішінде жарамды жазба болғанда қолданылады. alwaysLoad арқылы жүктелген құралдар іздеу арқылы жұмыс істегенде агентке қажет болар-болмасына қарамастан, контексте тұрақты түрде орын алады.

Жеке MCP серверін жазатындарға: сервер нұсқаулары Claude-қа Skills сияқты, өз құралдарын қашан іздеу керегін түсінуге көмектеседі. Claude Code әдепкіде әр құрал сипаттамасын және әр сервер нұсқауын 2048 таңбаға дейін қысқартады, сондықтан маңызды мәліметтерді басына қойыңыз.

Claude Code-ты кеңейту жолын таңдау қосылған MCP серверлерінің санына ғана байланысты емес. Claude Code: бір уақытта қанша кеңейтімді сақтау керек және Claude Code-та нені таңдау керек: Skills, Subagents, MCP әлде Plugins нұсқаулықтарында әртүрлі тапсырмаларға арналған Skills, Subagents, MCP және Plugins қарастырылған. Нақты MCP серверлерін қадамдап баптау үшін Claude Code-қа арналған MCP серверлері: дайын жинақтар нұсқаулығын қараңыз.

Әрі қарай не істеу керек#

Шамамен 10-нан аз құралдан тұратын, анықтамалары контекске еш қиындықсыз сыятын жиын үшін Agent SDK құжаттамасында олардың барлығын бірден жүктеу әдетте жылдамырақ екені айтылған. Алайда Claude Code-тың әдепкі әрекетінде, айнымалы орнатылмаған және жоғарыдағы шектеулердің ешқайсысы қолданылмаған жағдайда, құрал іздеу қосулы болады да, alwaysLoad қолданылған серверлерден басқа MCP құралдарын жүктеу іздеуге дейін кейінге қалдырылады.

Мұнда 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 параметрін сеанстың әр кезегінде құралдары керек серверлерге ғана қолданыңыз; басқаларын іздеу арқылы жүктеуге қалдырыңыз.

Егер Ailoot арқылы AI модельдеріне қол жеткізу қажет болса, Ailoot сайтын қараңыз.