Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Összefoglaló és gyakorlati feladatok

12. lecke 12 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. Amit átvettünk
  2. A hat paraméter dióhéjban
  3. Ellenőrzések a gyártásba lépés előtt
  4. Az első ügynököd három lépésben
  5. Ami e tanfolyam után is igaz marad
  6. Főbb megállapítások
  7. Teszteld a tudásod

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éterKötelezőFunkció
server_urlIgenAz MCP-kiszolgáló HTTPS-címe
server_labelIgenEgyedi azonosító, előtagként szolgál az eszközöknél
server_descriptionNemTermészetes nyelvű leírás a Grok irányításához
allowed_tool_namesNemA hozzáférhető eszközök engedélylistája
authorizationNemHitelesítési token (Bearer, API-kulcs)
headersNemTová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.