Opis i dopušteni alati
Na ovoj stranici
Dva opcionalna poluga, dva vrlo različita učinka
URL i oznaka dovoljni su za uspostavu veze, ali ne govore Groku kako koristiti poslužitelj. Dva opcionalna parametra popunjavaju tu prazninu i međusobno se nadopunjuju: server_description objašnjava čemu poslužitelj služi, dok allowed_tools—ili allowed_tool_names ovisno o SDK-u—odlučuje što smije dirati. Prvi usmjerava, drugi ograničava.
server_description: daj modelu kontekst
Ovaj parametar pruža Groku opis mogućnosti poslužitelja u prirodnom jeziku. Model ga koristi za donošenje odluka: treba li upitati ovaj poslužitelj, neki drugi ili nijedan?
mcp(
server_url="https://api.example.com/mcp",
server_label="docs",
server_description="Poslužitelj tehničke dokumentacije. Omogućuje pretraživanje članaka, konzultiranje vodiča i dohvaćanje primjera koda za interni API."
)
Bez ovog opisa, Grok ima samo pojedinačne nazive i opise izloženih alata. To funkcionira, ali model rasuđuje bez šire slike: vidi zbirku alata, a ne zna što oni zajedno čine. Dobar opis daje mu tri stvari koje nijedan naziv alata ne može prenijeti: kada je ovaj poslužitelj relevantniji od drugog, koju vrstu zahtjeva treba usmjeriti tamo i—što se često zanemaruje, a često je presudno—što poslužitelj ne radi, čime se izbjegavaju pozivi osuđeni na neuspjeh.
Napiši ovaj opis kao da objašnjavaš uslugu kolegi koji se pridružuje projektu. Budi specifičan: „Baza tehničke dokumentacije proizvoda“ korisna je, dok sama riječ „Dokumentacija“ nije. Imenuj stvarno moguće radnje, poput „omogućuje pretraživanje, čitanje i ažuriranje tiketa“. A ako je opseg ograničen, jasno to i navedi: „samo za čitanje, bez izmjena“ spasit će model od neuspjelog pokušaja.
allowed_tools: suzi opseg
Zadano, spajanje Groka s MCP poslužiteljem ubacuje sve alate koje taj poslužitelj izlaže u kontekst modela, bez iznimke. Na CRM-u to znači da su stvaranje, izmjena i brisanje kontakata dostupni jednako kao i pretraživanje.
mcp(server_url="https://api.example.com/mcp",
server_label="crm")
# Grok vidi SVE alate: create_contact, update_contact,
# delete_contact, search_contacts, export_data, itd.
Parametar allowed_tool_names preokreće ovo ponašanje uspostavom eksplicitne bijele liste. Sve što nije na njoj postaje nevidljivo modelu.
mcp(server_url="https://api.example.com/mcp",
server_label="crm",
allowed_tool_names=["search_contacts", "get_contact_details"])
# Grok vidi samo search_contacts i get_contact_details
Zašto ograničavati, čak i kada sve radi
Prvi razlog je sigurnost, a slijedi princip najmanjih povlastica. Ako tvoja aplikacija treba samo čitati, ne ostavljaj alate za izmjenu ili brisanje u dosegu modela. Uspješna injekcija prompta—zlonamjerna uputa ubačena u dokument koji Grok analizira—ne može pokrenuti delete_contact koji nikada nije bio izložen. Bijela lista pretvara potencijalni incident u nebitan događaj.
# Samo za čitanje za javni chatbot
allowed_tool_names=["search_database", "get_record", "format_data"]
Drugi razlog je performansa. Svaki izloženi alat zauzima prostor u prozoru konteksta jer se tamo moraju uklopiti njegov naziv, opis i shema parametara. MCP poslužitelj koji objavljuje pedeset alata troši znatan volumen prije nego što je korisnik uopće postavio pitanje. Smanjenjem na pet stvarno korisnih alata, oslobađaš taj prostor za ono što je bitno: sam razgovor.
Treći razlog je preciznost. Što je katalog opsežniji, to model više oklijeva između sličnih alata—a dva alata sa sličnim opisima proizvode nestabilne izbore od jednog izvršenja do drugog. Katalog sužen oko tvog slučaja upotrebe čini odabir znatno pouzdanijim.
Neka rade zajedno
Rezultat postaje doista čist kada kombiniraš oba parametra, pod uvjetom da pričaju istu priču.
mcp(
server_url="https://api.example.com/mcp",
server_label="crm",
server_description="CRM samo za čitanje. Pretraživanje i pregled kontakata i tvrtki.",
allowed_tool_names=["search_contacts", "get_contact", "search_companies", "get_company"]
)
Ovdje opis najavljuje pristup samo za čitanje, a bijela lista to tehnički jamči. Čuvaj se suprotne situacije, koja se događa češće nego što misliš: opis naslijeđen iz prethodne verzije koji obećava mogućnosti pisanja, a koje su sada uklonjene s bijele liste. Model će pokušati poziv, neće uspjeti, a ti ćeš gubiti vrijeme loveći grešku koja ne postoji. Uvijek pregledaj ova dva parametra zajedno, nikada odvojeno.
Ključne točke
server_descriptionpomaže Groku da shvati kada koristiti ovaj MCP poslužitelj- Bez
allowed_tools, svi alati poslužitelja ubacuju se u kontekst - Ograničavanje alata jača sigurnost, performanse i preciznost
- Kombiniraj opis i ograničenje za optimalnu kontrolu
- Napiši opis kao objašnjenje mogućnosti poslužitelja u prirodnom jeziku