Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

server_url a server_label

Lekce 4 z 12 Aktualizováno 3. listopadu 2026 Vývojář
Na této stránce
  1. Dva parametry, bez kterých se neobejdeš
  2. server_url: Přesná adresa koncového bodu
  3. server_label: Identita serveru v konverzaci
  4. Minimální konfigurace v obou SDK
  5. Klíčové poznatky

Aktualizováno 3. listopadu 2026 na základě stránky xAI Remote MCP Tools: server_label sice přidává prefix voláním nástrojů, ale dokumentace nespecifikuje přesný formát tohoto prefixu; notace label__tool použ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
Kde se server nachází
server_label
Jak server identifikovat

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_url a server_label jsou 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ů