Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

L-awtentikazzjoni u l-intestaturi

Lezzjoni 6 / 12 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Ipprova min qed iċempel
  2. Il-parametru authorization
  3. headers u extra_headers
  4. Konfigurazzjoni sħiħa tal-produzzjoni
  5. Punti Ewlenin

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

  • authorization jibgħ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_headers iż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à