Beskrivning och tillåtna verktyg
På denna sida
Två valfria reglage, två helt olika effekter
URL:en och etiketten räcker för att upprätta anslutningen, men de berättar inte för Grok hur servern ska användas. Två valfria parametrar fyller detta gap och kompletterar varandra: server_description förklarar vad servern är till för, medan allowed_tools – eller allowed_tool_names beroende på SDK – avgör vad den får röra vid. Den första guidar, den andra begränsar.
server_description: ge modellen kontext
Denna parameter ger Grok en beskrivning i naturligt språk av serverns kapacitet. Modellen använder den för att avgöra: ska den fråga denna server, en annan, eller ingen alls?
mcp(
server_url="https://api.example.com/mcp",
server_label="docs",
server_description="Teknisk dokumentationsserver. Låter dig söka efter artiklar, läsa guider och få kodexempel för det interna API:t."
)
Utan denna beskrivning har Grok bara tillgång till de enskilda namnen och beskrivningarna av de exponerade verktygen. Det fungerar, men modellen resonerar utan helhetsbild: den ser en samling verktyg utan att veta vad de bildar tillsammans. En bra beskrivning ger den tre saker som inget verktygsnamn kan förmedla: när denna server är relevant snarare än en annan, vilken typ av förfrågningar som ska dirigeras dit, och – ofta förbisett men ofta avgörande – vad servern inte gör, vilket undviker anrop som är dömda att misslyckas.
Skriv denna beskrivning som om du förklarade tjänsten för en kollega som precis har börjat på projektet. Var specifik: “Produktens tekniska dokumentationsdatabas” är användbart där “Dokumentation” inte är det. Nämn de åtgärder som faktiskt är möjliga, som “låter dig söka, läsa och uppdatera ärenden”. Och om omfattningen är begränsad, ange det tydligt: “läsbehörighet, inga ändringar” sparar modellen från ett misslyckat försök.
allowed_tools: begränsa omfattningen
Som standard injicerar anslutningen av Grok till en MCP-server alla verktyg som servern exponerar i modellens kontext, utan undantag. På ett CRM-system innebär detta att skapa, ändra och radera kontakter är lika tillgängligt som att söka.
mcp(server_url="https://api.example.com/mcp",
server_label="crm")
# Grok ser ALLA verktyg: create_contact, update_contact,
# delete_contact, search_contacts, export_data, etc.
Parametern allowed_tool_names vänder på detta beteende genom att upprätta en explicit vitlista. Allt som inte finns på den blir osynligt för modellen.
mcp(server_url="https://api.example.com/mcp",
server_label="crm",
allowed_tool_names=["search_contacts", "get_contact_details"])
# Grok ser endast search_contacts och get_contact_details
Varför begränsa, även när allt fungerar
Den första anledningen är säkerhet, och den följer principen om minsta privilegium. Om din applikation bara behöver läsa, lämna inte verktyg för ändring eller radering inom modellens räckhåll. En lyckad prompt-injection – en skadlig instruktion smugen in i ett dokument som Grok analyserar – kan inte utlösa ett delete_contact som aldrig exponerades. Vitlistan gör en potentiell incident till en icke-händelse.
# Endast läsbehörighet för en offentlig chattbot
allowed_tool_names=["search_database", "get_record", "format_data"]
Den andra anledningen är prestanda. Varje exponerat verktyg tar upp plats i kontextfönstret, eftersom dess namn, beskrivning och parameterschema måste få plats där. En MCP-server som publicerar femtio verktyg konsumerar en betydande volym innan användaren ens har ställt sin fråga. Genom att reducera ner till fem verkligt användbara verktyg återvinner du det utrymmet för det som betyder något: själva konversationen.
Den tredje anledningen är precision. Ju mer omfattande katalogen är, desto mer tvekar modellen mellan liknande verktyg – och två verktyg med liknande beskrivningar ger instabila val från en körning till nästa. En katalog som är stram runt ditt användningsfall gör urvalet betydligt mer tillförlitligt.
Få de två att samverka
Resultatet blir verkligen rent när du kombinerar båda parametrarna, förutsatt att de berättar samma historia.
mcp(
server_url="https://api.example.com/mcp",
server_label="crm",
server_description="Skrivskyddat CRM. Sök och visa kontakter och företag.",
allowed_tool_names=["search_contacts", "get_contact", "search_companies", "get_company"]
)
Här meddelar beskrivningen läsbehörighet och vitlistan garanterar det tekniskt. Akta dig för motsatsen, vilket händer oftare än du tror: en beskrivning ärvd från en tidigare version som lovar skrivmöjligheter som nu tagits bort från vitlistan. Modellen kommer att försöka göra anropet, misslyckas, och du kommer att spendera tid på att jaga en bugg som inte finns. Granska alltid dessa två parametrar tillsammans, aldrig separat.
Viktiga punkter
server_descriptionhjälper Grok att förstå när denna MCP-server ska användas- Utan
allowed_toolsinjiceras alla serverns verktyg i kontexten - Att begränsa verktyg stärker säkerhet, prestanda och precision
- Kombinera beskrivning och begränsning för optimal kontroll
- Skriv beskrivningen som en förklaring i naturligt språk av serverns kapacitet