Autentifikacija i zaglavlja
Na ovoj stranici
Dokaži tko zove
DeepWiki i drugi javni MCP poslužitelji prihvaćaju bilo kojeg pozivatelja, što je u skladu s njihovom svrhom. Čim izložiš svoje vlastite alate, stvari se mijenjaju: bez autentifikacije, svatko tko pogodi URL može upitnik tvoj CRM ili pokrenuti tvoje procese. xAI nudi dva parametra za rješavanje ovoga – authorization za pristupni token, te headers ili extra_headers za sve ostalo.
Parametar authorization
Šalje token za autentifikaciju na MCP poslužitelj. Konkretno, niz koji navedeš postavlja se točno onako kako jest u HTTP zaglavlje Authorization svakog zahtjeva poslanog tom poslužitelju.
mcp(
server_url="https://api.example.com/mcp",
server_label="internal",
authorization="Bearer sk-your-token-here"
)
Očekivani format u potpunosti ovisi o ciljanom poslužitelju jer authorization prihvaća bilo koji niz: MCP poslužitelj ga validira, a ne xAI. Tri oblika pokrivaju gotovo sve slučajeve na koje ćeš naići.
- Bearer token:
"Bearer sk-xxxx"— najčešći, koristi ga većina REST API-ja - API ključ:
"ApiKey your-key"— neke usluge koriste prilagođeni prefiks - Basic auth:
"Basic base64(user:password)"— osnovna autentifikacija kodirana u base64
Budući da ovaj token putuje sa svakim zahtjevom, rukovanje njime zahtijeva oprez. Nikada ga nemoj hardkodirati u svoj izvorni kod: tajna zapisana u datoteci pod nadzorom verzija na kraju završi u repozitoriju, zapisniku (logu) ili snimci zaslona. Uvijek koristi varijablu okruženja. Ako poslužitelj dopušta, daj prednost tokena s ograničenim opsegom (scoped token) koji otvara samo alate koji su ti stvarno potrebni — ovo je strana poslužitelja koja odgovara ograničenju allowed_tool_names. I planiraj redovitu rotaciju, posebno u proizvodnji, gdje je vječni token token koji će na kraju curiti.
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 odgovara na pitanje “tko si ti”. Mnogim poslužiteljima trebaju dodatni odgovori: za koju organizaciju, u kojem okruženju, s kojom verzijom API-ja. Te informacije prolaze putem parametra headers, ili extra_headers ovisno o SDK-u.
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"
}
)
Najčešći slučaj su multi-tenant platforme gdje ista krajnja točka (endpoint) služi više klijenata i oslanja se na zaglavlje za usmjeravanje zahtjeva na prave podatke. Zatim slijedi verzioniranje API-ja, sa zaglavljem poput "X-API-Version": "2024-01" koje fiksira određenu verziju i štiti te od promjena na poslužitelju. Neki sustavi također očekuju metapodatke za praćenje — ID sesije, ID agenta — kako bi se pratio izvor poziva, ili zaglavlja za ograničavanje stope (rate limiting) koja određuju primijenjeni tarifni plan.
Naziv parametra varira ovisno o sučelju koje koristiš. Izvorni xAI SDK u većini slučajeva koristi headers; Responses API u OpenAI formatu može zahtijevati extra_headers kako bi se izbjegao bilo kakav sukob sa zaglavljima koja ovaj SDK automatski upravlja za sebe. Ponašanje je, međutim, potpuno isto: zaglavlja se dodaju svakom zahtjevu prema MCP poslužitelju. Ako tvoji zahtjevi odlaze bez tvojih zaglavlja, prvo provjeri naziv ovog parametra prije nego što potražiš drugdje.
Potpuna produkcijska konfiguracija
Evo kako se ovi parametri spajaju s onima iz prethodnih lekcija, u realističnom slučaju internog poslužitelja.
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"]
)
]
Ova konfiguracija spaja se na interni MCP poslužitelj putem HTTPS-a, autentificira se s Bearer tokenom pohranjenim u varijabli okruženja, šalje ID organizacije u zaglavlju i ograničava pristup na tri operacije čitanja. Imaj na umu da svaki redak zaključava drugačiji aspekt: enkripcija štiti prijenos, token dokazuje identitet, zaglavlje definira opseg podataka, a popis dopuštenih (allowlist) ograničava potencijalnu štetu. Nijedan od ovih slojeva ne zamjenjuje druge.
Ključne točke
authorizationšalje pristupni token na MCP poslužitelj putem HTTP zaglavlja Authorization- Uvijek pohrani svoje tokene u varijable okruženja, nikada hardkodirane u kodu
headers/extra_headersdodaju dodatna HTTP zaglavlja svakom zahtjevu- Zaglavlja služe za identifikaciju multi-tenant sustava, verzioniranje API-ja i praćenje
- Kombiniraj autentifikaciju i ograničavanje alata za maksimalnu sigurnost