Salt la conținutul principal
Română— Alege o limbă
Meniu

Recapitulare și exerciții practice

Lecția 12 din 12 Actualizată 29 iulie 2026 Dezvoltator
Pe această pagină
  1. Ce am parcurs
  2. Cei șase parametri într-o privire
  3. Verificări înainte de trecerea în producție
  4. Primul dumneavoastră agent, în trei pași
  5. Ce rămâne valabil după acest curs
  6. Puncte cheie
  7. Testați-vă cunoștințele

Ce am parcurs

Acest curs v-a ghidat de la conceptul Model Context Protocol până la o configurație gata de producție. Dacă trebuie să rețineți un singur lucru, să fie acesta: MCP permite lui Grok să se conecteze la servere de instrumente externe prin HTTPS, descoperind și utilizând automat instrumentele expuse, fără configurare manuală lato sensu client.

Din punct de vedere arhitectural, patru puncte structurează totul. MCP la distanță funcționează exclusiv prin HTTPS, excluzând HTTP simplu, localhost și transportul stdio pentru serverele locale. Sunt suportate două tipuri de transport: HTTP Streaming modern, fără stare, și SSE persistent, iar serverul este cel care dictează opțiunea – dumneavoastră nu alegeți. În final, trei interfețe oferă acces la acest mecanism: SDK-ul nativ xAI (recomandat), API-ul Responses pentru compatibilitate cu OpenAI și API-ul Voice Agent pentru agenți vocali.

Cei șase parametri într-o privire

ParametruObligatoriuFuncție
server_urlDaAdresa HTTPS a serverului MCP
server_labelDaIdentificator unic, prefixează instrumentele
server_descriptionNuDescriere în limbaj natural pentru a ghida Grok
allowed_tool_namesNuListă de instrumente accesibile (allowlist)
authorizationNuToken de autentificare (Bearer, cheie API)
headersNuAntete HTTP suplimentare

Doi obligatorii, patru opționali: aceasta este întreaga suprafață de configurare pentru MCP la distanță. Parametrii opționali nu sunt însă simple facilități de confort. allowed_tool_names gestionează securitatea, iar server_description asigură o selecție precisă atunci când coexistă mai multe servere.

Verificări înainte de trecerea în producție

Trei categorii de controale necesită o verificare explicită. Din punct de vedere al securității, asigurați-vă că URL-urile folosesc HTTPS cu certificate valide, fiecare server intern dispune de token-ul său de autentificare, aceste token-uri sunt stocate în variabile de mediu, instrumentele sunt restricționate la minimul necesar, iar rotația regulată a token-urilor este planificată, nu doar sperată.

Din punct de vedere al configurării, fiecare server trebuie să aibă un server_label unic și descriptiv, iar server_description său trebuie să fie precis și actualizat – o descriere care se referă la o versiune anterioară a serverului induce în eroare modelul. Mențineți numărul total de instrumente la un nivel rezonabil, în jur de zece până la douăzeci per sesiune, și eliminați din configurație serverele ale căror instrumente nu mai sunt apelate de nimeni.

Din punct de vedere al observabilității, planificați incidentele din timp: urmăriți apelurile de instrumente în jurnalele dumneavoastră, configurați alerte pentru erorile de conexiune MCP, monitorizați utilizarea token-urilor per server și măsurați latența apelurilor. Acest din urmă aspect este adesea neglijat, deși constituie primul semnal al degradării unui server.

Primul dumneavoastră agent, în trei pași

Cea mai bună modalitate de a consolida cunoștințele din acest curs este construirea progresivă. Începeți cu un server public, fără autentificare, pentru a valida că mecanismul funcționează cap-la-cap.

from xai_sdk import Client
from xai_sdk.tools import mcp
import os

client = Client(api_key=os.getenv("XAI_API_KEY"))

chat = client.chat.create(
    model="grok-4.20-0309-reasoning",
    tools=[
        mcp(
            server_url="https://mcp.deepwiki.com/mcp",
            server_label="deepwiki"
        )
    ],
)

