Povzetek in praktične vaje
Na tej strani
Kaj smo obravnavali
Ta tečaj te je popeljal od koncepta protokola Model Context Protocol do konfiguracije, pripravljene za proizvodno okolje. Če si zapomniš samo eno stvar, naj bo to: MCP omogoča, da se Grok poveže z zunanjimi strežniki orodij prek HTTPS, samodejno odkrije in uporabi izpostavljena orodja brez ročne konfiguracije na strani odjemalca.
Arhitekturno vse ostalo temelji na štirih točkah. Oddaljeni MCP deluje izključno prek HTTPS, kar izključuje navadni HTTP, localhost in transport stdio za lokalne strežnike. Podprta sta dva transporta: sodobni brezstanjski Streaming HTTP in trajnostni SSE, pri čemer strežnik določa, kateri se uporablja – ti ne izbiraš. Končno trije vmesniki omogočajo dostop do tega mehanizma: izvorni xAI SDK (priporočeno), Responses API za združljivost z OpenAI in Voice Agent API za glasovne agente.
Šest parametrov na hitro
| Parameter | Obvezno | Funkcija |
|---|---|---|
server_url | Da | Naslov HTTPS strežnika MCP |
server_label | Da | Edinstven identifikator, predpona orodjem |
server_description | Ne | Opis v naravnem jeziku za usmerjanje Groka |
allowed_tool_names | Ne | Seznam dovoljenih orodij (allowlist) |
authorization | Ne | Avtentiacijski žeton (Bearer, API ključ) |
headers | Ne | Dodatni glave HTTP |
Dva obvezna, štiri izbirna: to je celotna površina konfiguracije za oddaljeni MCP. Izbirni parametri niso le udobje. allowed_tool_names skrbi za tvojo varnost, server_description pa zagotavlja natančno izbiro, ko sočasno deluje več strežnikov.
Preverjanja pred prehodom v proizvodno okolje
Tri kategorije kontrol zahtevajo izrecno preverjanje. Na področju varnosti zagotovi, da URL-ji uporabljajo HTTPS z veljavnimi certifikati, ima vsak notranji strežnik svoj avtentiacijski žeton, ti žetoni živijo v okoljskih spremenljivkah, so orodja omejena na nujni minimum in je načrtovana redna rotacija žetonov, ne pa le upanje nanjo.
Na strani konfiguracije mora imeti vsak strežnik edinstveno in opisno server_label, njegov server_description pa mora biti natančen in posodobljen – opis, ki opisuje starejšo različico strežnika, zavaja model. Ohrani skupno število orodij razumno, približno deset do dvajset na sejo, in iz konfiguracije odstrani strežnike, katerih orodij nihče več ne kliče.
Na področju opazovanja načrtuj incidente vnaprej: sledenje klicem orodij v tvojih dnevnikih, opozorila ob napakah povezave MCP, sledenje uporabi žetonov na strežnik in merjenje zakasnitve klicev. Slednje je pogosto zanemarjeno, čeprav predstavlja prvi signal poslabšanja delovanja strežnika.
Tvoj prvi agent v treh korakih
Najboljši način za utrditev tega tečaja je postopna gradnja. Začni z javnim strežnikom brez avtentikacije, da preveriš, ali mehanika deluje od konca do konca.
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"
)
],
)
Preizkusi z zahtevo, ki model dejansko prisili, da poišče v repozitoriju, na primer: „razloži mi arhitekturo projekta fastapi/fastapi”. Če odgovor prispe in citira dejansko strukturo projekta, je tvoja povezava MCP operativna.
Nato dodaj izvorno orodje, da vidiš, kako Grok arbitrirata med dvema viroma različne narave. Opis strežnika tu postane koristen prav zato, ker je zdaj treba narediti izbiro.
tools=[
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki",
server_description="Dokumentacija za odprtokodne projekte na GitHubu"
),
{"type": "web_search"},
]
Končno naredi korak k notranjemu strežniku z avtentikacijo in omejitvijo orodij. To je trenutek, ko vse, kar si videl o varnosti, postane konkretno.
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="Notranji podatki in orodja podjetja",
authorization=f"Bearer {os.getenv('INTERNAL_TOKEN')}",
allowed_tool_names=["search", "get_document"]
),
{"type": "web_search"},
]
Kaj ostaja veljavno po tem tečaju
Štiri omejitve bodo spremljale vse tvoje projekte MCP z Grokom. Responses API v formatu OpenAI ne podpira niti require_approval niti connector_id, kar te vrne k izvornemu SDK, kadar koli želiš človeško potrditev pred izvedbo. Transport stdio in s tem lokalni strežniki MCP ostajajo nedosegljivi: samo HTTPS. Vsako izpostavljeno orodje porabi kontekst, zaradi česar je minimalizem arhitekturna odločitev, ne naknadna misel. In omrežna zakasnitev se sešteva z vsakim klicem, zato bo agent, ki veriži več orodij MCP, odgovarjal počasneje kot agent, ki pokliče le eno.
Nobena od teh omejitev ni ovira. Vse jih je mogoče obiti z načrtnimi odločitvami, sprejetimi s polnim znanjem, kar ti je ta tečaj pravkar dal.
Ključne ugotovitve
- Oddaljeni MCP poveže Grok z zunanjimi orodji prek HTTPS v nekaj vrsticah konfiguracije
- Za konfiguracijo strežnika MCP zadostuje šest parametrov (dva obvezna, štiri izbirna)
- Varnost temelji na trojčku HTTPS + avtentikacija + omejitev orodij
- Začni z javnim strežnikom (DeepWiki), nato napreduj k avtenticiranemu večstrežniškemu okolju
- Združi MCP in izvorna orodja za ustvarjanje vsestranskih agentov
Preveri svoje znanje
Oddaljeni strežniki MCP v API-ju Grok: ta povzetek si si zaslužil.
1. Kaj omogoča podpora MCP v API-ju Grok?
Odgovor: Povezavo oddaljenih strežnikov MCP kot orodij modela: Grok med generiranjem kliče njihove zmogljivosti – tvoji sistemi in ekosistem MCP postanejo razširitve.
2. Kako deklariraš strežnik MCP v zahtevi?
Odgovor: Prek server_url in server_label, z opisom in seznamom dovoljenih orodij – ter zahtevanimi glavami za avtentikacijo za dostop.
3. Kaj omogoča konfiguracija z več strežniki?
Odgovor: Združitev več strežnikov MCP v eni zahtevi – vsak z lastno oznako – in njihovo mešanje z vgrajenimi orodji (splet, X): orkestracija ostaja pri modelu.
4. Katera transporta sta podprta?
Odgovor: Streaming HTTP in SSE – oddaljena transporta protokola: strežnik živi, kjer želiš, API se poveže nanj.
5. Katera varnostna pravila veljajo za oddaljene strežnike?
Odgovor: Dovolj le potrebna orodja, resna avtentikacija in obravnava odgovorov strežnika kot podatkov, ki jih je treba validirati – strežnik MCP tretje strani je potencialna napadalna površina.
Deklariraj, omeji, avtenticiraj, združi: oddaljeni MCP razširi Grok na tvoje sisteme – po tvojih pravilih.