Popis a povolené nástroje
Na této stránce
Dva volitelné páky, dva velmi odlišné efekty
URL adresa a štítek stačí k navázání spojení, ale Grokovi neříkají, jak server používat. Tuto mezeru vyplňují dva volitelné parametry, které se vzájemně doplňují: server_description vysvětluje, k čemu server slouží, zatímco allowed_tools – nebo allowed_tool_names v závislosti na SDK – rozhoduje, čeho se smí dotknout. První parametr směruje, druhý omezuje.
server_description: poskytni modelu kontext
Tento parametr poskytuje Grokovi popis schopností serveru v přirozeném jazyce. Model jej využívá k rozhodování: má dotazovat tento server, jiný, nebo žádný?
mcp(
server_url="https://api.example.com/mcp",
server_label="docs",
server_description="Server technické dokumentace. Umožňuje vyhledávat články, konzultovat příručky a získávat ukázky kódu pro interní API."
)
Bez tohoto popisu má Grok k dispozici pouze jednotlivé názvy a popisy exponovaných nástrojů. Funguje to, ale model uvažuje bez širšího obrazu: vidí sbírku nástrojů, ale neví, co společně tvoří. Dobrý popis mu dává tři věci, které žádný název nástroje nedokáže sdělit: kdy je tento server relevantní spíše než jiný, jaký typ požadavků na něj směrovat a – což se často přehlíží, ale je rozhodující – co server nedělá, čímž se předejde voláním odsouzeným k neúspěchu.
Piš tento popis tak, jako bys službu vysvětloval kolegovi, který nastupuje do projektu. Buď konkrétní: „Databáze technické dokumentace produktu“ je užitečné, zatímco pouhé „Dokumentace“ nestačí. Pojmenuj skutečně možné akce, například „umožňuje vyhledávat, číst a aktualizovat ticketty“. A pokud je rozsah omezený, jasně to uveď: „pouze přístup pro čtení, žádné úpravy“ ušetří modelu neúspěšný pokus.
allowed_tools: zúžení rozsahu
Ve výchozím nastavení připojení Groka k serveru MCP vloží do kontextu modelu všechny nástroje, které tento server exponuje, bez výjimky. U CRM to znamená, že vytváření, úprava i mazání kontaktů jsou přístupné stejně jako vyhledávání.
mcp(server_url="https://api.example.com/mcp",
server_label="crm")
# Grok vidí VŠECHNY nástroje: create_contact, update_contact,
# delete_contact, search_contacts, export_data atd.
Parametr allowed_tool_names toto chování obrací vytvořením explicitního seznamu povolených položek (whitelist). Vše, co na něm není, se pro model stane neviditelným.
mcp(server_url="https://api.example.com/mcp",
server_label="crm",
allowed_tool_names=["search_contacts", "get_contact_details"])
# Grok vidí pouze search_contacts a get_contact_details
Proč omezovat, i když vše funguje
Prvním důvodem je bezpečnost, která vychází z principu nejmenších oprávnění. Pokud tvoje aplikace potřebuje pouze číst, nenechávej model dosáhnout na nástroje pro úpravy nebo mazání. Úspěšná injekce promptu – škodlivý pokyn vložený do dokumentu, který Grok analyzuje – nemůže spustit delete_contact, který nebyl nikdy exponován. Whitelist změní potenciální incident na neudálost.
# Pouze pro čtení pro veřejného chatbota
allowed_tool_names=["search_database", "get_record", "format_data"]
Druhým důvodem je výkon. Každý exponovaný nástroj zabírá místo v kontextovém okně, protože se tam musí vejít jeho název, popis a schéma parametrů. Server MCP publikující padesát nástrojů spotřebuje značný objem ještě předtím, než uživatel položí svou otázku. Snížením počtu na pět skutečně užitečných nástrojů získáš toto místo zpět pro to podstatné: pro samotnou konverzaci.
Třetím důvodem je přesnost. Čím rozsáhlejší je katalog, tím více model váhá mezi podobnými nástroji – a dva nástroje s podobnými popisy vedou k nestabilním volbám od jednoho spuštění k druhému. Katalog utažený kolem tvého případu použití činí výběr výrazně spolehlivějším.
Nech oba parametry pracovat společně
Výsledek je skutečně čistý, když zkombinuješ oba parametry za předpokladu, že vyprávějí stejný příběh.
mcp(
server_url="https://api.example.com/mcp",
server_label="crm",
server_description="CRM pouze pro čtení. Vyhledávání a zobrazení kontaktů a firem.",
allowed_tool_names=["search_contacts", "get_contact", "search_companies", "get_company"]
)
Zde popis oznamuje přístup pouze pro čtení a whitelist to technicky garantuje. Dej si pozor na opačnou situaci, která se stává častěji, než si myslíš: popis zděděný z předchozí verze, který slibuje možnosti zápisu, jež byly nyní z whitelistu odstraněny. Model se pokusí volání provést, selže a ty strávíš čas hledáním chyby, která neexistuje. Vždy kontroluj tyto dva parametry společně, nikdy ne odděleně.
Klíčové poznatky
server_descriptionpomáhá Grokovi pochopit, kdy tento server MCP použít- Bez
allowed_toolsjsou všechny nástroje serveru vloženy do kontextu - Omezení nástrojů posiluje bezpečnost, výkon i přesnost
- Zkombinuj popis a omezení pro optimální kontrolu
- Piš popis jako vysvětlení schopností serveru v přirozeném jazyce