Описание и разрешени инструменти
На тази страница
Два незадължителни лоста, два много различни ефекта
URL адресът и етикетът са достатъчни, за да установите връзката, но те не казват на Grok как да използва сървъра. Два незадължителни параметъра запълват тази празнота и се допълват взаимно: server_description обяснява за какво служи сървърът, докато allowed_tools – или allowed_tool_names в зависимост от SDK – решава до какво му е позволено да се докосва. Първият насочва, вторият ограничава.
server_description: предоставете контекст на модела
Този параметър предоставя на Grok описание на естествен език за възможностите на сървъра. Моделът го използва, за да прецени: дали да заявки този сървър, друг или изобщо никой?
mcp(
server_url="https://api.example.com/mcp",
server_label="docs",
server_description="Technical documentation server. Lets you search articles, consult guides, and get code examples for the internal API."
)
Без това описание Grok разполага само с индивидуалните имена и описания на изложените инструменти. Работи, но моделът разсъждава без цялостна картина: вижда колекция от инструменти, без да знае какво формират те колективно. Едно добро описание му дава три неща, които никое име на инструмент не може да предаде: кога този сървър е уместен, а не друг; какъв тип заявки да се насочват натам; и – често пренебрегвано, но често решаващо – какво сървърът не прави, което избягва обречени на провал повиквания.
Напишете това описание така, сякаш обяснявате услугата на колега, който се присъединява към проекта. Бъдете конкретни: „База данни с техническа документация за продукта“ е полезно, докато просто „Документация“ не е. Посочете действително възможните действия, като „позволява търсене, четене и актуализиране на тикети“. И ако обхватът е ограничен, го заявете ясно: „достъп само за четене, без модификации“ ще спести на модела опит, обречен на неуспех.
allowed_tools: стеснете обхвата
По подразбиране свързването на Grok към MCP сървър инжектира всички инструменти, които този сървър излага, в контекста на модела, без изключение. При CRM това означава, че създаването, модифицирането и изтриването на контакти са достъпни точно както търсенето.
mcp(server_url="https://api.example.com/mcp",
server_label="crm")
# Grok вижда ВСИЧКИ инструменти: create_contact, update_contact,
# delete_contact, search_contacts, export_data и т.н.
Параметърът allowed_tool_names обръща това поведение, като установява изричен бял списък. Всичко, което не е в него, става невидимо за модела.
mcp(server_url="https://api.example.com/mcp",
server_label="crm",
allowed_tool_names=["search_contacts", "get_contact_details"])
# Grok вижда само search_contacts и get_contact_details
Защо да ограничавате, дори когато всичко работи
Първата причина е сигурността и тя следва принципа на най-малките привилегии. Ако вашето приложение има нужда само от четене, не оставяйте инструменти за модифициране или изтриване в обсега на модела. Успешна инжекция на подкана – злонамерена инструкция, промъкната в документ, анализиран от Grok – не може да задейства delete_contact, който никога не е бил изложен. Белият списък превръща потенциален инцидент в несъбитие.
# Само за четене за публичен чатбот
allowed_tool_names=["search_database", "get_record", "format_data"]
Втората причина е производителността. Всеки изложен инструмент заема място в прозореца на контекста, тъй като неговото име, описание и схема на параметрите трябва да се побират там. MCP сървър, публикуващ петдесет инструмента, консумира значителен обем, преди потребителят дори да е задал въпроса си. Като намалите броя до пет наистина полезни инструмента, си връщате това пространство за онова, което има значение: самия разговор.
Третата причина е прецизността. Колкото по-обширен е каталогът, толкова повече моделът се колебае между сходни инструменти – а два инструмента с подобни описания водят до нестабилни избори от едно изпълнение до друго. Каталог, стегнат около вашия случай на употреба, прави селекцията значително по-надеждна.
накарайте двете да работят заедно
Резултатът става наистина чист, когато комбинирате двата параметъра, при условие че разказват една и съща история.
mcp(
server_url="https://api.example.com/mcp",
server_label="crm",
server_description="Read-only CRM. Search and view contacts and companies.",
allowed_tool_names=["search_contacts", "get_contact", "search_companies", "get_company"]
)
Тук описанието обявява достъп само за четене, а белият списък го гарантира технически. Пазете се от обратната ситуация, която се случва по-често, отколкото си мислите: описание, наследено от предишна версия, което обещава възможности за запис, вече премахнати от белия списък. Моделът ще се опита да направи повикването, ще се провали и вие ще загубите време в търсене на бъг, който не съществува. Винаги преглеждайте тези два параметъра заедно, никога поотделно.
Ключови изводи
server_descriptionпомага на Grok да разбере кога да използва този MCP сървър- Без
allowed_tools, всички инструменти на сървъра се инжектират в контекста - Ограничаването на инструментите засилва сигурността, производителността и прецизността
- Комбинирайте описанието и ограничението за оптимален контрол
- Напишете описанието като обяснение на естествен език за възможностите на сървъра