Popis a povolené nástroje
Na tejto strane
Dva voliteľné páky, dva úplne odlišné efekty
URL adresa a štítok stačia na nadviazanie spojenia, no nehovoria modelu Grok, ako má server používať. Túto medzeru vypĺňajú dva voliteľné parametre, ktoré sa navzájom dopĺňajú: server_description vysvetľuje, na čo server slúži, zatiaľ čo allowed_tools – alebo allowed_tool_names v závislosti od SDK – rozhoduje, čoho sa server môže dotknúť. Prvý usmerňuje, druhý obmedzuje.
server_description: poskytni modelu kontext
Tento parameter poskytuje modelu Grok popis schopností servera v prirodzenom jazyku. Model ho využíva pri rozhodovaní: má sa obrátiť na tento server, na iný, alebo žiaden?
mcp(
server_url="https://api.example.com/mcp",
server_label="docs",
server_description="Server technickej dokumentácie. Umožňuje vyhľadávať články, konzultovať príručky a získavať príklady kódu pre interné API."
)
Bez tohto popisu má Grok k dispozícii len jednotlivé názvy a popisy exponovaných nástrojov. Funguje to, ale model uvažuje bez celkového obrazu: vidí zbierku nástrojov, no nevie, čo spoločne predstavujú. Dobrý popis mu dáva tri veci, ktoré žiadny názov nástroja nedokáže vyjadriť: kedy je tento server relevantnejší než iný, aký typ požiadaviek má smerovať práve sem a – čo sa často prehliada, no je rozhodujúce – čo server nerobí, čím sa predíde volaniam odsúdeným na zlyhanie.
Tento popis píš tak, akoby si službu vysvetľoval kolegovi, ktorý práve nastupuje do projektu. Buď konkrétny: „Databáza technickej dokumentácie produktu“ je užitočné, zatiaľ čo samotné „Dokumentácia“ nie. Pomenuj skutočne možné akcie, napríklad „umožňuje vyhľadávať, čítať a aktualizovať tikety“. Ak je rozsah obmedzený, jasne to uveď: „prístup len na čítanie, bez úprav“ ušetrí modelu neúspešný pokus.
allowed_tools: zúženie rozsahu
Predvolene pripojenie modelu Grok k serveru MCP vloží do kontextu modelu všetky nástroje, ktoré tento server exponuje, bez výnimky. V prípade CRM to znamená, že vytváranie, úprava aj mazanie kontaktov sú prístupné rovnako ako vyhľadávanie.
mcp(server_url="https://api.example.com/mcp",
server_label="crm")
# Grok vidí VŠETKY nástroje: create_contact, update_contact,
# delete_contact, search_contacts, export_data atď.
Parameter allowed_tool_names toto správanie obracia tým, že stanovuje explicitný zoznam povolených položiek (whitelist). Všetko, čo na ňom nie je, sa pre model stane neviditeľným.
mcp(server_url="https://api.example.com/mcp",
server_label="crm",
allowed_tool_names=["search_contacts", "get_contact_details"])
# Grok vidí iba search_contacts a get_contact_details
Prečo obmedzovať, aj keď všetko funguje
Prvým dôvodom je bezpečnosť a riadi sa princípom najmenších privilégií. Ak tvoja aplikácia potrebuje iba čítať, nenechávaj modelu k dispozícii nástroje na úpravy alebo mazanie. Úspešná injekcia promptu – škodlivý pokyn prepašovaný do dokumentu, ktorý Grok analyzuje – nemôže spustiť delete_contact, ktorý nikdy nebol exponovaný. Whitelist zmení potenciálny incident na neudalosť.
# Iba na čítanie pre verejného chatbota
allowed_tool_names=["search_database", "get_record", "format_data"]
Druhým dôvodom je výkon. Každý exponovaný nástroj zaberá miesto v kontextovom okne, keďže sa tam musí zmestiť jeho názov, popis a schéma parametrov. Server MCP publikujúci päťdesiat nástrojov spotrebuje značný objem ešte predtým, než používateľ položí svoju otázku. Znížením počtu na päť skutočne užitočných nástrojov získate toto miesto späť pre to podstatné: pre samotnú konverzáciu.
Tretím dôvodom je presnosť. Čím rozsiahlejší je katalóg, tým viac model váha medzi podobnými nástrojmi – a dva nástroje s podobnými popismi vedú k nestabilným voľbám od jedného spustenia k druhému. Katalóg prispôsobený vášmu použitiu robí výber výrazne spoľahlivejším.
Ako dosiahnuť súčinnosť oboch parametrov
Výsledok je skutočne čistý vtedy, keď oba parametre skombinujete za predpokladu, že rozprávajú ten istý príbeh.
mcp(
server_url="https://api.example.com/mcp",
server_label="crm",
server_description="CRM iba na čítanie. Vyhľadávanie a zobrazovanie kontaktov a spoločností.",
allowed_tool_names=["search_contacts", "get_contact", "search_companies", "get_company"]
)
Tu popis oznamuje prístup len na čítanie a whitelist to technicky garantuje. Stráž sa opačnej situácie, ktorá sa stáva častejšie, než si myslíš: popis zdedený z predchádzajúcej verzie, ktorý sľubuje možnosti zápisu, tie však boli z whitelistu odstránené. Model sa pokúsi o volanie, zlyhá a ty strácaš čas hľadaním chyby, ktorá neexistuje. Tieto dva parametre vždy kontroluj spoločne, nikdy nie oddelene.
Kľúčové poznatky
server_descriptionpomáha modelu Grok pochopiť, kedy má tento server MCP použiť- Bez
allowed_toolssa všetky nástroje servera vložia do kontextu - Obmedzenie nástrojov posilňuje bezpečnosť, výkon aj presnosť
- Kombinuj popis a obmedzenie pre optimálnu kontrolu
- Popis píš ako vysvetlenie schopností servera v prirodzenom jazyku