Konfiguracija s više poslužitelja
Na ovoj stranici
Više izvora, jedan agent
Remote MCP doseže svoj puni potencijal kada povežeš Grok s više poslužitelja istovremeno. Svaki donosi vlastite alate, a model arbitrirá između njih na temelju dolaznog zahtjeva. To je ono što razlikuje agenta koji može učiniti samo jednu stvar od agenta koji može provesti istragu: provjera statusa usluge, zatim povijesti klijenta, pa članka za rješavanje problema, bez da ti napišeš ijednu liniju koda za orkestraciju.
Sintaksa: ništa novo, samo više unosa
Ne postoji poseban način rada s više poslužitelja koji trebaš aktivirati. Jednostavno dodaš više MCP objekata na popis 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"),
]
Isto načelo vrijedi za Responses API u OpenAI formatu, gdje svaki poslužitelj postaje rječnik na popisu. Ova verzija dodaje opise, koje ćeš vidjeti da više nisu opcionalni čim koristiš više od jednog poslužitelja.
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"
},
]
Oznake postaju strukturalne
server_label, koja je do sada bila pomoć za čitljivost, ovdje postaje ključna. Uzmi vrlo čest scenarij: povežeš svoju internu dokumentaciju i DeepWiki, a oba izlažu alat nazvan search. Bez različitih oznaka, dva alata nose isto ime i Grok nema načina odlučiti. S oznakama, deepwiki__search upituje GitHub dokumentaciju dok internal-docs__search pretražuje tvoju bazu znanja—dva jasno odvojena alata između kojih model bira na temelju opisa i tijeka razgovora.
Dovoljna su tri pravila da nikada ne naiđeš na problem. Svaka oznaka mora biti jedinstvena u konfiguraciji. Mora odražavati izvor podataka, a ne tehničku funkciju, jer podrijetlo razlikuje poslužitelje jedne od drugih, a ne ono što rade. I mora ostati kratka, a da pritom ne postane zamjenjiva. Kontrast u nastavku ilustrira jaz između dva pristupa:
# Dobro: opisne i različite oznake
server_label="deepwiki"
server_label="crm"
server_label="jira"
# Loše: dvosmislene oznake
server_label="server1"
server_label="server2"
server_label="tools"
Oznake u drugom nizu su latentna zamka. Rade dan kada ih napišeš, jer znaš što server1 sadrži. Šest mjeseci kasnije, pri ponovnom čitanju zapisnika o incidentu, nitko više ne zna—a model, sa svoje strane, nikada nije ni znao.
Kako Grok odabire poslužitelj
Suočen s više poslužitelja, model unakrsno referencira četiri izvora informacija kako bi donio odluku. Počinje s korisničkim zahtjevom, odnosno onim što se zapravo traži. Zatim konzultira server_description svakog poslužitelja, koji mu govori čemu svaki od njih općenito služi. Spušta se razinu niže na nazive i opise samih alata, pri čemu svaki alat nosi svoje. I uzima u obzir kontekst razgovora, budući da prethodne poruke utječu na odabir: ako ti je klijent već dao svoj broj računa tri koraka ranije, Grok zna da može pozvati crm__get_customer bez ponovnog pitanja.
Od ova četiri izvora, drugi je onaj nad kojim imaš najviše kontrole, i upravo zato opisi postaju kritični u načinu rada s više poslužitelja. Bez opisa, Grok se oslanja isključivo na nazive alata—search nasuprot drugom search, bez naznake što indeksiraju. Pogreške u odabiru koje iz toga proizlaze utoliko su zbunjujuće jer djeluju nasumično: model bira ispravno pola vremena, pukom srećom.
Agent za podršku od kraja do kraja
Ova konfiguracija objedinjuje sve gore navedeno u potpunom slučaju uporabe.
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"]
),
]
Klijent napiše „moja usluga više ne radi“. Grok prvo provjerava postoji li trenutni incident putem status__get_current_status, konzultira račun klijenta s crm__get_customer kako bi saznao o kojoj se usluzi radi, zatim traži članak za rješavanje problema putem knowledge__search_articles. Ovaj slijed nije napisan nigdje u tvom kodu: proizlazi iz opisa i postavljenog pitanja. Imaj također na umu da svaki poslužitelj ostaje ograničen na svoje operacije čitanja—moć višestrukih poslužitelja nikada ne uklanja potrebu za popisom dopuštenih alata (allowlist).
Ključne točke
- Proslijedi više MCP objekata na popis
toolsza rad s više poslužitelja - Svaki poslužitelj mora imati jedinstvenu i opisnu
server_label - Vrijednosti
server_descriptionključne su za usmjeravanje Groka na pravi poslužitelj - Grok automatski odabire odgovarajući poslužitelj na temelju zahtjeva i konteksta
- Ograniči alate svakog poslužitelja s
allowed_tool_nameskako bi smanjio šum