server_url a server_label
Na této stránce
Aktualizováno 3. listopadu 2026 na základě stránky xAI Remote MCP Tools:
server_labelsice přidává prefix voláním nástrojů, ale dokumentace nespecifikuje přesný formát tohoto prefixu; notacelabel__toolpoužitá v tomto kurzu je konvencí pro čitelnost – ověř si skutečný formát ve svých odpovědích API. Zdroj: Remote MCP Tools.
Dva parametry, bez kterých se neobejdeš
Každé připojení mezi Grokem a vzdáleným serverem MCP závisí na dvou parametrech: server_url a server_label. Jsou nepostradatelné – bez nich API žádost zamítne ještě předtím, než se o cokoli pokusí. Všechny ostatní parametry, se kterými se později setkáš, pouze upřesňují tento základ; nikdy jej nenahrazují.
server_url: Přesná adresa koncového bodu
Parametr server_url obsahuje úplnou URL adresu serveru MCP, ke kterému se musí Grok připojit, a tato URL se řídí přísnými pravidly.
Prvním je HTTPS. URL musí začínat na https:// a xAI odmítá jakékoli nešifrované HTTP připojení. Důvod je prostý: výměna mezi Grokem a serverem MCP nese požadavky tvých uživatelů, výsledky nástrojů a někdy i samotný autentizační token. Nechat tato data kolovat v čistém textu by bylo neobhajitelné.
# Správně
mcp(server_url="https://mcp.deepwiki.com/mcp")
# API zamítne
mcp(server_url="http://mcp.deepwiki.com/mcp")
Druhé pravidlo se týká přesnosti cesty. URL musí směřovat přímo na koncový bod MCP, nikoli na kořen domény. Téměř všechny servery vystavují svůj koncový bod na vyhrazené cestě a konvence se liší server od serveru. Zde jsou tři platné formy, se kterými se setkáš:
https://mcp.deepwiki.com/mcp
https://api.example.com/mcp
https://tools.monentreprise.com/v1/mcp
Třetí pravidlo vyplývá z prvních dvou: localhost a privátní IP adresy jsou vyloučeny. Server musí být dosažitelný z infrastruktury xAI, musí běžet na veřejné doméně a mít platný SSL certifikát. To vyvolává konkrétní otázku během vývoje, protože server MCP, který píšeš, běží na tvém stroji. Obvyklým řešením je použití tunelu – například ngrok nebo Cloudflare Tunnel – který na dobu testů vystaví tvou lokální instanci za veřejnou HTTPS URL.
server_label: Identita serveru v konverzaci
server_label je krátký identifikátor, který Grok používá jako prefix pro volání nástrojů z tohoto serveru. Jeho role je dvojitá: zajistit čitelnost stop a odstranit jakoukoli nejistotu, když koexistuje více serverů.
Dokumentace xAI uvádí, že label přidává prefix voláním nástrojů z tohoto serveru, ale nespecifikuje přesný formát prefixu. V tomto kurzu označujeme nástroj search_docs ze serveru deepwiki jako deepwiki__search_docs kvůli čitelnosti: před vytvořením logiky na tomto základě si ověř skutečný formát v odpovědích API.
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki"
)
# Volání nástrojů z tohoto serveru budou mít prefix "deepwiki"
Volbu dobrého labelu řídí tři kritéria. Musí být krátký, protože se přidává ke jménu každého volání a upovídaný label zbytečně nafukuje tvé logy. Musí být výstižný, aby byl zdroj volání čitelný na první pohled bez nutnosti nahlížet do konfigurace. A musí být v rámci tvé konfigurace jedinečný, jinak nebudeš schopen rozlišit dva servery. Níže uvedené příklady splňují všechny tři požadavky:
server_label="deepwiki" # Dokumentace GitHub
server_label="crm" # Systém pro správu zákazníků
server_label="jira" # Sledování ticketů
server_label="search" # Interní vyhledávač
To nabývá na konkrétnosti, jakmile připojíš více serverů ke stejné relaci. Předpokládejme, že tvá interní dokumentace i DeepWiki vystavují nástroj nazvaný search. Bez odlišných labelů by se názvy nástrojů kolidovaly a Grok by neměl způsob, jak určit, který cílit. S labely jsou oba nástroje opatřeny odlišnými prefixy – zde zapsáno jako deepwiki__search a internal-docs__search – a zmatek zmizí. K tomuto bodu se vrátíš v lekci věnované více serverům.
Minimální konfigurace v obou SDK
Tyto dva parametry společně stačí k tomu, aby veřejný server MCP fungoval. S nativním xAI SDK:
from xai_sdk.tools import mcp
tools = [
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki"
)
]
A přesný ekvivalent s Responses API ve formátu OpenAI:
tools = [{
"type": "mcp",
"server_url": "https://mcp.deepwiki.com/mcp",
"server_label": "deepwiki",
}]
Klíčové poznatky
server_urlaserver_labeljsou jediné dva požadované parametry- URL musí být HTTPS s platným SSL certifikátem, žádné localhost
- Label přidává prefix všem voláním nástrojů z tohoto serveru (přesný formát není zdokumentován; tento kurz jej zapisuje jako
label__tool) - Vol labely, které jsou krátké, výstižné a pro každý server jedinečné
- Label je zásadní pro práci s více servery, aby se předešlo konfliktům názvů