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

server_url i server_label

Lekcija 4 od 12 Ažurirano 3. studenoga 2026. Programer
Na ovoj stranici
  1. Dva parametra bez kojih ne možeš
  2. server_url: Točna adresa krajnje točke
  3. server_label: Identitet poslužitelja u razgovoru
  4. Minimalna konfiguracija u oba SDK-a
  5. Ključne točke

Ažurirano 3. studenog 2026. na temelju stranice xAI Remote MCP Tools: server_label dodaje prefiks pozivima alata, ali dokumentacija ne navodi točan format prefiksa; notacija label__tool korištena u ovom tečaju konvencija je čitanja – provjeri stvarni format u odgovorima svog API-ja. Izvor: Remote MCP Tools.

Dva parametra bez kojih ne možeš

Svaka veza između Groka i udaljenog MCP poslužitelja oslanja se na dva parametra: server_url i server_label. Oni su neupitni – bez njih API odbija zahtjev prije nego što išta pokuša. Svi ostali parametri na koje ćeš kasnije naići samo doraduju tu osnovu; nikada je ne zamjenjuju.

server_url
Gdje se poslužitelj nalazi
server_label
Kako identificirati poslužitelj

server_url: Točna adresa krajnje točke

Parametar server_url sadrži puni URL MCP poslužitelja na koji se Grok mora spojiti, a taj URL slijedi stroga pravila.

Prvo je HTTPS. URL mora počinjati s https://, a xAI odbija svaku nešifriranu HTTP vezu. Razlog je jednostavan: razmjene između Groka i MCP poslužitelja prenose zahtjeve tvojih korisnika, rezultate alata, a ponekad i sam autentifikacijski token. Dopustiti da to kruži u čistom tekstu bilo bi neobranjivo.

# Ispravno
mcp(server_url="https://mcp.deepwiki.com/mcp")

# API odbija
mcp(server_url="http://mcp.deepwiki.com/mcp")

Drugo pravilo tiče se preciznosti puta. URL mora ukazivati na MCP krajnju točku, a ne na korijen domene. Gotovo svi poslužitelji izlažu svoju krajnju točku na namjenskom putu, a konvencija se razlikuje od slučaja do slučaja. Evo triju valjanih oblika na koje ćeš naići:

https://mcp.deepwiki.com/mcp
https://api.example.com/mcp
https://tools.monentreprise.com/v1/mcp

Treće pravilo proizlazi iz prva dva: localhost i privatne IP adrese su isključeni. Poslužitelj mora biti dostupan iz infrastrukture xAI-ja, na javnoj domeni, s valjanim SSL certifikatom. To tijekom razvoja postavlja konkretno pitanje, jer MCP poslužitelj koji pišeš radi na tvojem računalu. Uobičajeno rješenje je upotreba tunela – primjerice ngrok ili Cloudflare Tunnel – koji tvoju lokalnu instancu izlaže iza javnog HTTPS URL-a za vrijeme testiranja.

server_label: Identitet poslužitelja u razgovoru

server_label kratki je identifikator koji Grok koristi za dodavanje prefiksa pozivima alata s tog poslužitelja. Njegova je uloga dvostruka: učiniti tragove čitljivima i ukloniti svaku dvosmislenost kada koegzistira više poslužitelja.

Dokumentacija xAI-ja navodi da oznaka (label) dodaje prefiks pozivima alata s tog poslužitelja, ali ne specificira točan format prefiksa. U ovom tečaju alat search_docs s poslužitelja deepwiki označavamo kao deepwiki__search_docs, radi čitljivosti: prije izgradnje logike na tome provjeri stvarni format u odgovorima API-ja.

mcp(
    server_url="https://mcp.deepwiki.com/mcp",
    server_label="deepwiki"
)
# Pozivi alata s ovog poslužitelja imat će prefiks "deepwiki"

Tri kriterija vode odabir dobre oznake. Mora biti kratka jer se dodaje imenu svakog poziva, a opširna oznaka nepotrebno napuhuje tvoje zapise. Mora biti opisna kako bi izvor poziva bio čitljiv na prvi pogled bez konzultiranja konfiguracije. Mora biti jedinstvena u tvojoj konfiguraciji, inače nećeš moći razlikovati dva poslužitelja. Primjeri u nastavku zadovoljavaju sva tri zahtjeva:

server_label="deepwiki"     # Dokumentacija GitHuba
server_label="crm"          # Sustav za upravljanje korisnicima
server_label="jira"         # Praćenje tiketa
server_label="search"       # Interni tražilica

Ovo postaje mnogo opipljivije čim spojiš više poslužitelja na istu sesiju. Pretpostavi da tvoja interna dokumentacija i DeepWiki obje izlažu alat pod nazivom search. Bez različitih oznaka, imena alata se sudaraju i Grok nema načina znati koji ciljati. S oznakama, dva alata dobivaju različite prefikse – ovdje zapisane kao deepwiki__search i internal-docs__search – i zabuna nestaje. Na ovu ćeš se točku vratiti u lekciji posvećenoj više poslužitelja.

Minimalna konfiguracija u oba SDK-a

Zajedno, ova dva parametra dovoljna su za rad javnog MCP poslužitelja. S izvornim xAI SDK-om:

from xai_sdk.tools import mcp

tools = [
    mcp(
        server_url="https://mcp.deepwiki.com/mcp",
        server_label="deepwiki"
    )
]

I točan ekvivalent s Responses API-jem u OpenAI formatu:

tools = [{
    "type": "mcp",
    "server_url": "https://mcp.deepwiki.com/mcp",
    "server_label": "deepwiki",
}]

Ključne točke

  • server_url i server_label jedina su dva obavezna parametra
  • URL mora biti HTTPS s valjanim SSL certifikatom, bez localhosta
  • Oznaka dodaje prefiks svim pozivima alata s tog poslužitelja (točan format nije dokumentiran; ovaj tečaj bilježi ga kao label__tool)
  • Odaberi oznake koje su kratke, opisne i jedinstvene po poslužitelju
  • Oznaka je ključna za rad s više poslužitelja kako bi se izbjegli sukobi imena