Testați cu o cerere care forțează modelul să consulte repository-ul, cum ar fi „explică-mi arhitectura proiectului fastapi/fastapi“. Dacă răspunsul sosește și citează structura reală a proiectului, conexiunea dumneavoastră MCP este operațională.

În continuare, adăugați un instrument nativ pentru a vedea cum Grok arbitrează între două surse de naturi diferite. Descrierea serverului devine utilă aici, tocmai pentru că există acum o alegere de făcut.

tools=[
    mcp(
        server_url="https://mcp.deepwiki.com/mcp",
        server_label="deepwiki",
        server_description="Documentation for open-source GitHub projects"
    ),
    {"type": "web_search"},
]

În final, faceți pasul către un server intern, cu autentificare și restricționare a instrumentelor. Acesta este momentul în care tot ce ați văzut despre securitate devine concret.

tools=[
    mcp(server_url="https://mcp.deepwiki.com/mcp", server_label="deepwiki"),
    mcp(
        server_url="https://api.your-server.com/mcp",
        server_label="internal",
        server_description="Company internal data and tools",
        authorization=f"Bearer {os.getenv('INTERNAL_TOKEN')}",
        allowed_tool_names=["search", "get_document"]
    ),
    {"type": "web_search"},
]

Ce rămâne valabil după acest curs

Patru limitări vor însoți toate proiectele dumneavoastră MCP cu Grok. API-ul Responses în format OpenAI nu suportă nici require_approval, nici connector_id, ceea ce vă readuce la SDK-ul nativ ori de câte ori doriți validare umană înainte de execuție. Transportul stdio, și prin urmare serverele MCP locale, rămân inaccesibile: doar HTTPS. Fiecare instrument expus consumă context, făcând minimalismul o decizie arhitecturală, nu o reflexie ulterioară. Iar latența rețelei se cumulează la fiecare apel, astfel încât un agent care înlănțuie mai multe instrumente MCP va răspunde mai lent decât un agent care apelează doar unul.

Niciuna dintre aceste constrângeri nu este un blocaj. Toate sunt ocolite prin alegeri de design făcute în deplină cunoștință de cauză, ceea ce reprezintă exact ceea ce v-a oferit acest curs.

Puncte cheie

  • MCP la distanță conectează Grok la instrumente externe prin HTTPS în câteva linii de configurare
  • Șase parametri sunt suficienți pentru a configura un server MCP (doi obligatorii, patru opționali)
  • Securitatea se bazează pe triada HTTPS + autentificare + restricționare a instrumentelor
  • Începeți cu un server public (DeepWiki), apoi progresați către multi-server autentificat
  • Combinați MCP și instrumente native pentru a crea agenți versatili

Testați-vă cunoștințele

Servere MCP la distanță în API-ul Grok: ați meritat acest recapitulativ.

1. Ce permite suportul MCP din API-ul Grok?

Răspuns: Conectarea serverelor MCP la distanță ca instrumente ale modelului: Grok le apelează capacitățile în timpul generării – sistemele dumneavoastră și ecosistemul MCP devin extensii.

2. Cum declarați un server MCP într-o cerere?

Răspuns: Prin server_url și server_label, cu descriere și listă de instrumente autorizate (allowlist) – plus antetele de autentificare necesare pentru acces.

3. Ce permite configurarea multi-server?

Răspuns: Combinarea mai multor servere MCP într-o singură cerere – fiecare etichetat – și amestecarea lor cu instrumente integrate (web, X): orchestrarea rămâne la nivelul modelului.

4. Ce transporturi sunt suportate?

Răspuns: Streaming HTTP și SSE – transporturile la distanță ale protocolului: serverul se află unde doriți dumneavoastră, iar API-ul se conectează la el.

5. Ce reguli de securitate pentru serverele la distanță?

Răspuns: Autorizați doar instrumentele necesare, autentificați-vă riguros și tratați răspunsurile serverului ca date ce trebuie validate – un server MCP terț este o potențială suprafață de atac.

Declarați, restricționați, autentificați, combinați: MCP la distanță extinde Grok către sistemele dumneavoastră – conform regulilor dumneavoastră.