Hitelesítés és fejlécek
Ezen az oldalon
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
authorizationelkü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_headersextra 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