Összefoglaló és gyakorlati feladatok
Ezen az oldalon
Amit átvettünk
Ez a tanfolyam végigvezetett téged a Model Context Protocol koncepciójától a gyártási környezetben is bevethető konfigurációig. Ha csak egyetlen dolgot jegyzel meg, legyen ez: az MCP lehetővé teszi, hogy a Grok HTTPS-en keresztül csatlakozzon külső eszközkiszolgálókhoz, automatikusan felfedezve és használva a közzétett eszközöket manuális kliensoldali beállítás nélkül.
Architekturális szempontból négy pont határozza meg az egészet. A távoli MCP kizárólag HTTPS-en működik, így a sima HTTP, a localhost és a helyi kiszolgálókhoz használt stdio transzport nem jön szóba. Két transzport támogatott: a modern, állapot nélküli Streaming HTTP és a tartós SSE; a kiszolgáló dönti el, melyiket használja – neked nincs választási lehetőséged. Végül három felület biztosít hozzáférést ehhez a mechanizmushoz: a natív xAI SDK (ajánlott), az OpenAI-kompatibilitást biztosító Responses API, valamint a hangalapú ügynököknek szánt Voice Agent API.
A hat paraméter dióhéjban
| Paraméter | Kötelező | Funkció |
|---|---|---|
server_url | Igen | Az MCP-kiszolgáló HTTPS-címe |
server_label | Igen | Egyedi azonosító, előtagként szolgál az eszközöknél |
server_description | Nem | Természetes nyelvű leírás a Grok irányításához |
allowed_tool_names | Nem | A hozzáférhető eszközök engedélylistája |
authorization | Nem | Hitelesítési token (Bearer, API-kulcs) |
headers | Nem | További HTTP-fejlécek |
Két kötelező, négy opcionális: ennyi a távoli MCP teljes konfigurációs felülete. Az opcionális elemek azonban nem csupán kényelmi funkciók. Az allowed_tool_names a biztonságot szolgálja, a server_description pedig biztosítja a pontos kiválasztást, amikor több kiszolgáló is jelen van egyszerre.
Ellenőrzések a gyártásba lépés előtt
Három ellenőrzési kategória igényel kifejezett figyelmet. A biztonság oldalán győződj meg arról, hogy az URL-ek érvényes tanúsítvánnyal rendelkező HTTPS-t használnak, minden belső kiszolgáló rendelkezik saját hitelesítési tokennel, ezek a tokenek környezetváltozókban tárolódnak, az eszközök hozzáférése a szükséges minimumra van korlátozva, és a tokenek rendszeres cseréje tervezett folyamat, nem pedig reménykedés tárgya.
A konfiguráció oldalán minden kiszolgálónak rendelkeznie kell egy egyedi, beszédes server_label címkével, a server_description leírásának pedig pontosnak és naprakésznek kell lennie – egy korábbi kiszolgálóverziót leíró szöveg félrevezeti a modellt. Tartsd ésszerű keretek között az eszközök teljes számát (munkamenetenként körülbelül tíz-húsz), és távolítsd el a konfigurációból azokat a kiszolgálókat, amelyek eszközeit már senki sem hívja meg.
A megfigyelhetőség oldalán készülj fel előre az incidensekre: naplózd az eszközhívásokat, állíts be riasztásokat az MCP-kapcsolódási hibákra, kövesd nyomon a tokenfelhasználást kiszolgálónként, és mérd a hívások késleltetését. Ez utóbbit gyakran elhanyagolják, pedig ez az első jelzője egy romló teljesítményű kiszolgálónak.
Az első ügynököd három lépésben
A tanfolyam anyagának legjobb megszilárdítási módja a fokozatos építkezés. Kezdj egy nyilvános kiszolgálóval, hitelesítés nélkül, hogy ellenőrizd: a mechanizmus végig működik.
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"
)
],
)
Tesztelj egy olyan kéréssel, amely ténylegesen rákényszeríti a modellt a tároló lekérdezésére, például: „Magyarázd el nekem a fastapi/fastapi projekt architektúráját.“ Ha megérkezik a válasz, és hivatkozik a valós projektfelépítésre, az MCP-kapcsolatod működőképes.
Ezután adj hozzá egy natív eszközt, hogy lásd, hogyan dönt a Grok két különböző természetű forrás között. Itt válik hasznossá a kiszolgáló leírása, pontosan azért, mert most választási lehetőség áll fenn.
tools=[
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki",
server_description="Dokumentáció nyílt forráskódú GitHub-projektekhez"
),
{"type": "web_search"},
]
Végül lépj tovább egy belső kiszolgálóhoz, hitelesítéssel és eszközkorlátozással. Ebben a lépésben válik kézzelfoghatóvá minden, amit a biztonságról tanultál.
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="Vállalati belső adatok és eszközök",
authorization=f"Bearer {os.getenv('INTERNAL_TOKEN')}",
allowed_tool_names=["search", "get_document"]
),
{"type": "web_search"},
]
Ami e tanfolyam után is igaz marad
Négy korlátozás kísérni fog minden Grokkal végzett MCP-projektedet. Az OpenAI-formátumú Responses API nem támogatja sem a require_approval, sem a connector_id paramétert, ami azt jelenti, hogy ha emberi jóváhagyást szeretnél a végrehajtás előtt, vissza kell térned a natív SDK-hoz. Az stdio transzport, és ezzel együtt a helyi MCP-kiszolgálók elérhetetlenek maradnak: kizárólag HTTPS lehetséges. Minden közzétett eszköz fogyasztja a kontextust, így a minimalizmus nem utólagos meggondolás, hanem architektúrális döntés. Végül a hálózati késleltetés minden hívással összeadódik, tehát egy több MCP-eszközt láncoló ügynök lassabban válaszol, mint egy csak egyetlen eszközt hívó.
Ezen korlátok egyike sem akadály. Mindegyik megkerülhető a teljes ismeretben hozott tervezési döntésekkel – pontosan ezt adta neked ez a tanfolyam.
Főbb megállapítások
- A távoli MCP HTTPS-en keresztül köti össze a Grokot külső eszközökkel, néhány sor konfigurációval
- Hat paraméter elegendő egy MCP-kiszolgáló beállításához (kettő kötelező, négy opcionális)
- A biztonság a HTTPS + hitelesítés + eszközkorlátozás hármasán alapul
- Kezdj egy nyilvános kiszolgálóval (DeepWiki), majd lépj tovább a hitelesített, többkiszolgálós környezethez
- Kombináld az MCP-eszközöket natív eszközökkel sokoldalú ügynökök létrehozásához
Teszteld a tudásod
Távoli MCP-kiszolgálók a Grok API-ban: megérdemled ezt az összefoglalót.
1. Mit tesz lehetővé a Grok API MCP-támogatása?
Válasz: Távoli MCP-kiszolgálók csatlakoztatása modell-eszközként: a Grok generálás közben hívja meg ezek képességeit – így a te rendszereid és az MCP-ökoszisztéma kiterjesztéssé válnak.
2. Hogyan deklarálasz egy MCP-kiszolgálót egy kérésben?
Válasz: A server_url és a server_label segítségével, kiegészítve a leírással és a jogosult eszközök engedélylistájával – valamint a hozzáféréshez szükséges hitelesítési fejlécekkel.
3. Mit tesz lehetővé a többkiszolgálós konfiguráció?
Válasz: Több MCP-kiszolgáló kombinálását egyetlen kérésben – mindegyiket címkézve – és ezek vegyítését beépített eszközökkel (web, X): az orchestrációt a modell végzi.
4. Mely transzportok támogatottak?
Válasz: Streaming HTTP és SSE – a protokoll távoli transzportjai: a kiszolgáló ott él, ahol akarod, az API csatlakozik hozzá.
5. Milyen biztonsági szabályok vonatkoznak a távoli kiszolgálókra?
Válasz: Csak a szükséges eszközöket engedélyezd, hitelesíts komolyan, és a kiszolgáló válaszait validálandó adatként kezeld – egy harmad féltől származó MCP-kiszolgáló potenciális támadási felület.
Deklarálj, korlátozz, hitelesíts, kombinálj: a távoli MCP kiterjeszti a Grokot a te rendszereidre – a te szabályaid szerint.