Rikap u Prattika Manwali
F'din il-paġna
Xa Għatina Kopertura
Dan il-kors ħadek mill-kunċett tal-Model Context Protocol sa konfigurazzjoni lest għall-produzzjoni. Jekk trid tiftakar ħaġa waħda biss, ħa tkun din: l-MCP jħalli lil Grok jikkonnettja ma’ servers ta’ għodod esterni permezz ta’ HTTPS, jiskopri u jużaw awtomatikament l-għodod esposti mingħajr konfigurazzjoni manwali fuq in-naħa tal-klijent.
Arkitetturalment, erba’ punti jistrutturaw kull ħaġa oħra. L-MCP remot jaħdem esklużivament fuq HTTPS, u jeskludi HTTP sempliċi, localhost, u t-trasport stdio għas-servers lokali. Żewġ tipi ta’ trasport huma appoġġjati: l-Streaming HTTP mingħajr stat modern u l-SSE persistenti, u s-server jiddetta liema wieħed jintuża—int ma tagħżilx. Fl-aħħar nett, tliet interfaċċi jipprovdu aċċess għal dan il-mekkaniżmu: l-SDK nativ ta’ xAI (rakkomandat), l-API tar-Risposti għall-kompatibbiltà ma’ OpenAI, u l-API tal-Aġent Vokali għall-aġenti vokali.
Is-Sitt Parametri f’Daqqa
| Parametru | Meħtieġ | Funzjoni |
|---|---|---|
server_url | Iva | Indirizz HTTPS tas-server MCP |
server_label | Iva | Identifikatur uniku, jippreċedi l-għodod |
server_description | Le | Deskrizzjoni b’lingwa naturali biex tiggwida lil Grok |
allowed_tool_names | Le | Lista bajda ta’ għodod aċċessibbli |
authorization | Le | Token tal-awtentikazzjoni (Bearer, API key) |
headers | Le | Headers HTTP addizzjonali |
Tnejn meħtieġa, erba’ opzjonali: dik hija s-superfiċje kollha tal-konfigurazzjoni għall-MCP remot. Madankollu, dawk opzjonali mhumiex sempliċiment karatteristiċi ta’ kumdità. L-allowed_tool_names jimmaniġġja s-sigurtà tiegħek, u s-server_description jiżgura għażla preċiża meta jkunu jeżistu servers multipli flimkien.
Verifiki Qabel ma Tmur fil-Produzzjoni
Tliet kategoriji ta’ kontrolli jeħtieġu verifika espliċita. Fuq in-naħa tas-sigurtà, żgura li l-URLs jużaw HTTPS b’ċertifikati validi, kull server intern għandu t-token tal-awtentikazzjoni tiegħu, dawn it-tokens jgħixu f’varjabbli tal-ambjent, l-għodod huma ristretti għall-minimu meħtieġ, u r-rotazzjoni regolari tat-tokens hija ppjanata minflok tittama biss.
Fuq in-naħa tal-konfigurazzjoni, kull server irid ikollu server_label uniku u deskrittiv, u d-server_description tiegħu trid tkun preċiża u aġġornata—deskrizzjoni li tiddeskrivi verżjoni preċedenti tas-server tqarraq lill-mudell. Żomm in-numru totali ta’ għodod raġonevoli, madwar għaxra sa għoxrin kull sessjoni, u neħħi s-servers mill-konfigurazzjoni li l-għodod tagħhom m’għadx isejjaħhom ħadd.
Fuq in-naħa tal-osservabbiltà, ippjana għall-inċidenti minn qabel: sejħiet tal-għodod traċċati fil-logs tiegħek, twissijiet dwar żbalji fil-konnessjoni tal-MCP, traċċar tal-użu tat-token kull server, u kejl tal-latenza tas-sejħiet. Dan tal-aħħar spiss jiġi nneglett għalkemm jikkostitwixxi l-ewwel sinjal ta’ server li qed jiddeterjora.
L-Ewwel Aġent Tiegħek, fi Tliet Passi
L-aħjar mod biex tissolidifika dan il-kors huwa li tibni b’mod progressiv. Ibda b’server pubbliku, mingħajr awtentikazzjoni, biex tivvalida li l-mekkaniżmi jaħdmu minn tarf għal tarf.
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"
)
],
)
Ittestja b’talba li tifforza lill-mudell jikkonsulta r-repożitorju, bħal “ispjegali l-arkitettura tal-proġett fastapi/fastapi”. Jekk ir-risposta tasal u tiċċita l-istruttura attwali tal-proġett, il-konnessjoni MCP tiegħek tkun operattiva.
Sussegwentement, żid għodda nativa biex tara kif Grok jagħmel arbitraġġ bejn żewġ sorsi ta’ naturi differenti. Id-deskrizzjoni tas-server issir utli hawnhekk, preċiżament għax issa hemm għażla li trid issir.
tools=[
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki",
server_description="Dokumentazzjoni għal proġetti open-source fuq GitHub"
),
{"type": "web_search"},
]
Fl-aħħar nett, agħmel il-pass lejn server intern, b’awtentikazzjoni u restrizzjoni tal-għodod. Dan huwa l-pass fejn kull ma rajt dwar is-sigurtà isir konkret.
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="Data u għodod interni tal-kumpanija",
authorization=f"Bearer {os.getenv('INTERNAL_TOKEN')}",
allowed_tool_names=["search", "get_document"]
),
{"type": "web_search"},
]
Xa Jibqa’ Veru Wara Dan il-Kors
Erba’ limitazzjonijiet se jakkumpanjaw il-proġetti MCP kollha tiegħek ma’ Grok. L-API tar-Risposti f’format OpenAI ma tappoġġjax require_approval u lanqas connector_id, li jerġgħu jġibuk lura għall-SDK nativ kull meta trid validazzjoni umana qabel l-eżekuzzjoni. It-trasport Stdio, u għalhekk is-servers MCP lokali, jibqgħu barra mill-portata: biss HTTPS. Kull għodda esposta tikkonsma kuntest, u tagħmel il-minimaliżmu deċiżjoni arkitetturali minflok ħsieb sussegwenti. U l-latenza tan-netwerk tiżdied ma’ kull sejħa, allura aġent li jgħaqqad diversi għodod MCP se jirrispondi aktar bil-mod minn aġent li jsejjaħ waħda biss.
L-ebda waħda minn dawn ir-restrizzjonijiet mhija ostakolu. Kollha jiġu evitati permezz ta’ għażliet tad-disinn magħmula b’għarfien sħiħ, li huwa preċiżament dak li dan il-kors tahlek.
Punti Ewlenin
- L-MCP remot jikkonnettja lil Grok ma’ għodod esterni permezz ta’ HTTPS f’ftit linji ta’ konfigurazzjoni
- Sitt parametri biżżejjed biex tikkonfigura server MCP (tnejn meħtieġa, erba’ opzjonali)
- Is-sigurtà tiddependi mit-trijangolu ta’ HTTPS + awtentikazzjoni + restrizzjoni tal-għodod
- Ibda b’server pubbliku (DeepWiki) imbagħad ipprogressa għal multi-server awtentikat
- Għaqqad l-MCP u għodod nattiv biex toħloq aġenti versatili
Ittestja l-Għarfien Tiegħek
Servers MCP remoti fl-API ta’ Grok: qiegħed tistħoqqlek dan ir-rikap.
1. X'jippermetti l-appoġġ tal-MCP fl-API ta' Grok?
Tweġiba: Ikkonnettja servers MCP remoti bħala għodod tal-mudell: Grok isejjaħ il-kapaċitajiet tagħhom waqt il-ġenerazzjoni—is-sistemi tiegħek u l-ekosistema MCP isiru estensjonijiet.
2. Kif tiddikjara server MCP f'talba?
Tweġiba: Permezz ta’ server_url u server_label, bid-deskrizzjoni u l-lista bajda tal-għodod awtorizzati—u l-headers tal-awtentikazzjoni meħtieġa għall-aċċess.
3. X'jippermetti l-konfigurazzjoni multi-server?
Tweġiba: Tgħaqqad servers MCP multipli f’talba waħda—kull wieħed imlaqqam—u tħallathom ma’ għodod integrati (web, X): l-orkestrazzjoni tibqa’ mal-mudell.
4. Liema trasporti huma appoġġjati?
Tweġiba: Streaming HTTP u SSE—it-trasporti remoti tal-protokoll: is-server jgħix fejn trid int, l-API tikkonnettja miegħu.
5. Liema regoli ta' sigurtà għas-servers remoti?
Tweġiba: Awtorizza biss l-għodod meħtieġa, awtentika b’mod serju, u ttratta r-risposti tas-server bħala data li trid tiġi vvalidata—server MCP ta’ parti terza huwa wiċċ potenzjali ta’ attakk.
Iddikjara, irrestrinġi, awtentika, għaqqad: l-MCP remot jestendi lil Grok għas-sistemi tiegħek—taħt ir-regoli tiegħek.