Claude Code’da vositalarni qidirish: agent kerakli MCP vositasini qanday topadi

Agar Claude Code’ga bir nechta MCP serverini ulagan bo‘lsangiz, vositalarni qidirish unga barcha ta’riflarni oldindan yuklamasdan, kerakli vositalarni talab bo‘yicha yuklash imkonini beradi. Ishga tushganda agent kechiktirilgan vositalar nomlari va serverlar ko‘rsatmalarini oladi, keyin kerakli narsani katalogdan qidiradi. Bu unga katta vositalar to‘plami bilan ishlashga yordam beradi: Anthropic hujjatlarida bir vaqtning o‘zida 30-50 tadan ortiq vosita yuklanganda tanlash aniqligi pasayishi aytilgan. Bu umumiy tavsiya, seansingizdagi o‘lchov emas. Model qo‘llab-quvvatlasa, vositalarni qidirish sukut bo‘yicha yoqilgan bo‘ladi, biroq platforma, proksi yoki sozlamalar uni o‘chirishi mumkin.

Ailoot hujjatlari: API, kalitlar va sozlash.

Vositalarni qidirishsiz kontekst bilan nima sodir bo‘ladi#

Har bir ulangan MCP serveri agent chaqira oladigan narsalar ro‘yxatiga o‘z vositalarini qo‘shadi. Vositalarni qidirishsiz ularning ta’riflari — nomi, tavsifi va parametrlar sxemasi — oldindan kontekstga yuklanadi. Seans boshlanganda serverlar fonda ulanadi. Agar hali ulanishni tugatmagan serverdagi vosita kerak bo‘lsa, Claude Code ichki WaitForMcpServers vositasi orqali kutadi. Har bir ulanish bo‘yicha alohida server nechta vosita va token qo‘shishini baholashingiz mumkin.

Anthropic’ning rasmiy hujjatlarida ikkita taxminiy ko‘rsatkich keltirilgan (o‘lchash usuli ko‘rsatilmagan umumiy raqamlar):

• 50 ta vosita 10-20 mingta kontekst tokenini egallashi mumkin;
• bir vaqtning o‘zida 30-50 tadan ortiq vosita yuklanganda kerakli vositani tanlash aniqligi pasayadi.

Sozlamalardan vositalarni qidirish holatini qanday baholash mumkin#

Joriy seansda vositalarni qidirish ishlashi kerakmi-yo‘qmi, tushunish uchun quyidagi shartlarni tekshiring:

• qaysi model javob beryapti — Sonnet/Haiku/Opus 4.5 yoki yangiroq: mexanizm mavjud; eskiroq model: mavjud emas;
• ANTHROPIC_BASE_URL nostandart xostga o‘rnatilganmi — bunday holda ENABLE_TOOL_SEARCH orqali aniq yoqilmaguncha, mexanizm sukut bo‘yicha o‘chiq bo‘ladi;
• ENABLE_TOOL_SEARCH o‘zgaruvchisining qiymati — false mexanizmni butunlay o‘chiradi; auto/auto:N uni faqat ta’riflar hajmi chegaraga yetganda yoqadi;
• CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS o‘rnatilganmi — tashkilotning boshqariladigan sozlamalari bo‘lmasa, foydalanuvchi ENABLE_TOOL_SEARCH o‘rnatgan taqdirda ham vositalarni qidirishni o‘chiq saqlaydi;
• sozlamalardagi permissions.deny orqali ToolSearch vositasi bloklanganmi — bunday cheklov qidirishni o‘chiradi;
• qaysi platforma ishlatilmoqda — Azure’dagi Microsoft Foundry joylashtirishlarida mexanizm mavjud emas, Google Cloud Agent Platform’da esa uning xatti-harakati Claude Code versiyasi va modelga bog‘liq.

