server_url i server_label
Na ovoj stranici
Ažurirano 3. studenog 2026. na temelju stranice xAI Remote MCP Tools:
server_labeldodaje prefiks pozivima alata, ali dokumentacija ne navodi točan format prefiksa; notacijalabel__toolkoriš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: 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_urliserver_labeljedina 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