server_url a server_label
Na tejto strane
Aktualizované 3. novembra 2026 na základe stránky Remote MCP Tools od xAI:
server_labelpridáva prefix k volaniam nástrojov, ale dokumentácia nešpecifikuje presný formát tohto prefixu; notácialabel__toolpoužitá v tomto kurze je konvenciou pre čitateľnosť – over si skutočný formát v odpovediach svojho API. Zdroj: Remote MCP Tools.
Dva parametre, bez ktorých sa nezaobídeš
Každé pripojenie medzi Grokom a vzdialeným serverom MCP závisí od dvoch parametrov: server_url a server_label. Sú nepostrádateľné – bez nich API odmietne požiadavku ešte predtým, než sa pokúsi o čokoľvek. Všetky ostatné parametre, s ktorými sa stretneš neskôr, túto základňu len spresňujú; nikdy ju nenahrádzajú.
server_url: Presná adresa koncového bodu
Parameter server_url obsahuje úplnú URL adresu servera MCP, ku ktorému sa musí Grok pripojiť, a táto URL sa riadi prísnymi pravidlami.
Prvým je HTTPS. URL musí začínať reťazcom https:// a xAI odmietne akékoľvek nešifrované HTTP pripojenie. Dôvod je jednoduchý: výmena medzi Grokom a serverom MCP prenáša požiadavky tvojich používateľov, výsledky nástrojov a niekedy aj samotný autentifikačný token. Nechať tieto dáta cirkulovať v plain texte by bolo neobhájiteľné.
# Správne
mcp(server_url="https://mcp.deepwiki.com/mcp")
# Odmietnuté API
mcp(server_url="http://mcp.deepwiki.com/mcp")
Druhé pravidlo sa týka presnosti cesty. URL musí smerovať priamo na koncový bod MCP, nie na koreň domény. Takmer všetky servery vystavujú svoj koncový bod na vyhradenej ceste a konvencia sa líši server od servera. Tu sú tri platné formy, s ktorými sa stretneš:
https://mcp.deepwiki.com/mcp
https://api.example.com/mcp
https://tools.monentreprise.com/v1/mcp
Tretie pravidlo vyplýva z prvých dvoch: localhost a súkromné IP adresy sú vylúčené. Server musí byť dosiahnuteľný z infraštruktúry xAI, musí mať verejnú doménu a platný SSL certifikát. To vyvoláva konkrétnu otázku počas vývoja, keďže server MCP, ktorý práve píšeš, beží na tvojom stroji. Obvyklým riešením je použitie tunela – napríklad ngrok alebo Cloudflare Tunnel – ktorý na dobu testovania vystaví tvoju lokálnu inštanciu za verejnú URL adresu HTTPS.
server_label: Identita servera v konverzácii
server_label je krátky identifikátor, ktorý Grok používa ako prefix pre volania nástrojov z tohto servera. Jeho úloha je dvojaká: zabezpečiť čitateľnosť záznamov a odstrániť akúkoľvek nejednoznačnosť, keď koexistuje viacero serverov.
Dokumentácia xAI uvádza, že label pridáva prefix k volaniam nástrojov z tohto servera, ale nešpecifikuje presný formát prefixu. V tomto kurze označujeme nástroj search_docs zo servera deepwiki ako deepwiki__search_docs kvôli lepšej čitateľnosti: pred vytvorením logiky na tomto základe si over skutočný formát v odpovediach API.
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki"
)
# Volania nástrojov z tohto servera budú mať prefix "deepwiki"
Výber dobrého labelu sa riadi tromi kritériami. Musí byť krátky, pretože sa pridáva k názvu každého volania a zdĺhavý label zbytočne nafukuje tvoje logy. Musí byť výstižný, aby bol zdroj volania čitateľný na prvý pohľad bez nutnosti konzultovať konfiguráciu. A musí byť v tvojej konfigurácii jedinečný, inak nebudeš môcť rozlíšiť dva servere od seba. Nasledujúce príklady spĺňajú všetky tri požiadavky:
server_label="deepwiki" # Dokumentácia GitHub
server_label="crm" # Systém riadenia zákazníkov
server_label="jira" # Sledovanie ticketov
server_label="search" # Interný vyhľadávač
Toto sa stáva oveľa konkrétnejším hneď, ako pripojíš viacero serverov do tej istej relácie. Predstav si, že tvoja interná dokumentácia aj DeepWiki vystavujú nástroj s názvom search. Bez odlišných labelov by sa názvy nástrojov prekryli a Grok by nemal spôsob, ako zistiť, ktorý z nich cieľovať. S labelmi sú oba nástroje opatrené odlišnými prefixmi – tu označené ako deepwiki__search a internal-docs__search – a zmätok zmizne. K tomuto bodu sa vrátiš v lekcii venovanej práci s viacerými servermi.
Minimálna konfigurácia v oboch SDK
Tieto dva parametre spoločne stačia na to, aby verejný server MCP fungoval. Pri použití natívneho xAI SDK:
from xai_sdk.tools import mcp
tools = [
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki"
)
]
A presný ekvivalent s Responses API vo formáte OpenAI:
tools = [{
"type": "mcp",
"server_url": "https://mcp.deepwiki.com/mcp",
"server_label": "deepwiki",
}]
Kľúčové poznatky
server_urlaserver_labelsú jediné dva povinné parametre- URL musí byť HTTPS s platným SSL certifikátom, žiadne localhost
- Label pridáva prefix ku všetkým volaniam nástrojov z tohto servera (presný formát nie je zdokumentovaný; tento kurz ho označuje ako
label__tool) - Vyberaj labely, ktoré sú krátke, výstižné a jedinečné pre každý server
- Label je nevyhnutný pri práci s viacerými servermi, aby sa predišlo konfliktom názvov