Bu tekshiruv konfiguratsiyadan holatni baholashga imkon beradi, ammo seans ichida kuzatmaydi. Agent SDK hujjatlaridagi MCP bo‘limi va vositalarni qidirish bo‘limida interfeysda to‘g‘ridan-to‘g‘ri “vositalarni qidirish: yoqilgan/o‘chiq” indikatori borligi aytilmagan. Ushbu ikki hujjatda bunday indikator tilga olinmagani uning hech qayerda mavjud emasligini isbotlamaydi.

O‘zgaruvchini seansni boshlashdan oldin, masalan ENABLE_TOOL_SEARCH=auto:15 claude shaklida o‘rnatishingiz mumkin. Muayyan server vositalari doim yuklanishini ta’minlash uchun o‘sha server konfiguratsiyasidagi alwaysLoad: true maydonidan foydalaning. U barcha server turlari uchun mavjud; shartlari va cheklovlari quyidagi alwaysLoad bo‘limida keltirilgan.

Vositalarni qidirish qanday ishlaydi#

Vositalarni qidirish yoqilganda, seans ishga tushishida kontekstga faqat kechiktirilgan vositalar nomlari va server ko‘rsatmalari yuklanadi. Server ko‘rsatmalarida server qaysi vazifalar uchun foydali ekani tasvirlanadi. Vazifa hali kontekstda bo‘lmagan imkoniyatni talab qilganda, agent katalogdan mos vositani o‘zi qidiradi.

Agent SDK hujjatlarida qidiruv mexanizmi batafsilroq tasvirlangan: sukut bo‘yicha bitta qidiruv katalogdagi eng mos beshtagacha vositani yuklaydi. SDK agent ularni topgan xabarlarni ixchamlashtirguncha, ular seansning keyingi navbatlari uchun ham mavjud bo‘lib turadi. Ixchamlashtirilgandan so‘ng, avval topilgan vositalar kontekstdan chiqib ketishi mumkin va agent keyingi safar kerak bo‘lganda ularni yana qidiradi. Katalog 10 000 tagacha vositani qo‘llab-quvvatlaydi. Claude Code’ning o‘zidagi MCP hujjatlarida bu aniq raqamlar keltirilmagan, ammo kechiktirib yuklash tamoyili xuddi shunday tasvirlangan.

Agent SDK hujjatlariga ko‘ra, har bir qidiruv bitta qo‘shimcha so‘rov-javob almashinuvini qo‘shadi. Hujjatlarda bu almashinuv aynan nimalarni o‘z ichiga olishi ko‘rsatilmagan. Claude Code uchun MCP hujjatlarida xatolar haqida xabar berishdagi farq ham tasvirlangan: vositalarni qidirishsiz, Claude Code server ulanishidagi xatolarni modelga bildirmaydi. Qidiruv yoqilganda esa model qaysi serverga ulanib bo‘lmagani va xato nima bo‘lganini biladi.

Claude Code bitta serverdan olinadigan vositalar soniga qat’iy chegara qo‘ymaydi. Amaliy chegara — muayyan seans uchun kontekst oynasi budjeti.

Vositalarni sozlash — AI agent kontekstini boshqarish vazifalaridan biri.

Vositalarni qidirish sukut bo‘yicha qachon o‘chiq bo‘ladi#

Mexanizm sukut bo‘yicha yoqilgan, ammo uning ishlashi model, API xosti va platformaga bog‘liq.

Model. Vositalarni qidirish tool_reference bloklarini qo‘llab-quvvatlaydigan modelni talab qiladi: Claude Sonnet 4.5, Claude Haiku 4.5, Claude Opus 4.5 yoki undan yangiroq. Eskiroq modellar uchun Claude Code vositalar ta’riflarini oldindan yuklaydi.

