Autentificare și antete
Pe această pagină
Dovediți cine face apelul
DeepWiki și alte servere MCP publice acceptă orice apelant, ceea ce corespunde scopului lor. Însă, imediat ce expuneți propriile instrumente, lucrurile se schimbă: fără autentificare, oricine ghicește URL-ul vă poate interoga CRM-ul sau declanșa procesele dumneavoastră. xAI oferă doi parametri pentru a rezolva această problemă: authorization pentru token-ul de acces și headers sau extra_headers pentru orice altceva.
Parametrul authorization
Acesta trimite un token de autentificare către serverul MCP. Mai exact, șirul de caractere pe care îl furnizați este plasat ca atare în antetul HTTP Authorization al fiecărei cereri trimise către acel server.
mcp(
server_url="https://api.example.com/mcp",
server_label="internal",
authorization="Bearer sk-your-token-here"
)
Formatul așteptat depinde în totalitate de serverul țintă, deoarece authorization acceptă orice șir de caractere: serverul MCP validează token-ul, nu xAI. Trei forme acoperă aproape toate cazurile pe care le veți întâlni.
- Token Bearer:
"Bearer sk-xxxx"— cel mai comun, utilizat de majoritatea API-urilor REST - Cheie API:
"ApiKey your-key"— unele servicii folosesc un prefix personalizat - Autentificare de bază:
"Basic base64(user:password)"— autentificare de bază codificată în base64
Deoarece acest token însoțește fiecare cerere, manipularea sa necesită prudență. Nu îl codificați niciodată direct în sursă: un secret scris într-un fișier versionat ajunge inevitabil într-un depozit de cod, într-un jurnal sau într-o captură de ecran. Utilizați întotdeauna o variabilă de mediu. Dacă serverul permite, preferați un token cu scop limitat care deschide doar instrumentele de care aveți efectiv nevoie — aceasta este contrapartea la nivel de server a restricției allowed_tool_names. Planificați, de asemenea, rotația regulată a token-urilor, în special în producție, unde un token etern este un token care va fi compromis la un moment dat.
import os
mcp(
server_url="https://api.example.com/mcp",
server_label="internal",
authorization=f"Bearer {os.getenv('MCP_SERVER_TOKEN')}"
)
headers și extra_headers
Token-ul răspunde la întrebarea „cine sunteți?“. Multe servere necesită răspunsuri suplimentare: pentru ce organizație, în ce mediu, cu ce versiune de API. Aceste informații sunt transmise prin parametrul headers sau extra_headers, în funcție de 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"
}
)
Cel mai frecvent caz îl reprezintă platformele multi-tenant, unde același endpoint deservește mai mulți clienți și se bazează pe un antet pentru a direcționa cererea către datele corecte. Urmează versionarea API, cu un antet precum "X-API-Version": "2024-01" care fixează o versiune specifică și vă protejează de modificările serverului. Unele sisteme așteaptă, de asemenea, metadate de urmărire — ID sesiune, ID agent — pentru a tras originea apelurilor, sau antete de limitare a ratei care determină planul de facturare aplicat.
Numele parametrului variază în funcție de interfața pe care o utilizați. SDK-ul nativ xAI folosește headers în majoritatea cazurilor; API-ul Responses în format OpenAI poate necesita extra_headers pentru a evita orice coliziune cu antetele pe care acest SDK le gestionează automat pentru sine. Comportamentul este însă exact același: antetele sunt adăugate la fiecare cerere către serverul MCP. Dacă cererile dumneavoastră pleacă fără antetele personale, verificați mai întâi numele acestui parametru înainte de a căuta în altă parte.
O configurație completă pentru producție
Iată cum se asamblează acești parametri cu cei din lecțiile anterioare, într-un caz realist de 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"]
)
]
Această configurație se conectează la serverul MCP intern prin HTTPS, se autentifică cu un token Bearer stocat într-o variabilă de mediu, trimite ID-ul organizației într-un antet și restricționează accesul la trei operațiuni de citire. Rețineți că fiecare linie blochează un aspect diferit: criptarea protejează transportul, token-ul dovedește identitatea, antetul definește domeniul de date, iar lista de permisiuni limitează daunele potențiale. Niciunul dintre aceste straturi nu le înlocuiește pe celelalte.
Puncte cheie
authorizationtrimite token-ul de acces către serverul MCP prin antetul HTTP Authorization- Stocați întotdeauna token-urile în variabile de mediu, niciodată codificate direct în cod
headers/extra_headersadaugă antete HTTP suplimentare fiecărei cereri- Antetele servesc la identificarea multi-tenant, versionarea API și urmărire
- Combinați autentificarea și restricționarea instrumentelor pentru securitate maximă