Shrnutí a praktické cvičení
Na této stránce
Co jsme si probrali
Tento kurz tě provedl od konceptu protokolu Model Context Protocol až po konfiguraci připravenou na produkci. Pokud si máš zapamatovat jen jednu věc, ať je to toto: MCP umožňuje Grokovi připojovat se k externím serverům nástrojů přes HTTPS, automaticky objevovat a využívat exponované nástroje bez nutnosti ruční konfigurace na straně klienta.
Architektonicky vše stojí na čtyřech bodech. Vzdálené MCP funguje výhradně přes HTTPS, což vylučuje prosté HTTP, localhost i transport stdio pro lokální servery. Podporovány jsou dva transporty: moderní bezstavový Streaming HTTP a perzistentní SSE, přičemž o výběru rozhoduje server – ty si nevybíráš. Nakonec tři rozhraní poskytují přístup k tomuto mechanismu: nativní xAI SDK (doporučeno), Responses API pro kompatibilitu s OpenAI a Voice Agent API pro hlasové agenty.
Šest parametrů v kostce
| Parametr | Povinný | Funkce |
|---|---|---|
server_url | Ano | Adresa HTTPS serveru MCP |
server_label | Ano | Unikátní identifikátor, prefixuje nástroje |
server_description | Ne | Popis v přirozeném jazyce pro navigaci Groka |
allowed_tool_names | Ne | Whitelist přístupných nástrojů |
authorization | Ne | Autentizační token (Bearer, API klíč) |
headers | Ne | Další HTTP hlavičky |
Dva povinné, čtyři volitelné: to je celý konfigurační povrch pro vzdálené MCP. Ty volitelné však nejsou jen pro pohodlí. allowed_tool_names řeší tvou bezpečnost a server_description zajišťuje přesný výběr, když koexistuje více serverů.
Kontrola před nasazením do produkce
Tři kategorie kontrol si zasluhují explicitní ověření. Z hlediska bezpečnosti se ujisti, že URL používají HTTPS s platnými certifikáty, každý interní server má svůj autentizační token, tyto tokeny žijí v proměnných prostředí, nástroje jsou omezeny na nezbytné minimum a pravidelná rotace tokenů je naplánována, nikoliv jen v rovině přání.
Z hlediska konfigurace musí mít každý server unikátní a výstižný server_label a jeho server_description musí být přesná a aktuální – popis odkazující na starší verzi serveru model zmátne. Udržuj celkový počet nástrojů v rozumných mezích, zhruba deset až dvacet na relaci, a odstraň ze konfigurace servery, jejichž nástroje již nikdo nevolá.
Z hlediska pozorovatelnosti (observability) měj předem připravený plán pro incidenty: sledování volání nástrojů v logách, alerty na chyby připojení MCP, sledování využití tokenů na každý server a měření latence volání. To poslední se často zanedbává, přestože jde o první signál degradujícího se serveru.
Tvůj první agent ve třech krocích
Nejlepší způsob, jak si tento kurz upevnit, je postupná stavba. Začni veřejným serverem bez autentizace, abys ověřil, že mechanika funguje end-to-end.
from xai_sdk import Client
from xai_sdk.tools import mcp
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
chat = client.chat.create(
model="grok-4.20-0309-reasoning",
tools=[
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki"
)
],
)
Otestuj to požadavkem, který model donutí konzultovat repozitář, například: „vysvětli mi architekturu projektu fastapi/fastapi“. Pokud odpověď dorazí a cituje skutečnou strukturu projektu, je tvé připojení MCP funkční.
Dále přidej nativní nástroj, abys viděl, jak Grok arbitruje mezi dvěma zdroji různé povahy. Popis serveru se zde stává užitečným právě proto, že nyní existuje možnost výběru.
tools=[
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki",
server_description="Dokumentace pro open-source projekty na GitHubu"
),
{"type": "web_search"},
]
Nakonec udělej krok k internímu serveru s autentizací a omezením nástrojů. To je moment, kdy se vše, co jsi viděl ohledně bezpečnosti, stane konkrétním.
tools=[
mcp(server_url="https://mcp.deepwiki.com/mcp", server_label="deepwiki"),
mcp(
server_url="https://api.your-server.com/mcp",
server_label="internal",
server_description="Interní data a nástroje společnosti",
authorization=f"Bearer {os.getenv('INTERNAL_TOKEN')}",
allowed_tool_names=["search", "get_document"]
),
{"type": "web_search"},
]
Co platí i po absolvování tohoto kurzu
Čtyři omezení budou provázet všechny tvé projekty MCP s Grokem. Responses API ve formátu OpenAI nepodporuje ani require_approval, ani connector_id, což tě vrací k nativnímu SDK, kdykoliv chceš před spuštěním lidské schválení. Transport stdio, a tedy lokální servery MCP, zůstávají nedostupné: pouze HTTPS. Každý exponovaný nástroj spotřebovává kontext, takže minimalismus je architektonické rozhodnutí, nikoliv dodatečná myšlenka. A síťová latence se s každým voláním sčítá, takže agent řetězící několik nástrojů MCP bude odpovídat pomaleji než agent volající jen jeden.
Žádné z těchto omezení není blokující. Vše lze obejít designovými rozhodnutími učiněnými s plnou znalostí věci, což je přesně to, co ti tento kurz dal.
Klíčové poznatky
- Vzdálené MCP připojuje Groka k externím nástrojům přes HTTPS v několika řádcích konfigurace
- K nastavení serveru MCP stačí šest parametrů (dva povinné, čtyři volitelné)
- Bezpečnost stojí na trojici HTTPS + autentizace + omezení nástrojů
- Začni veřejným serverem (DeepWiki) a poté přejdi na autentizovaný více-serverový režim
- Kombinuj MCP a nativní nástroje pro tvorbu univerzálních agentů
Ověř si své znalosti
Vzdálené servery MCP v API Grok: toto shrnutí sis zasloužil.
1. Co umožňuje podpora MCP v API Grok?
Odpověď: Připojit vzdálené servery MCP jako nástroje modelu: Grok volá jejich schopnosti během generování – tvé systémy a ekosystém MCP se stávají rozšířením.
2. Jak deklaruješ server MCP v požadavku?
Odpověď: Pomocí server_url a server_label, s popisem a whitelistem autorizovaných nástrojů – a autentizačními hlavičkami potřebnými pro přístup.
3. Co umožňuje konfigurace více serverů?
Odpověď: Kombinovat více serverů MCP v jediném požadavku – každý označený štítkem – a míchat je s vestavěnými nástroji (web, X): orchestrace zůstává na modelu.
4. Které transporty jsou podporovány?
Odpověď: Streaming HTTP a SSE – vzdálené transporty protokolu: server žije, kde chceš, API se k němu připojuje.
5. Jaká bezpečnostní pravidla platí pro vzdálené servery?
Odpověď: Autorizuj pouze nezbytné nástroje, seriózně autentizuj a treat odpovědi serveru jako data k validaci – server MCP třetí strany je potenciální útočný vektor.
Deklaruj, omezuj, autentizuj, kombinuj: vzdálené MCP rozšiřuje Groka na tvé systémy – podle tvých pravidel.