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

Hitelesítés és fejlécek

6. lecke 12 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. Igazold, ki hív
  2. Az authorization paraméter
  3. headers és extra_headers
  4. Egy teljes körű éles konfiguráció
  5. Főbb megállapítások

Igazold, ki hív

A DeepWiki és más nyilvános MCP szerverek bármely hívót elfogadnak, ami összhangban van a céljukkal. Amint azonban saját eszközöket teszel közzé, megváltozik a helyzet: hitelesítés nélkül bárki, aki kitalálja az URL-t, lekérdezheti a CRM-edet vagy elindíthatja a folyamataidat. Az xAI két paramétert biztosít ennek kezelésére: az authorization paramétert a hozzáférési tokenhez, valamint a headers vagy extra_headers paramétereket minden egyébhez.

Az authorization paraméter

Ez küldi el a hitelesítési tokent az MCP szervernek. Konkrétabban: a megadott karakterlánc változatlanul kerül bele minden, a szervernek küldett kérés HTTP Authorization fejlécébe.

mcp(
    server_url="https://api.example.com/mcp",
    server_label="internal",
    authorization="Bearer sk-your-token-here"
)

A várt formátum teljes mértékben a célservertől függ, mivel az authorization bármilyen karakterláncot elfogad: az MCP szerver végzi az ellenőrzést, nem az xAI. Három forma lefedi az esetek szinte összes típusát, amivel találkozhatsz.

  • Bearer token: "Bearer sk-xxxx" – a leggyakoribb, a REST API-k többsége ezt használja
  • API kulcs: "ApiKey your-key" – egyes szolgáltatások egyedi előtagot használnak
  • Basic auth: "Basic base64(user:password)" – base64-ben kódolt alapvető hitelesítés

Mivel ez a token minden kéréssel együtt jár, kezelését nagy gondossággal kell végezni. Soha ne építsd be közvetlenül a forráskódba: egy verziókezelt fájlba írt titok előbb-utóbb felbukkan egy tárolóban, egy naplófájlban vagy egy képernyőmentésen. Mindig környezeti változót használj. Ha a szerver engedi, részesítsd előnyben a hatókörrel rendelkező tokent, amely csak a ténylegesen szükséges eszközöket nyitja meg – ez a szerveroldali megfelelője az allowed_tool_names korlátozásnak. Tervezd meg a rendszeres cserét is, különösen éles környezetben, ahol az örök érvényű token előbb-utóbb szivárgni fog.

import os

mcp(
    server_url="https://api.example.com/mcp",
    server_label="internal",
    authorization=f"Bearer {os.getenv('MCP_SERVER_TOKEN')}"
)

headers és extra_headers

A token arra a kérdésre ad választ, hogy „ki vagy te“. Sok szervernek további információkra is szüksége van: melyik szervezet számára, melyik környezetben, melyik API-verzióval. Ezeket az adatokat a headers paraméteren, vagy az SDK-tól függően az extra_headers paraméteren keresztül adjuk át.

mcp(
    server_url="https://api.example.com/mcp",
    server_label="internal",
    authorization="Bearer sk-token",
    headers={
        "X-Organization-Id": "org-123",
        "X-Project-Id": "proj-456"
    }
)

A leggyakoribb eset a több bérlőt kiszolgáló platformoké, ahol ugyanaz a végpont több ügyfelet szolgál ki, és egy fejléc alapján irányítja a kérést a megfelelő adathoz. Ezt követi az API-verziókezelés, olyan fejléccel, mint például "X-API-Version": "2024-01", amely rögzít egy adott verziót, és megvéd a szerveroldali változtatásoktól. Egyes rendszerek nyomkövetési metaadatokat is várnak – munkamenet-azonosító, ügynök-azonosító –, hogy nyomon követhessék a hívások eredetét, vagy sebességkorlátozási fejléceket, amelyek meghatározzák az alkalmazott számlázási csomagot.

A paraméter neve attól függően változik, melyik felületet használod. A natív xAI SDK a legtöbb esetben a headers paramétert használja; az OpenAI-formátumú Responses API esetén lehet, hogy az extra_headers szükséges, hogy elkerüljük az ütközést azokkal a fejlécekkel, amelyeket ez az SDK automatikusan kezel a saját számára. A viselkedés azonban pontosan ugyanaz: a fejlécek hozzáadódnak az MCP szervernek küldött minden kéréshez. Ha a kéréseid a fejléceid nélkül indulnak útnak, először ezt a paraméternevet ellenőrizd, mielőtt máshol keresgélnél.

Egy teljes körű éles konfiguráció

Így állnak össze ezek a paraméterek az előző leckékben tárgyaltakkal egy realisztikus, belső szerveres esetben.

from xai_sdk.tools import mcp
import os

tools = [
    mcp(
        server_url="https://api.monentreprise.com/mcp",
        server_label="internal",
        server_description="Internal tools: CRM, documentation, tickets",
        authorization=f"Bearer {os.getenv('INTERNAL_MCP_TOKEN')}",
        headers={
            "X-Organization-Id": os.getenv("ORG_ID"),
            "X-Environment": "production"
        },
        allowed_tool_names=["search_docs", "get_ticket", "search_contacts"]
    )
]

Ez a konfiguráció HTTPS-en keresztül csatlakozik a belső MCP szerverhez, egy környezeti változóban tárolt Bearer tokennel hitelesít, elküldi a szervezet azonosítóját egy fejlécben, és három olvasási műveletre korlátozza a hozzáférést. Figyeld meg, hogy minden sor egy másik aspektust zár le: a titkosítás védi a szállítást, a token igazolja a személyazonosságot, a fejléc meghatározza az adatok hatókörét, az engedélyezési lista pedig korlátozza a potenciális károkat. Ezen rétegek egyike sem helyettesíti a másikat.

Főbb megállapítások

  • Az authorization elküldi a hozzáférési tokent az MCP szervernek az HTTP Authorization fejlécen keresztül
  • A tokenjeidet mindig környezeti változókban tárold, soha ne legyenek közvetlenül a kódba írva
  • A headers / extra_headers extra HTTP fejléceket adnak hozzá minden kéréshez
  • A fejlécek szolgálják a több bérlős azonosítást, az API-verziókezelést és a nyomkövetést
  • Kombináld a hitelesítést és az eszközök korlátozását a maximális biztonság érdekében