Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Konfiguracija s više poslužitelja

Lekcija 8 od 12 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Više izvora, jedan agent
  2. Sintaksa: ništa novo, samo više unosa
  3. Oznake postaju strukturalne
  4. Kako Grok odabire poslužitelj
  5. Agent za podršku od kraja do kraja
  6. Ključne točke

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 tools za rad s više poslužitelja
  • Svaki poslužitelj mora imati jedinstvenu i opisnu server_label
  • Vrijednosti server_description ključ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_names kako bi smanjio šum