API xosti. ANTHROPIC_BASE_URL o‘zgaruvchisi uchinchi tomon xostiga ishora qilganda, Claude Code vositalarni qidirishni o‘chiradi: ko‘pchilik proksilar maxsus tool_reference bloklarini uzatmaydi. Bu Anthropic manziliga bevosita ulanish o‘rniga, Claude’ga o‘z shlyuzingiz yoki proksi serveringiz orqali ulanganda amal qiladi. O‘chirish sababi nostandart ANTHROPIC_BASE_URL; obuna uchun qanday to‘lov qilinishi bunga o‘z-o‘zidan sabab bo‘lmaydi. Bu xatti-harakatni o‘zgartirish uchun ENABLE_TOOL_SEARCH ni aniq o‘rnatishingiz mumkin. Agar proksining o‘zi tool_reference bloklarini qo‘llab-quvvatlamasa, mexanizmni majburan yoqish so‘rov xatosiga olib keladi. Bunday holda ta’riflarni oldindan yuklashga qaytilmaydi.

Joylashtirish platformasi. Vositalarni qidirish Azure’da joylashtirilgan Microsoft Foundry’da ishlamaydi: server so‘rovni rad etadi va ENABLE_TOOL_SEARCH bu cheklovni bekor qilmaydi. Google Cloud Agent Platform’da Claude Code’ning 2.1.221 versiyasidan oldin, ENABLE_TOOL_SEARCH=true aniq o‘rnatilmasa, mexanizm barcha modellar uchun o‘chiq edi. Shu versiyadan boshlab u Opus/Sonnet/Haiku 4.5 va yangiroq modellar uchun sukut bo‘yicha yoqiladi. Platformadagi eskiroq modellar uchun Claude Code barcha vositalarni oldindan yuklashda davom etadi, chunki ularning server infratuzilmasi talab qilinadigan ichki sarlavhani rad etadi.

ENABLE_TOOL_SEARCH o‘zgaruvchisining beshta mumkin bo‘lgan sozlamasi bor:

• o‘rnatilmagan — yuqorida sanalgan istisnolardan tashqari standart xatti-harakat;
• true — uni qo‘llab-quvvatlaydigan modellarda mexanizm yoqiladi, ikkita holat bundan mustasno: Azure Foundry va eskiroq Agent Platform modellari; tool_reference bloklarini qo‘llab-quvvatlamaydigan proksi orqali yuborilgan so‘rovlar muvaffaqiyatsiz bo‘ladi;
• auto — Claude Code vositalarning jamlangan ta’riflari kontekst oynasining 10% idan kam joy egallab turganda ularni oldindan yuklaydi va shu chegaraga yetgach kechiktirib yuklashga o‘tadi;
• auto:N — xuddi shu tamoyil, foiz chegarasi qo‘lda ko‘rsatiladi;
• false — mexanizm butunlay o‘chiriladi va barcha vositalar oldindan yuklanadi.

Yana CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS o‘zgaruvchisi ham bor: u o‘rnatilgan bo‘lsa, vositalarni qidirish o‘chiq qoladi va foydalanuvchining ENABLE_TOOL_SEARCH ni o‘rnatishi buni o‘zgartirmaydi. Istisno — tashkilot Claude Code’ning 2.1.227 versiyasidan boshlab mavjud bo‘lgan boshqariladigan sozlamalar orqali vositalarni qidirishni yoqib qo‘ygan holat.

alwaysLoad nima qiladi va u kontekst hamda ishga tushishga qanday ta’sir qiladi#

Server konfiguratsiyasidagi alwaysLoad: true maydoni barcha server turlari uchun mavjud. U bilan, ENABLE_TOOL_SEARCH sozlamasidan qat’i nazar, shu serverning barcha vositalari ishga tushishda kontekstga yuklanadi. Agent ulardan foydalanishdan oldin qidirishi shart emas.

Vositalarni doim yuklashning ikkita oqibati bor. Oldindan yuklangan har bir vosita vazifaning o‘zi uchun ishlatilishi mumkin bo‘lgan kontekstning bir qismini egallaydi. Bundan tashqari, seans ishga tushganda ushbu serverning ulanishi standart besh soniyalik kutish vaqti doirasida kutiladi.

