L-awtentikazzjoni u l-intestaturi
F'din il-paġna
Ipprova min qed iċempel
DeepWiki u servers MCP pubbliċi oħra jaċċettaw kwalunkwe sejħa, li huwa konsistenti mal-iskop tagħhom. Hekk kif tesponi l-għodod tiegħek stess, l-affarijiet jinbidlu: mingħajr awtentikazzjoni, kulħadd li jissuspetta l-URL jista’ jistaqsi lill-CRM tiegħek jew jattiva l-proċessi tiegħek. xAI jipprovdi żewġ parametri biex tindirizza dan—authorization għat-token tal-aċċess, u headers jew extra_headers għal kollox l-ieħor.
Il-parametru authorization
Dan jibgħat token tal-awtentikazzjoni lis-server MCP. Speċifikament, il-katina li tipprovdi titqiegħed hekk kif inhi fl-intestatura HTTP Authorization ta’ kull talba mibgħuta lil dak is-server.
mcp(
server_url="https://api.example.com/mcp",
server_label="internal",
authorization="Bearer sk-your-token-here"
)
Il-format mistenni jiddependi għalkollox fuq is-server fil-mira, peress li authorization jaċċetta kwalunkwe katina: is-server MCP jivvalidaha, mhux xAI. Tliet forom ikopru kważi l-każijiet kollha li se tiltaqa’ magħhom.
- Token Bearer:
"Bearer sk-xxxx"— l-aktar komuni, użat mill-maġġoranza tal-APIs REST - Ċavetta API:
"ApiKey your-key"— xi servizzi jużaw prefiss personalizzat - Awtentikazzjoni Bażika:
"Basic base64(user:password)"— awtentikazzjoni bażika kkodifikata f’base64
Peress li dan it-token imur ma’ kull talba, l-immaniġġjar tiegħu jeħtieġ kura. Qatt ma tiktbu b’mod ieħor (hardcode) fis-sors tiegħek: sigriet miktub f’fajl b’verżjoni eventwalment jispiċċa f’repożitorju, f’log, jew f’screenshot. Dejjem uża varjabbli tal-ambjent. Jekk is-server jippermetti, ippreferi token b’ambitu (scoped) li jiftaħ biss l-għodod li għandek bżonn verament—din hija l-kontroparti fuq in-naħa tas-server għar-restrizzjoni allowed_tool_names. U ippjana għal rotazzjoni regolari, speċjalment fil-produzzjoni, fejn token etern huwa token li eventwalment se jitnixxa.
import os
mcp(
server_url="https://api.example.com/mcp",
server_label="internal",
authorization=f"Bearer {os.getenv('MCP_SERVER_TOKEN')}"
)
headers u extra_headers
It-token iwieġeb il-mistoqsija “min int”. Ħafna servers jeħtieġu tweġibiet addizzjonali: għal liema organizzazzjoni, f’liema ambjent, b’liema verżjoni tal-API. Din l-informazzjoni tgħaddi permezz tal-parametru headers, jew extra_headers skont l-SDK.
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"
}
)
L-aktar każ komuni huwa pjattaformi multi-tenant, fejn l-istess endpoint iservi klijenti multipli u jiddependi fuq intestatura biex jirrotta t-talba għad-data t-tajba. Imbagħad hemm il-verżjonar tal-API, b’intestatura bħal "X-API-Version": "2024-01" li tippinna verżjoni speċifika u tipproteġik minn bidliet fis-server. Xi sistemi jistennew ukoll metadata ta’ traċċar—ID tas-sessjoni, ID tal-aġent—biex jittraċċaw l-oriġini tas-sejħiet, jew intestaturi ta’ limitazzjoni tar-rata (rate limiting) li jiddeterminaw il-pjan ta’ fatturazzjoni applikat.
L-isem tal-parametru jvarja skont l-interfaċċa li tuża. L-SDK nativ ta’ xAI juża headers fil-biċċa l-kbira tal-każijiet; l-API tar-Risposti bil-format OpenAI jista’ jeħtieġ extra_headers, biex tiġi evitata kwalunkwe kolliżjoni ma’ intestaturi li dan l-SDK jimmaniġġja awtomatikament għalih innifsu. L-imġiba, madankollu, hija eżattament l-istess: l-intestaturi jiżdiedu ma’ kull talba lis-server MCP. Jekk it-talbat tiegħek joħorġu mingħajr l-intestaturi tiegħek, iċċekkja l-ewwel dan l-isem tal-parametru qabel ma tfittex f’xi mkien ieħor.
Konfigurazzjoni sħiħa tal-produzzjoni
Hekk kif dawn il-parametri jingħaqdu ma’ dawk mil-lezzjonijiet preċedenti, f’każ realistiku ta’ server intern.
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"]
)
]
Din il-konfigurazzjoni tikkonnettja mas-server MCP intern fuq HTTPS, tawtentika b’token Bearer maħżun f’varjabbli tal-ambjent, tibgħat l-ID tal-organizzazzjoni f’intestatura, u tirrestrinġi l-aċċess għal tliet operazzjonijiet ta’ qari. Innota li kull linna tissakkar aspett differenti: il-krittografija tipproteġi t-trasport, it-token jipprova l-identità, l-intestatura tiddefinixxi l-ambitu tad-data, u l-lista ta’ permessi tillimita d-dannu potenzjali. L-ebda wieħed minn dawn is-saffi ma jissostitwixxi lill-oħrajn.
Punti Ewlenin
authorizationjibgħat it-token tal-aċċess lis-server MCP permezz tal-intestatura HTTP Authorization- Dejjem aħżen it-tokens tiegħek f’varjabbli tal-ambjent, qatt miktuba b’mod ieħor fil-kodiċi
headers/extra_headersiżidu intestaturi HTTP addizzjonali ma’ kull talba- L-intestaturi jservu għall-identifikazzjoni multi-tenant, il-verżjonar tal-API, u t-traċċar
- Għaqqad l-awtentikazzjoni mar-restrizzjoni tal-għodod għall-massimu sigurtà