Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Autentifikācija un galvenes

Nodarbība 6 no 12 Atjaunota 2026. gada 29. jūlijs Programmētājs
Šajā lapā
  1. Pierādi, kas veic izsaukumu
  2. Parametrs authorization
  3. headers un extra_headers
  4. Pilnīga ražošanas konfigurācija
  5. Galvenās atziņas

Pierādi, kas veic izsaukumu

DeepWiki un citi publiski MCP serveri pieņem jebkuru izsaukumu, kas atbilst to mērķim. Tiklīdz tu eksponē savus rīkus, situācija mainās: bez autentifikācijas ikviens, kurš uzmin URL, var jautāt tavu CRM vai aktivizēt tavus procesus. xAI piedāvā divus parametrus šī jautājuma risināšanai — authorization piekļuves pilnvarai un headers vai extra_headers visam pārējam.

Parametrs authorization

Tas nosūta autentifikācijas pilnvaru MCP serverim. Konkrētāk, virkne, ko tu norādi, tiek ievietota tieši tāda, kāda tā ir, HTTP Authorization galvenē katrā pieprasījumā, kas nosūtīts šim serverim.

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

Sagaidāmais formāts ir pilnībā atkarīgs no mērķa servera, jo authorization pieņem jebkuru virkni: to validē MCP serveris, nevis xAI. Trīs formas aptver gandrīz visus gadījumus, ar kuriem tu sastapsies.

  • Bearer pilnvara: "Bearer sk-xxxx" — visizplatītākā, ko izmanto lielākā daļa REST API
  • API atslēga: "ApiKey your-key" — daži servisi izmanto pielāgotu prefiksu
  • Bāzes autentifikācija: "Basic base64(user:password)" — bāzes autentifikācija, kodēta base64 formātā

Tā kā šī pilnvara tiek nosūtīta ar katru pieprasījumu, tās apstrāde prasa rūpību. Nekad neiekodē to tieši savā pirmkodā: noslēpums, kas ierakstīts versijā kontrolētā failā, agrāk vai vēlāk nonāks repozitorijā, žurnālā vai ekrānuzņēmumā. Vienmēr izmanto vides mainīgo. Ja serveris to atļauj, dod priekšroku ierobežotas darbības pilnvarai, kas atver tikai tos rīkus, kas tev patiešām nepieciešami — tas ir servera puses līdzinieks allowed_tool_names ierobežojumam. Un plāno regulāru rotāciju, it īpaši ražošanas vidē, kur mūžīga pilnvara ir pilnvara, kas galu galā tiks nopludināta.

import os

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

headers un extra_headers

Pilnvara atbild uz jautājumu „kas tu esi”. Daudziem serveriem ir vajadzīgas papildu atbildes: kurai organizācijai, kurā vidē, ar kuru API versiju. Šī informācija tiek nodota, izmantojot parametru headers vai extra_headers atkarībā no 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"
    }
)

Visizplatītākais gadījums ir daudznomnieku platformas, kur viens un tas pats galapunkts apkalpo vairākus klientus un izmanto galveni, lai maršrutētu pieprasījumu uz pareizajiem datiem. Nākamais ir API versiju kontrole, izmantojot galveni, piemēram, "X-API-Version": "2024-01", kas piesaista konkrētu versiju un pasargā tevi no servera izmaiņām. Dažas sistēmas sagaida arī izsekošanas metadatus — sesijas ID, aģenta ID — lai izsekotu izsaukumu izcelsmi, vai ātruma ierobežošanas galvenes, kas nosaka piemēroto tarifu plānu.

Parametra nosaukums mainās atkarībā no saskarnes, ko izmanto. Natīvais xAI SDK vairumā gadījumu izmanto headers; OpenAI formāta Responses API var prasīt extra_headers, lai izvairītos no sadursmēm ar galvenēm, ko šis SDK pārvalda automātiski pats sev. Darbība tomēr ir tieši tāda pati: galvenes tiek pievienotas katram pieprasījumam MCP serverim. Ja tavi pieprasījumi tiek nosūtīti bez tavām galvenēm, vispirms pārbaudi šī parametra nosaukumu, pirms meklē citur.

Pilnīga ražošanas konfigurācija

Lūk, kā šie parametri tiek apvienoti ar tiem no iepriekšējām nodarbībām reālistiskā iekšējā servera gadījumā.

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

Šī konfigurācija savienojas ar iekšējo MCP serveri, izmantojot HTTPS, autentificējas ar Bearer pilnvaru, kas glabāta vides mainīgajā, nosūta organizācijas ID galvenē un ierobežo piekļuvi trim lasīšanas operācijām. Ņem vērā, ka katra rinda bloķē citu aspektu: šifrēšana aizsargā pārsūtīšanu, pilnvara pierāda identitāti, galvene definē datu apjomu, un atļauto saraksts ierobežo potenciālos zaudējumus. Neviens no šiem slāņiem neaizstāj pārējos.

Galvenās atziņas

  • authorization nosūta piekļuves pilnvaru MCP serverim, izmantojot HTTP Authorization galveni
  • Vienmēr glabā savas pilnvaras vides mainīgajos, nekad neiekodē tās kodā
  • headers / extra_headers pievieno papildu HTTP galvenes katram pieprasījumam
  • Galvenes kalpo daudznomnieku identifikācijai, API versiju kontrolei un izsekošanai
  • Apvieno autentifikāciju un rīku ierobežošanu, lai nodrošinātu maksimālu drošību