Konfigurace více serverů
Na této stránce
Více zdrojů, jediný agent
Remote MCP dosahuje svého plného potenciálu, když připojíte Grok k více serverům najednou. Každý z nich přináší vlastní nástroje a model mezi nimi arbitruje na základě příchozího požadavku. To je přesně to, co odlišuje agenta schopného只做 jedné věci od agenta, který dokáže vést vyšetřování: zkontroluje stav služby, poté historii zákazníka a následně článek pro řešení problémů, aniž byste museli napsat jediný řádek orchestračného kódu.
Syntaxe: nic nového, jen více položek
Neexistuje žádný speciální režim pro více serverů, který byste museli aktivovat. Jednoduše přidáte více objektů MCP do seznamu tools.
from xai_sdk.tools import mcp
tools = [
mcp(server_url="https://mcp.deepwiki.com/mcp", server_label="deepwiki"),
mcp(server_url="https://your-custom-tools.com/mcp", server_label="custom"),
mcp(server_url="https://api.example.com/tools", server_label="api-tools"),
]
Stejný princip platí pro Responses API ve formátu OpenAI, kde se každý server stane slovníkem v seznamu. Tato verze přidává popisy, které uvidíte, že již nejsou volitelné, jakmile použijete více než jeden server.
tools = [
{
"type": "mcp",
"server_url": "https://mcp.deepwiki.com/mcp",
"server_label": "deepwiki",
"server_description": "Documentation for GitHub open-source projects"
},
{
"type": "mcp",
"server_url": "https://your-custom-tools.com/mcp",
"server_label": "custom",
"server_description": "Internal company tools"
},
{
"type": "mcp",
"server_url": "https://api.example.com/tools",
"server_label": "api-tools",
"server_description": "Data and analytics API"
},
]
Popisky se stávají strukturálními
server_label, který byl doposud pouze pomůckou pro čitelnost, se zde stává nezbytným. Vezměme si velmi častý scénář: připojíte svou interní dokumentaci a DeepWiki a oba exposingují nástroj s názvem search. Bez odlišných popisků by dva nástroje nesly stejné jméno a Grok by neměl způsob, jak se rozhodnout. Díky popiskům deepwiki__search dotazuje dokumentaci GitHubu, zatímco internal-docs__search prohledává vaši znalostní bázi – dva jasně oddělené nástroje, mezi nimiž model vybírá na základě popisů a průběhu konverzace.
K tomu, abyste se nikdy nedostali do problémů, stačí dodržovat tři pravidla. Každý popisek musí být v konfiguraci jedinečný. Musí odrážet zdroj dat spíše než technickou funkci, protože právě původ odlišuje servery od sebe, nikoliv to, co dělají. A musí zůstat stručný, aniž by se stal zaměnitelným. Následující kontrast ilustruje rozdíl mezi oběma přístupy:
# Dobře: popisné a odlišné popisky
server_label="deepwiki"
server_label="crm"
server_label="jira"
# Špatně: nejednoznačné popisky
server_label="server1"
server_label="server2"
server_label="tools"
Popisky ve druhé sérii jsou latentní pastí. Fungují v den, kdy je napíšete, protože víte, co server1 obsahuje. O šest měsíců později, při pročítání záznamu o incidentu, už to nikdo neví – a model to ostatně nikdy nevěděl.
Jak Grok vybírá server
Při confronted s více servery model zkříží čtyři zdroje informací, aby se rozhodl. Začne uživatelským požadavkem, tedy tím, co je skutečně žádáno. Následně konzultuje server_description každého serveru, který mu říká, k čemu každý z nich obecně slouží. Jde o úroveň níže k názvům a popisům samotných nástrojů, přičemž každý nástroj nese své vlastní. A bere v úvahu kontext konverzace, protože předchozí zprávy ovlivňují výběr: pokud vám klient již před třemi kroky sdělil své číslo účtu, Grok ví, že může zavolat crm__get_customer, aniž by se znovu ptal.
Z těchto čtyř zdrojů máte nad druhým největší kontrolu, a právě proto se popisy stávají v režimu více serverů kritickými. Bez popisů se Grok spoléhá pouze na názvy nástrojů – search proti dalšímu search, bez jakékoli indikace toho, co indexují. Chyby ve výběru, které z toho vyplývají, jsou tím matoucí, že působí náhodně: model vybírá správně jen polovinu času, čistě díky štěstí.
Kompletní agent pro podporu
Tato konfigurace spojuje vše výše uvedené do úplného případu použití.
tools = [
mcp(
server_url="https://kb.monentreprise.com/mcp",
server_label="knowledge",
server_description="Product knowledge base. Help articles, FAQ, troubleshooting guides.",
allowed_tool_names=["search_articles", "get_article"]
),
mcp(
server_url="https://crm.monentreprise.com/mcp",
server_label="crm",
server_description="CRM. Customer history, previous tickets, account information.",
authorization=f"Bearer {os.getenv('CRM_TOKEN')}",
allowed_tool_names=["get_customer", "search_tickets", "get_ticket"]
),
mcp(
server_url="https://status.monentreprise.com/mcp",
server_label="status",
server_description="Service status. Ongoing incidents, scheduled maintenance.",
allowed_tool_names=["get_current_status", "list_incidents"]
),
]
Zákazník napíše „moje služba již nefunguje“. Grok nejprve zkontroluje, zda probíhá nějaký incident, prostřednictvím status__get_current_status, konzultuje účet zákazníka pomocí crm__get_customer, aby zjistil, o jakou službu jde, a následně vyhledá článek pro řešení problémů přes knowledge__search_articles. Tato sekvence není nikde zapsána ve vašem kódu: vyplývá z popisů a položené otázky. Všimněte si také, že každý server zůstává omezen na své operace čtení – síla více serverů nikdy neodstraňuje potřebu allowlistu.
Klíčové poznatky
- Pro více serverů předejte více objektů MCP v seznamu
tools - Každý server musí mít jedinečný a popisný
server_label - Hodnoty
server_descriptionjsou nezbytné pro nasměrování Groku na správný server - Grok automaticky vybírá vhodný server na základě požadavku a kontextu
- Omezte nástroje každého serveru pomocí
allowed_tool_names, abyste minimalizovali šum