Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Konfiguracija z več strežniki

Lekcija 8 od 12 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Več virov, en sam agent
  2. Sintaksa: nič novega, le več vnosov
  3. Oznake postanejo strukturne
  4. Kako Grok izbere strežnik
  5. Agent za podporo od začetka do konca
  6. Ključne ugotovitve

Več virov, en sam agent

Remote MCP doseže svoj polni potencial, ko povežeš Grok z več strežniki hkrati. Vsak prinese svoja orodja, model pa med njimi arbitrira glede na prihajajoče zahteve. To je tisto, kar loči agenta, ki zmore le eno stvar, od agenta, ki lahko vodi preiskavo: preveri stanje storitve, nato zgodovino stranke, nato članek za odpravljanje težav, ne da bi ti napisal vrstico kode za orkestracijo.

Sintaksa: nič novega, le več vnosov

Ni posebnega načina za več strežnikov, ki bi ga bilo treba vklopiti. Preprosto dodaš več objektov MCP v seznam 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"),
]

Enako načelo velja za API Responses v formatu OpenAI, kjer vsak strežnik postane slovar v seznamu. Ta različica dodaja opise, za katere boš videl, da niso več izbirni, takoj ko uporabiš več kot en strežnik.

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 postanejo strukturne

server_label, ki je bila doslej le pripomoček za berljivost, tu postane bistvena. Vzemi zelo pogost scenarij: povežeš svojo interno dokumentacijo in DeepWiki, oba pa izpostavita orodje z imenom search. Brez različnih oznak dve orodji nosita isto ime in Grok nima načina, da bi se odločil. Z oznakami deepwiki__search poizveduje po dokumentaciji GitHub, medtem ko internal-docs__search išče po tvoji zbirki znanja – dve jasno ločeni orodji, med katerima model izbira na podlagi opisov in poteka pogovora.

Zadostujejo tri pravila, da se nikoli ne srečaš s težavo. Vsaka oznaka mora biti v konfiguraciji edinstvena. Odražati mora vir podatkov in ne tehnične funkcije, saj izvorišče ločuje strežnike med seboj, ne pa to, kaj počnejo. In mora ostati kratka, ne da bi postala zamenljiva. Spodnji kontrast ponazarja razliko med obema pristopoma:

# Dobro: opisne in različne oznake
server_label="deepwiki"
server_label="crm"
server_label="jira"

# Slabo: dvoumne oznake
server_label="server1"
server_label="server2"
server_label="tools"

Oznake v drugem nizu so latentna past. Delujejo dan, ko jih napišeš, ker veš, kaj vsebuje server1. Šest mesecev kasneje, ko ponovno bereš dnevnik incidentov, nihče več ne ve – model pa tega nikoli ni vedel.

Kako Grok izbere strežnik

Soočen z več strežniki, model navzkrižno preveri štiri vire informacij, da se odloči. Začne z uporabniško zahtevo, torej s tem, kar je dejansko zahtevano. Nato se posvetuje s server_description vsakega strežnika, ki mu pove, čemu vsak služi na splošno. Spusti se raven nižje k imenom in opisom samih orodij, saj vsako orodje nosi svoje. In upošteva kontekst pogovora, saj prejšnja sporočila vplivajo na izbiro: če ti je stranka tri korake prej že podala svojo številko računa, Grok ve, da lahko pokliče crm__get_customer, ne da bi znova spraševal.

Od teh štirih virov imaš nad drugim največ nadzora in prav zato opisi v načinu z več strežniki postanejo ključni. Brez opisov se Grok zanaša le na imena orodij – search nasproti drugemu search, brez indicija, kaj indeksirata. Napake pri izbiri, ki iz tega izhajajo, so toliko bolj zmedene, ker se zdijo naključne: model se polovico časa odloči pravilno, po sreči.

Agent za podporo od začetka do konca

Ta konfiguracija združuje vse zgoraj navedeno v popolnem primeru 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"]
    ),
]

Stranka napiše „moja storitev ne deluje več”. Grok najprej preveri, ali obstaja trenutni incident prek status__get_current_status, se posvetuje s strankinim računom prek crm__get_customer, da izve, za katero storitev gre, nato pa poišče članek za odpravljanje težav prek knowledge__search_articles. To zaporedje ni zapisano nikjer v tvoji kodi: izhaja iz opisov in zastavljenega vprašanja. Upoštevaj tudi, da je vsak strežnik omejen na svoje operacije branja – moč več strežnikov nikoli ne odpravi potrebe po seznamu dovoljenih orodij (allowlist).

Ključne ugotovitve

  • Za več strežnikov podaj več objektov MCP v seznamu tools
  • Vsak strežnik mora imeti edinstveno in opisno server_label
  • Vrednosti server_description so bistvene za usmerjanje Groka k pravemu strežniku
  • Grok samodejno izbere ustrezen strežnik na podlagi zahteve in konteksta
  • Omeji orodja vsakega strežnika z allowed_tool_names, da zmanjšaš šum