Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Autentimine ja päised

Õppetund 6 / 12 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Tõesta, kes helistab
  2. Parameeter authorization
  3. headers ja extra_headers
  4. Täielik tootmiskonfiguratsioon
  5. Peamised punktid

Tõesta, kes helistab

DeepWiki ja muud avalikud MCP-serverid aktsepteerivad kõiki kutsujaid, mis vastab nende eesmärgile. Niipea kui avaldad oma tööriistu, muutub olukord: ilma autentimiseta saab igaüks, kes URL-i ära arvab, pärida sinu CRM-i andmeid või käivitada sinu protsesse. xAI pakub selle lahendamiseks kahte parameetrit: authorization juurdepääsutokeni jaoks ning headers või extra_headers kõige muu jaoks.

Parameeter authorization

See saadab autentimistokeni MCP-serverisse. Täpsemalt öeldes lisatakse sinu poolt määratud string muutmata kujul iga sellele serverile saadetava päringu HTTP-päisesse Authorization.

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

Oodatav vorming sõltub täielikult sihtserverist, kuna authorization aktsepteerib ükskõik millist stringi: tokeni kehtivust kontrollib MCP-server, mitte xAI. Peaaegu kõikidel juhtudel, millega kokku puutud, kehtib üks kolmest vormingust.

  • Bearer token: "Bearer sk-xxxx" — levinuim, mida kasutab enamik REST API-sid
  • API võti: "ApiKey your-key" — mõned teenused kasutavad kohandatud eesliidet
  • Põhiautentimine (Basic auth): "Basic base64(user:password)" — base64-kodeeritud põhiautentimine

Kuna see token saadetakse iga päringuga, nõuab selle haldamine hoolikust. Ära kunagi kodeeri seda otse lähtekoodi: failiversioonis olev saladus satub varem või hiljem hoidlasse, logifaili või ekraanitõmmisele. Kasuta alati keskkonnamuutujat. Kui server seda võimaldab, eelista piiratud õigustega tokenit, mis avab ainult need tööriistad, mida tegelikult vajad – see on serveripoolne vastukaal allowed_tool_names piirangule. Planeeri ka regulaarne uuendamine, eriti tootmiskeskkonnas, kus igavene token on token, mis lõpuks lekib.

import os

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

headers ja extra_headers

Token vastab küsimusele „kes sa oled“. Paljud serverid vajavad lisaks veel muud teavet: millise organisatsiooni jaoks, millises keskkonnas, millise API-versiooniga. See teave edastatakse parameetri headers või sõltuvalt SDK-st extra_headers kaudu.

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

Levinuim juhtum on mitme üürnikuga platvormid (multi-tenant), kus sama lõpp-punkt teenindab mitut klienti ja kasutab päist päringu õigete andmete juurde suunamiseks. Järgmisena tuleb API versioonihaldus, kasutades päist nagu "X-API-Version": "2024-01", mis lukustab kindla versiooni ja kaitseb sind serverimuudatuste eest. Mõned süsteemid ootavad ka jälgimismetadaatat – sessiooni ID, agendi ID – et tuvastada päringute allikat, või kiiruse piiramise päiseid, mis määravad rakendatava arveldusplaani.

Parameetri nimi varieerub sõltuvalt kasutatavast liidesest. Native xAI SDK kasutab enamasti headers; OpenAI-vormingus Responses API võib nõuda extra_headers, et vältida kokkupõrkeid päistega, mida see SDK ise automaatselt haldab. Käitumine on aga täpselt sama: päised lisatakse igale MCP-serverile saadetavale päringule. Kui sinu päringud lahkuvad ilma sinu päisteta, kontrolli esmalt seda parameetri nime, enne kui hakkad mujalt vigu otsima.

Täielik tootmiskonfiguratsioon

Siin on näide, kuidas need parameetrid koos eelmiste tundide omadega reaalses sisemise serveri stsenaariumis kokku pannakse.

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

See konfiguratsioon ühendub sisemise MCP-serveriga üle HTTPS-i, autentib end keskkonnamuutujas hoitava Bearer-tokeniga, saadab päises organisatsiooni ID ja piirab juurdepääsu kolmele lugemisoperatsioonile. Pane tähele, et iga rida lukustab erineva aspekti: krüpteerimine kaitseb edastust, token tõestab identiteeti, päis määratleb andmete ulatuse ja lubatud nimekiri piirab võimalikku kahju. Ükski neist kihtidest ei asenda teisi.

Peamised punktid

  • authorization saadab juurdepääsutokeni MCP-serverile HTTP-päise Authorization kaudu
  • Hoia oma tokeneid alati keskkonnamuutujates, mitte otse koodis
  • headers / extra_headers lisavad igale päringule täiendavaid HTTP-päiseid
  • Päiseid kasutatakse mitme üürnikuga süsteemides identifitseerimiseks, API versioonihalduseks ja jälgimiseks
  • Kombineeri autentimine ja tööriistade piiramine maksimaalse turvalisuse tagamiseks