# Įrankių paieška Claude Code: kaip agentas randa reikiamą MCP įrankį > Kaip veikia įrankių paieška Claude Code: kas iškart įkeliama į kontekstą, kada mechanizmas automatiškai išsijungia ir kaip sukonfigūruoti ENABLE_TOOL_SEARCH ir alwaysLoad. Source: https://ailoot.ai/blog/lt/claude-code-tool-search-mcp-limit/ Canonical: https://ailoot.ai/blog/lt/claude-code-tool-search-mcp-limit/ Language: lt Publisher: Ailoot (https://ailoot.ai/) Translation: guide-055 Revision: sha256-846b1d0439d5556c693a64c830af702bb95d53eb2d2037d0814490276435c7cd Jei prie Claude Code prijungėte kelis MCP serverius, įrankių paieška leidžia įkelti reikiamus įrankius tada, kai jų prireikia, iš anksto neįkeliant visų aprašų. Paleidimo metu agentas gauna atidėto įkėlimo įrankių pavadinimus ir serverių instrukcijas, tada kataloge ieško to, ko jam reikia. Taip jis gali dirbti su dideliu įrankių rinkiniu: Anthropic dokumentacijoje nurodoma, kad pasirinkimo tikslumas mažėja, kai vienu metu įkeliama daugiau nei 30-50 įrankių. Tai bendro pobūdžio rekomendacija, o ne jūsų seanso matavimo rezultatas. Įrankių paieška pagal numatytuosius nustatymus įjungta, kai modelis ją palaiko, tačiau platforma, tarpinis serveris arba nustatymai gali ją išjungti. [Ailoot dokumentacija: API, raktai ir sąranka](https://ailoot.ai/docs/). ## Kas vyksta su kontekstu, kai įrankių paieška nenaudojama Kiekvienas prijungtas MCP serveris įtraukia savo įrankius į sąrašą įrankių, kuriuos agentas gali iškviesti. Kai įrankių paieška nenaudojama, jų aprašai — pavadinimas, aprašymas ir parametrų schema — iš anksto įkeliami į kontekstą. Prasidėjus seansui, serveriai jungiasi fone. Jei prireikia įrankio iš serverio, kuris dar nebaigė prisijungti, Claude Code laukia naudodamas vidinį įrankį `WaitForMcpServers`. Kiekvieno prisijungimo atveju galite atskirai įvertinti, kiek įrankių ir tokenų prideda konkretus serveris. Oficialioje Anthropic dokumentacijoje pateikiami du apytiksliai skaičiai (bendri duomenys, nenurodant matavimo metodo): - 50 įrankių gali užimti 10-20 tūkstančių konteksto tokenų; - tinkamo įrankio pasirinkimo tikslumas mažėja, kai vienu metu įkeliama daugiau nei 30-50 įrankių. ## Kaip pagal nustatymus įvertinti įrankių paiešką Norėdami suprasti, ar įrankių paieška turėtų veikti šiame seanse, patikrinkite šias sąlygas: - kuris modelis atsako — Sonnet/Haiku/Opus 4.5 arba naujesnis: mechanizmas pasiekiamas; senesnis modelis: nepasiekiamas; - ar `ANTHROPIC_BASE_URL` nustatytas į nestandartinį hostą — tokiu atveju mechanizmas pagal numatytuosius nustatymus išjungtas, nebent jis aiškiai įjungiamas per `ENABLE_TOOL_SEARCH`; - koks yra kintamojo `ENABLE_TOOL_SEARCH` reikšmė — `false` visiškai išjungia mechanizmą; `auto`/`auto:N` jį įjungia tik tada, kai aprašų apimtis pasiekia nustatytą ribą; - ar nustatytas `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` — jei organizacija netaiko valdomų nustatymų, šis kintamasis išlaiko įrankių paiešką išjungtą net tada, kai naudotojas nustatė `ENABLE_TOOL_SEARCH`; - ar nustatymuose įrankis `ToolSearch` užblokuotas per `permissions.deny` — toks apribojimas išjungia paiešką; - kuri platforma naudojama — mechanizmas nepasiekiamas Microsoft Foundry dieginiuose Azure aplinkoje, o jo veikimas Google Cloud Agent Platform priklauso nuo Claude Code versijos ir modelio. Ši patikra leidžia įvertinti būseną pagal konfigūraciją, bet ne stebėti ją seanso viduje. Nei MCP skiltyje, nei Agent SDK dokumentacijos įrankių paieškos skiltyje nenurodytas tiesioginis sąsajos indikatorius „įrankių paieška: įjungta / išjungta“. Tai, kad šiuose dviejuose dokumentuose apie tokį indikatorių neužsimenama, neįrodo, jog jo nėra niekur kitur. Kintamąjį galite nustatyti prieš pradėdami seansą, pavyzdžiui, `ENABLE_TOOL_SEARCH=auto:15 claude`. Norėdami užtikrinti, kad konkretaus serverio įrankiai būtų visada įkeliami, naudokite to serverio konfigūracijos lauką `alwaysLoad: true`. Jis pasiekiamas visų tipų serveriams; sąlygos ir apribojimai aprašyti toliau esančiame skyriuje alwaysLoad. ## Kaip veikia įrankių paieška Kai įrankių paieška įjungta, seanso pradžioje į kontekstą įkeliami tik atidėto įkėlimo įrankių pavadinimai ir serverio instrukcijos. Serverio instrukcijose aprašoma, kokioms užduotims jis naudingas. Jei užduočiai reikia galimybės, kurios kontekste dar nėra, agentas pats ieško kataloge tinkamo įrankio. Agent SDK dokumentacijoje paieškos mechanizmas aprašytas išsamiau: pagal numatytuosius nustatymus viena paieška iš katalogo įkelia iki penkių aktualiausių įrankių. Jie lieka pasiekiami tolesniuose seanso etapuose, kol SDK sutraukia pranešimus, kuriuose agentas juos rado. Po sutraukimo anksčiau rasti įrankiai gali būti pašalinti iš konteksto, o kitą kartą, kai jų prireiks, agentas vėl jų ieškos. Katalogas palaiko iki 10 000 įrankių. Pačiame Claude Code MCP dokumentacijoje šie konkretūs skaičiai nepateikiami, tačiau aprašomas tas pats atidėto įkėlimo principas. Agent SDK dokumentacijoje nurodoma, kad kiekviena paieška prideda vieną papildomą užklausos ir atsakymo ciklą. Dokumentacijoje tiksliai nepaaiškinama, ką šis ciklas apima. Claude Code MCP dokumentacijoje taip pat aprašomas klaidų pateikimo skirtumas: kai įrankių paieška nenaudojama, Claude Code nepraneša modeliui apie nesėkmingus prisijungimus prie serverių. Kai paieška įjungta, modelis gauna informaciją apie tai, kuriam serveriui nepavyko prisijungti ir kokia buvo klaida. Claude Code nenustato fiksuotos vieno serverio įrankių skaičiaus ribos. Praktinę ribą sudaro konkretaus seanso konteksto lango biudžetas. Įrankių konfigūravimas yra viena iš AI agento konteksto valdymo užduočių. ## Kada įrankių paieška pagal numatytuosius nustatymus išjungta Mechanizmas pagal numatytuosius nustatymus įjungtas, tačiau jo veikimas priklauso nuo modelio, API hosto ir platformos. **Modelis.** Įrankių paieškai reikia modelio, palaikančio tool_reference blokus: Claude Sonnet 4.5, Claude Haiku 4.5, Claude Opus 4.5 arba naujesnio modelio. Naudojant senesnius modelius, Claude Code iš anksto įkelia įrankių aprašus. **API hostas.** Claude Code išjungia įrankių paiešką, kai kintamasis `ANTHROPIC_BASE_URL` nurodo trečiosios šalies hostą: dauguma tarpinių serverių neperduoda specialiųjų tool_reference blokų. Tai taikoma, kai prie Claude jungiatės per savo šliuzą arba tarpinį serverį, o ne tiesiogiai Anthropic adresu. Išjungimo priežastis yra nestandartinis `ANTHROPIC_BASE_URL`; tai savaime nesusiję su tuo, kaip mokama už prenumeratą. Šį veikimą galite pakeisti aiškiai nustatę `ENABLE_TOOL_SEARCH`. Jei pats tarpinis serveris nepalaiko tool_reference blokų, priverstinai įjungus mechanizmą pateikiama užklausos klaida. Tokiu atveju aprašai nebus įkeliami iš anksto kaip atsarginis variantas. **Diegimo platforma.** Įrankių paieška neveikia Azure aplinkoje talpinamuose Microsoft Foundry dieginiuose: serveris atmeta užklausą, o `ENABLE_TOOL_SEARCH` šio elgesio nepakeičia. Google Cloud Agent Platform platformoje iki Claude Code 2.1.221 versijos mechanizmas buvo išjungtas visuose modeliuose, nebent aiškiai nustatytas `ENABLE_TOOL_SEARCH=true`. Nuo šios versijos jis pagal numatytuosius nustatymus įjungtas Opus/Sonnet/Haiku 4.5 ir naujesniuose modeliuose. Naudojant senesnius modelius šioje platformoje, Claude Code vis tiek iš anksto įkelia visus įrankius, nes serverių infrastruktūra atmeta reikalingą vidinę antraštę. Kintamasis `ENABLE_TOOL_SEARCH` gali turėti penkias reikšmes: - unset — įprastas veikimas, atsižvelgiant į pirmiau išvardytas išimtis; - `true` — mechanizmas įjungiamas jį palaikančiuose modeliuose, išskyrus du atvejus: Azure Foundry ir senesnius Agent Platform modelius; per tarpinį serverį, nepalaikantį tool_reference blokų, siunčiamos užklausos nepavyks; - `auto` — Claude Code iš anksto įkelia įrankius tol, kol bendri jų aprašai užima mažiau nei 10% konteksto lango, o pasiekus šią ribą pereina prie atidėto įkėlimo; - `auto:N` — tas pats principas, tačiau procentinę ribą galima nustatyti rankiniu būdu; - `false` — mechanizmas visiškai išjungiamas, o visi įrankiai įkeliami iš anksto. Taip pat yra kintamasis `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`: jei jis nustatytas, įrankių paieška lieka išjungta, o naudotojo nustatytas `ENABLE_TOOL_SEARCH` to nepakeičia. Išimtis taikoma, kai organizacija išlaiko įrankių paiešką įjungtą per valdomus nustatymus, pasiekiamus nuo Claude Code 2.1.227 versijos. ## Ką daro alwaysLoad ir kaip jis veikia kontekstą bei paleidimą Laukas `alwaysLoad: true` serverio konfigūracijoje pasiekiamas visų tipų serveriams. Jį naudojant visi to serverio įrankiai įkeliami į kontekstą seanso pradžioje, nepaisant `ENABLE_TOOL_SEARCH` reikšmės. Agentui nereikia jų ieškoti prieš naudojant. Išankstinis įrankių įkėlimas turi dvi pasekmes. Kiekvienas iš anksto įkeltas įrankis užima dalį konteksto, kuri kitaip būtų skirta pačiai užduočiai. Be to, seanso paleidimas laukia, kol šis serveris prisijungs, neviršijant įprastos penkių sekundžių skirties. Išimtis taikoma nuotoliniam serveriui, kurio talpykloje yra galiojantis įrašas: jis pateikia įrankius iš talpyklos neprisijungdamas ir nevėlina paleidimo. Aptikimo talpykla pagal numatytuosius nustatymus išjungta, nebent ji jau buvo įjungta paskyroje palaipsniui diegiant šią funkciją. Ją taip pat galite aiškiai įjungti nustatę `MCP_DISCOVERY_CACHE=1`. Greito paleidimo išimtis taikoma, kai talpykla aktyvi ir joje yra galiojantis įrašas. `alwaysLoad` pažymėti įrankiai nuolat užima vietą kontekste, nesvarbu, ar agentui jų būtų prireikę naudojant paiešką. Jei kuriate savo MCP serverį: serverio instrukcijos padeda Claude suprasti, kada ieškoti jo įrankių, panašiai kaip tai daro Skills. Claude Code pagal numatytuosius nustatymus sutrumpina kiekvieno įrankio aprašą ir kiekvieno serverio instrukcijas iki 2048 simbolių, todėl svarbiausią informaciją pateikite pradžioje. Pasirinkimas, kaip plėsti Claude Code, priklauso ne vien nuo prijungtų MCP serverių skaičiaus. Vadovuose [Claude Code: kiek plėtinių vienu metu naudoti](https://ailoot.ai/blog/lt/claude-code-skills-subagents-mcp-plugins/) ir [Ką rinktis Claude Code: Skills, Subagents, MCP ar Plugins](https://ailoot.ai/blog/lt/skills-subagents-mcp-plugins-claude-code/) aptariama, kaip skirtingoms užduotims naudoti Skills, Subagents, MCP ir Plugins. Nuoseklias konkrečių MCP serverių sąrankos instrukcijas rasite vadove [MCP serveriai, skirti Claude Code: paruošti deriniai](https://ailoot.ai/blog/lt/mcp-servers-claude-code/). ## Kas toliau Agent SDK dokumentacijoje nurodoma, kad mažiau nei maždaug 10 įrankių, kurių aprašai lengvai telpa kontekste, rinkinį paprastai greičiau įkelti visą iš karto. Tačiau pagal numatytuosius Claude Code nustatymus, kai kintamasis nenustatytas ir netaikomi pirmiau nurodyti apribojimai, įrankių paieška yra įjungta, o MCP įrankiai įkeliami tik tada, kai jų ieškoma, išskyrus serverius su `alwaysLoad`. Tokiu atveju galite aiškiai nustatyti `ENABLE_TOOL_SEARCH=auto`: aprašai bus įkeliami iš anksto, kol jų bendra apimtis nesieks 10% konteksto lango, o pasiekus šią ribą bus įjungta paieška. Kita galimybė — `ENABLE_TOOL_SEARCH=false`, jei žinote, kad rinkinys nedidės. Tokiu atveju Claude Code nustos pranešti modeliui apie nesėkmingus prisijungimus prie serverių, kaip aprašyta anksčiau. Kitais atvejais, pasikeitus aplinkai, dar kartą patikrinkite veikimo sąlygas: - jei seanse naudojamas senesnis modelis, pereikite prie Sonnet/Haiku/Opus 4.5 arba naujesnio modelio; - jei ryšiui naudojamas nestandartinis `ANTHROPIC_BASE_URL`, aiškiai nustatykite `ENABLE_TOOL_SEARCH=true` tik tada, kai pats tarpinis serveris perduoda tool_reference blokus; - įsitikinkite, kad diegimo platforma nėra viena iš išimčių: Azure Foundry arba senesni Google Cloud Agent Platform modeliai. Jei sąlygos įvykdytos ir nustatymai neblokuoja paieškos, galite prijungti reikiamus MCP serverius. `alwaysLoad` naudokite tik tiems serveriams, kurių įrankių reikia kiekviename seanso etape; kitus palikite įkelti per paiešką.
### Šaltiniai - [MCP Claude Code aplinkoje, skyrius „Scale with MCP tool search“ — oficiali Anthropic dokumentacija](https://code.claude.com/docs/en/mcp.md) - [Įrankių paieška Agent SDK — oficiali Anthropic dokumentacija](https://code.claude.com/docs/en/agent-sdk/tool-search.md)
Jei jums reikia prieigos prie AI modelių per Ailoot, apsilankykite [Ailoot](https://ailoot.ai/). ## Klausimai ir atsakymai ### Kodėl įrankių paieška gali neveikti per tarpinį serverį, nors įjungta? Trečiosios šalies API serveris turi palaikyti tool_reference blokus. Priverstinis ENABLE_TOOL_SEARCH įjungimas nesukuria šio palaikymo; nesuderinamas tarpinis serveris gali atmesti užklausą, užuot grįžęs prie visų įrankių įkėlimo. ### Kada MCP serveriui nustatyti alwaysLoad? Naudokite, kai serverio įrankių reikia kiekviename ėjime. Tada visi jo įrankių aprašai užima pradinį kontekstą, o paleidimas gali laukti ryšio, jei nėra galiojančio aptikimo talpyklos įrašo. ## Ailoot · Įmonė ir jos projektų portfelis Ailoot remiasi sukaupta veiklos patirtimi, plačia klientų baze, stabiliomis paslaugomis ir nuolatine KPI kontrole. Įmonė ir jos projektų portfelis: milijonai klientų; mėnesio pardavimai siekia milijardus. Ailoot šią veiklos patirtį pritaiko teikdama API prieigą prie DI funkcijų klientų produktuose, agentuose, programose ir automatizavimo sprendimuose.