Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Avtentikacija in glave

Lekcija 6 od 12 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Dokaži, kdo kliče
  2. Parameter authorization
  3. headers in extra_headers
  4. Popolna konfiguracija za proizvodno okolje
  5. Ključne ugotovitve

Dokaži, kdo kliče

DeepWiki in drugi javni strežniki MCP sprejmejo vsakega klicatelja, kar je skladno z njihovim namenom. Ko pa začneš objavljati lastna orodja, se stvari spremenijo: brez avtentikacije lahko vsakdo, ki ugane URL, poizveduje v tvojem CRM-u ali sproži tvoje procese. xAI ponuja dva parametra za rešitev tega problema – authorization za žeton za dostop ter headers ali extra_headers za vse ostalo.

Parameter authorization

Ta parameter pošlje žeton za avtentikacijo strežniku MCP. Natančneje, niz, ki ga navedeš, se dobesedno vstavi v HTTP glavo Authorization vsake zahteve, poslane temu strežniku.

mcp(
    server_url="https://api.example.com/mcp",
    server_label="internal",
    authorization="Bearer sk-your-token-here"
)

Pričakovana oblika je v celoti odvisna od ciljnega strežnika, saj authorization sprejme poljuben niz: veljavnost preveri strežnik MCP, ne xAI. Tri oblike pokrivajo skoraj vse primere, s katerimi se boš srečal.

  • Žeton Bearer: "Bearer sk-xxxx" – najpogostejši, uporablja ga večina API-jev REST
  • Ključ API: "ApiKey your-key" – nekatere storitve uporabljajo prilagojeno predpono
  • Osnovna avtentikacija: "Basic base64(user:password)" – osnovna avtentikacija, kodirana v base64

Ker ta žeton potuje z vsako zahtevo, ravnanje z njim zahteva previdnost. Nikoli ga ne vgrajuj neposredno v izvorno kodo: skrivnost, zapisana v datoteki pod nadzorom različic, se prej ali slej znajde v repozitoriju, dnevniku ali posnetku zaslona. Vedno uporabi spremenljivko okolja. Če strežnik to omogoča, raje uporabi žeton z omejenim obsegom, ki odpira le orodja, ki jih dejansko potrebuješ – to je strežniški ustreznik omejitve allowed_tool_names. Načrtuj tudi redno menjavo žetonov, še posebej v proizvodnem okolju, kjer je večen žeton žeton, ki bo nekoč uhajal.

import os

mcp(
    server_url="https://api.example.com/mcp",
    server_label="internal",
    authorization=f"Bearer {os.getenv('MCP_SERVER_TOKEN')}"
)

headers in extra_headers

Žeton odgovori na vprašanje „kdo si”. Mnogi strežniki potrebujejo dodatne odgovore: za katero organizacijo, v katerem okolju, s katero različico API-ja. Te informacije se prenesejo prek parametra headers ali extra_headers, odvisno od SDK-ja.

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"
    }
)

Najpogostejši primer so večnajemniške platforme, kjer ista končna točka služi več strankam in se za usmerjanje zahteve do pravih podatkov zanaša na glavo. Sledi različičenje API-ja z glavo, kot je "X-API-Version": "2024-01", ki določi specifično različico in te zaščiti pred spremembami na strežniku. Nekateri sistemi pričakujejo tudi metapodatke za sledenje – ID seje, ID agenta – za sledenje izvoru klicev, ali glave za omejevanje hitrosti, ki določajo uporabljeni obračunski načrt.

Ime parametra se razlikuje glede na vmesnik, ki ga uporabljaš. Izvirni SDK xAI v večini primerov uporablja headers; API za odzive v formatu OpenAI lahko zahteva extra_headers, da se izogneš trkom z glavami, ki jih ta SDK samodejno upravlja zase. Vedenje pa je popolnoma enako: glave se dodajo vsaki zahtevi, poslani strežniku MCP. Če tvoje zahteve odhajajo brez tvojih glav, najprej preveri ime tega parametra, preden iščeš drugje.

Popolna konfiguracija za proizvodno okolje

Tukaj je prikazano, kako se ti parametri združijo s tistimi iz prejšnjih lekcij v realističnem primeru notranjega strežnika.

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"]
    )
]

Ta konfiguracija se poveže z notranjim strežnikom MCP prek HTTPS, se avtentificira z žetonom Bearer, shranjenim v spremenljivki okolja, pošlje ID organizacije v glavi in omeji dostop do treh operacij branja. Upoštevaj, da vsaka vrstica zaklene drug vidik: šifriranje ščiti prenos, žeton dokazuje identiteto, glava določa obseg podatkov, seznam dovoljenih imen pa omeji potencialno škodo. Nobena od teh plasti ne nadomešča drugih.

Ključne ugotovitve

  • authorization pošlje žeton za dostop strežniku MCP prek HTTP glave Authorization
  • Svoje žetone vedno shrani v spremenljivke okolja, nikoli ne vgrajuj kode neposredno v kodo
  • headers / extra_headers dodajo dodatne HTTP glave vsaki zahtevi
  • Glave služijo za identifikacijo večnajemnikov, različičenje API-ja in sledenje
  • Združi avtentikacijo in omejevanje orodij za največjo varnost