Istisno — yaroqli keshlangan yozuvga ega masofaviy server: u ulanmasdan, vositalarni keshlangan nusxadan beradi va ishga tushishni kechiktirmaydi. Funksiya asta-sekin joriy etilayotgan paytda hisob uchun oldindan yoqilmagan bo‘lsa, topish keshi sukut bo‘yicha o‘chiq bo‘ladi. Uni MCP_DISCOVERY_CACHE=1 orqali ham aniq yoqishingiz mumkin. Tez ishga tushish istisnosi kesh faol bo‘lib, unda yaroqli yozuv mavjud bo‘lganda amal qiladi. Agent qidiruv orqali ishlaganda bu vositalar kerak bo‘larmidi-yo‘qmi, bundan qat’i nazar, alwaysLoad bilan yuklangan vositalar kontekstda doimiy joy egallaydi.

O‘z MCP serverini yozayotganlar uchun: server ko‘rsatmalari Claude’ga o‘z vositalarini qachon qidirish kerakligini tushunishga yordam beradi, xuddi Skills kabi. Claude Code sukut bo‘yicha har bir vosita tavsifi va har bir server ko‘rsatmasini 2048 belgigacha qisqartiradi, shuning uchun muhim tafsilotlarni boshiga joylashtiring.

Claude Code’ni qanday kengaytirishni tanlash ulangan MCP serverlari sonidan ko‘proq narsaga bog‘liq. Claude Code: bir vaqtda nechta kengaytmani saqlash kerak va Claude Code’da nimani tanlash kerak: Skills, Subagents, MCP yoki Plugins qo‘llanmalari turli vazifalar uchun Skills, Subagents, MCP va Plugins’ni ko‘rib chiqadi. Muayyan MCP serverlarini bosqichma-bosqich sozlash uchun Claude Code uchun MCP serverlari: tayyor kombinatsiyalar qo‘llanmasiga qarang.

Keyingi qadamlar#

Ta’riflari qiyinchiliksiz kontekstga sig‘adigan taxminan 10 tadan kam vosita uchun Agent SDK hujjatlarida ularni birdaniga yuklash odatda tezroq ekani qayd etilgan. Biroq Claude Code’ning standart xatti-harakatida, o‘zgaruvchi o‘rnatilmagan va yuqoridagi cheklovlarning hech biri qo‘llanmagan bo‘lsa, vositalarni qidirish yoqilgan bo‘ladi va MCP vositalari qidiruvgacha kechiktirib yuklanadi; alwaysLoad bilan belgilangan serverlar bundan mustasno.

Bu yerda ENABLE_TOOL_SEARCH=auto ni aniq o‘rnatishingiz mumkin: ta’riflarning jamlangan hajmi kontekst oynasining 10% idan kam bo‘lsa, ular oldindan yuklanadi, chegara oshgach esa qidiruv yoqiladi. To‘plam kattalashmasligini bilsangiz, yana bir imkoniyat — ENABLE_TOOL_SEARCH=false. Bunday holda, yuqorida aytilganidek, Claude Code server ulanishidagi xatolar haqida modelga xabar berishni to‘xtatadi.

Boshqa holatlarda muhit o‘zgarganda ishlash shartlarini yana tekshiring:

• seansda eskiroq model ishlatilayotgan bo‘lsa, Sonnet/Haiku/Opus 4.5 yoki yangirog‘iga o‘ting;
• ulanishda nostandart ANTHROPIC_BASE_URL ishlatilsa, faqat proksining o‘zi tool_reference bloklarini uzatgan taqdirdagina ENABLE_TOOL_SEARCH=true ni aniq o‘rnating;
• joylashtirish platformasi istisnolar ro‘yxatida emasligini tekshiring: Azure Foundry yoki Google Cloud Agent Platform’ning eskiroq modellari.

Shartlar bajarilsa va sozlamalar qidirishni bloklamasa, kerakli MCP serverlarini ulashingiz mumkin. alwaysLoad dan faqat seansning har bir navbatida vositalari kerak bo‘ladigan serverlar uchun foydalaning; qolganlarini qidiruv orqali yuklanadigan qilib qoldiring.

Agar Ailoot orqali AI modellaridan foydalanish kerak bo‘lsa, Ailoot saytiga qarang.