Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

server_url a server_label

Lekcia 4 z 12 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Dva parametre, bez ktorých sa nezaobídeš
  2. server_url: Presná adresa koncového bodu
  3. server_label: Identita servera v konverzácii
  4. Minimálna konfigurácia v oboch SDK
  5. Kľúčové poznatky

Aktualizované 3. novembra 2026 na základe stránky Remote MCP Tools od xAI: server_label pridáva prefix k volaniam nástrojov, ale dokumentácia nešpecifikuje presný formát tohto prefixu; notácia label__tool použ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
Kde sa server nachádza
server_label
Ako identifikovať server

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_url a server_label sú 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