Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Overovanie totožnosti a hlavičky

Lekcia 6 z 12 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Preukáž sa, kto volá
  2. Parameter authorization
  3. headers a extra_headers
  4. Kompletná produkčná konfigurácia
  5. Kľúčové poznatky

Preukáž sa, kto volá

DeepWiki a ďalšie verejné servery MCP akceptujú akéhokoľvek volajúceho, čo zodpovedá ich účelu. Akonáhle však vystavíš svoje vlastné nástroje, situácia sa mení: bez overenia totožnosti môže ktokoľvek, kto uhádne URL, dopytovať tvoje CRM alebo spúšťať tvoje procesy. xAI poskytuje dva parametre na riešenie tejto situácie – authorization pre prístupový token a headers alebo extra_headers pre všetko ostatné.

Parameter authorization

Tento parameter odosiela overovací token na server MCP. Konkrétne sa reťazec, ktorý poskytneš, vloží tak, ako je, do HTTP hlavičky Authorization pri každej požiadavke odoslanej na tento server.

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

Očakávaný formát závisí výlučne od cieľového servera, pretože authorization akceptuje akýkoľvek reťazec: validuje ho server MCP, nie xAI. Tri formy pokrývajú takmer všetky prípady, s ktorými sa stretneš.

  • Bearer token: "Bearer sk-xxxx" – najbežnejší, používaný väčšinou REST API
  • API kľúč: "ApiKey your-key" – niektoré služby používajú vlastnú predponu
  • Basic auth: "Basic base64(user:password)" – základné overenie zakódované v base64

Keďže tento token putuje s každou požiadavkou, jeho správa si vyžaduje opatrnosť. Nikdy ho neukladaj natvrdo do zdrojového kódu: tajomstvo zapísané vo verzionovanom súbore sa časom nevyhnutne ocitne v repozitári, logu alebo na snímke obrazovky. Vždy používaj premennú prostredia. Ak to server umožňuje, uprednostni token s obmedzeným rozsahom (scoped token), ktorý otvára iba nástroje, ktoré skutočne potrebuješ – toto je serverová protiváha obmedzenia allowed_tool_names. A naplánuj si pravidelnú rotáciu, najmä v produkcii, kde je večný token token, ktorý sa časom určite unikne.

import os

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

headers a extra_headers

Token odpovedá na otázku „kto si“. Mnohé servery potrebujú ďalšie odpovede: pre ktorú organizáciu, v ktorom prostredí, s ktorou verziou API. Tieto informácie sa odovzdávajú prostredníctvom parametra headers alebo extra_headers, v závislosti od použitého 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"
    }
)

Najbežnejším prípadom sú multi-tenant platformy, kde rovnaký koncový bod obsluhuje viacerých klientov a na smerovanie požiadavky k správnym dátam sa spolieha na hlavičku. Ďalej nasleduje verzionovanie API s hlavičkou ako "X-API-Version": "2024-01", ktorá pripne konkrétnu verziu a chráni ťa pred zmenami na serveri. Niektoré systémy tiež očakávajú metadáta na sledovanie – ID relácie, ID agenta – na vystopovanie pôvodu volaní, alebo hlavičky na obmedzenie rýchlosti (rate limiting), ktoré určujú uplatňovaný billing plán.

Názov parametra sa líši v závislosti od rozhrania, ktoré používaš. Natívne xAI SDK vo väčšine prípadov používa headers; Responses API vo formáte OpenAI môže vyžadovať extra_headers, aby sa predišlo kolízii s hlavičkami, ktoré toto SDK spravuje automaticky samo pre seba. Správanie je však úplne rovnaké: hlavičky sa pridávajú ku každej požiadavke na server MCP. Ak tvoje požiadavky odchádzajú bez tvojich hlavičiek, skontroluj najprv názov tohto parametra, než budeš hľadať inde.

Kompletná produkčná konfigurácia

Tu je ukážka, ako sa tieto parametre spájajú s tými z predchádzajúcich lekcií v realistickom prípade interného servera.

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

Táto konfigurácia sa pripája k internému serveru MCP cez HTTPS, overuje sa pomocou Bearer tokenu uloženého v premennej prostredia, odosiela ID organizácie v hlavičke a obmedzuje prístup na tri operácie čítania. Všimni si, že každý riadok uzamyká iný aspekt: šifrovanie chráni prenos, token preukazuje totožnosť, hlavička definuje rozsah dát a allowlist obmedzuje potenciálne škody. Žiadna z týchto vrstiev nenahrádza tie ostatné.

Kľúčové poznatky

  • authorization odosiela prístupový token na server MCP prostredníctvom HTTP hlavičky Authorization
  • Tvoje tokeny vždy ukladaj do premenných prostredia, nikdy ich neukladaj natvrdo do kódu
  • headers / extra_headers pridávajú extra HTTP hlavičky ku každej požiadavke
  • Hlavičky slúžia na identifikáciu v multi-tenant prostrediach, verzionovanie API a sledovanie
  • Kombinuj overenie totožnosti a obmedzenie nástrojov pre maximálnu bezpečnosť