Kopsavilkums un praktiskie uzdevumi
Šajā lapā
Ko esam apguvuši
Šis kurss tevi aizveda no Model Context Protocol koncepta līdz ražošanai gatavai konfigurācijai. Ja atceries tikai vienu lietu, lai tā ir šī: MCP ļauj Grok savienoties ar ārējiem rīku serveriem, izmantojot HTTPS, automātiski atklājot un izmantojot pieejamos rīkus bez manuālas klienta puses konfigurācijas.
Arhitektūras ziņā viss pārējais balstās uz četriem punktiem. Attālināts MCP darbojas tikai caur HTTPS, izslēdzot parasto HTTP, localhost un stdio transportu lokāliem serveriem. Tiek atbalstīti divi transporta veidi: mūsdienīgs bezstāvokļa plūsmas HTTP (Streaming HTTP) un noturīgs SSE, un serveris nosaka, kurš no tiem tiks izmantots — tu to neizvēlies. Visbeidzot, trīs saskarnes nodrošina piekļuvi šim mehānismam: natīvais xAI SDK (ieteicams), Responses API saderībai ar OpenAI un Voice Agent API balss aģentiem.
Seši parametri īsumā
| Parametrs | Obligāts | Funkcija |
|---|---|---|
server_url | Jā | MCP servera HTTPS adrese |
server_label | Jā | Unikāls identifikators, pievieno prefiksu rīkiem |
server_description | Nē | Dabiskās valodas apraksts Grok vadībai |
allowed_tool_names | Nē | Pieejamo rīku atļauto nosaukumu saraksts |
authorization | Nē | Autentifikācijas tokens (Bearer, API atslēga) |
headers | Nē | Papildu HTTP galvenes |
Divi obligāti, četri opcionāli: tāda ir visa attālinātā MCP konfigurācijas virsma. Tomēr opcionālie parametri nav tikai ērtības funkcijas. allowed_tool_names nodrošina tavu drošību, bet server_description garantē precīzu izvēli, kad līdzās pastāv vairāki serveri.
Pārbaudes pirms došanās ražošanā
Trīs kontroles kategorijas prasa tiešu pārbaudi. Drošības aspektā pārliecinies, ka URL izmanto HTTPS ar derīgiem sertifikātiem, katram iekšējam serverim ir savs autentifikācijas tokens, šie tokeni glabājas vides mainīgajos, rīki ir ierobežoti līdz nepieciešamajam minimumam un regulāra tokenu rotācija ir ieplānota, nevis cerēta.
Konfigurācijas aspektā katram serverim jābūt unikālam, aprakstošam server_label, un tā server_description jābūt precīzam un aktuālam — apraksts, kas attiecas uz vecāku servera versiju, maldina modeli. Uzturi kopējo rīku skaitu saprātīgās robežās, aptuveni desmit līdz divdesmit vienā sesijā, un no konfigurācijas noņem serverus, kuru rīkus vairs neviens neizsauc.
Novērojamības aspektā iepriekš ieplāno incidentus: rīku izsaukumu izsekošana žurnālos, brīdinājumi par MCP savienojuma kļūdām, tokena lietojuma izsekošana pa serveriem un izsaukumu latentces mērīšana. Pēdējais bieži tiek atstāts novārtā, lai gan tas ir pirmais signāls par servera pasliktināšanos.
Tavs pirmais aģents trīs soļos
Labākais veids, kā nostiprināt šī kursa zināšanas, ir pakāpeniska veidošana. Sāc ar publisku serveri bez autentifikācijas, lai pārbaudītu, vai mehānisms darbojas no sākuma līdz beigām.
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"
)
],
)
Veic testu ar pieprasījumu, kas faktiski liek modelim konsultēties ar repozitoriju, piemēram, “paskaidro man fastapi/fastapi projekta arhitektūru”. Ja atbilde pienāk un citē faktisko projekta struktūru, tavs MCP savienojums ir darbspējīgs.
Tālāk pievieno natīvu rīku, lai redzētu, kā Grok arbitrē starp diviem dažāda rakstura avotiem. Servera apraksts šeit kļūst noderīgs tieši tāpēc, ka tagad ir jāizdara izvēle.
tools=[
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki",
server_description="Atvērtā koda GitHub projektu dokumentācija"
),
{"type": "web_search"},
]
Visbeidzot, sper soli uz iekšēju serveri ar autentifikāciju un rīku ierobežošanu. Šis ir solis, kurā viss, ko esi redzējis par drošību, kļūst konkrēts.
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="Uzņēmuma iekšējie dati un rīki",
authorization=f"Bearer {os.getenv('INTERNAL_TOKEN')}",
allowed_tool_names=["search", "get_document"]
),
{"type": "web_search"},
]
Kas paliek spēkā pēc šī kursa
Četri ierobežojumi pavadīs visus tavus MCP projektus ar Grok. Responses API OpenAI formātā neatbalsta ne require_approval, ne connector_id, kas tevi atgriež pie natīvā SDK ikreiz, kad vēlies cilvēka apstiprinājumu pirms izpildes. Stdio transports un līdz ar to lokālie MCP serveri paliek nepieejami: tikai HTTPS. Katrs eksponētais rīks patērē kontekstu, padarot minimālismu par arhitektūras lēmumu, nevis pēcpārdomu. Un tīkla latentce uzkrājas ar katru izsaukumu, tāpēc aģents, kas virknē vairākus MCP rīkus, atbildēs lēnāk nekā aģents, kas izsauc tikai vienu.
Neviens no šiem ierobežojumiem nav šķērslis. Visus tos var apiet ar apzinātiem dizaina lēmumiem, kas tieši ir tas, ko šis kurss tev ir devis.
Galvenās atziņas
- Attālināts MCP savieno Grok ar ārējiem rīkiem caur HTTPS, izmantojot dažas konfigurācijas rindas
- MCP servera konfigurēšanai pietiek ar sešiem parametriem (divi obligāti, četri opcionāli)
- Drošība balstās uz triādi: HTTPS + autentifikācija + rīku ierobežošana
- Sāc ar publisku serveri (DeepWiki), tad pārej uz autentificētu vairāku serveru vidi
- Apvieno MCP un natīvos rīkus, lai izveidotu daudzpusīgus aģentus
Pārbaudi savas zināšanas
Attālināti MCP serveri Grok API: tu esi pelnījis šo kopsavilkumu.
1. Ko ļauj Grok API MCP atbalsts?
Atbilde: Pievienot attālinātus MCP serverus kā modeļa rīkus: Grok izsauc to spējas ģenerēšanas laikā — tavas sistēmas un MCP ekosistēma kļūst par paplašinājumiem.
2. Kā pieprasījumā deklarē MCP serveri?
Atbilde: Izmantojot server_url un server_label, kopā ar aprakstu un atļauto rīku sarakstu — kā arī autentifikācijas galvenēm, kas nepieciešamas piekļuvei.
3. Ko ļauj vairāku serveru konfigurācija?
Atbilde: Apvienot vairākus MCP serverus vienā pieprasījumā — katru ar savu etiķeti — un sajaukt tos ar iebūvētiem rīkiem (web, X): orchestrēšana paliek modeļa ziņā.
4. Kuri transporta veidi tiek atbalstīti?
Atbilde: Plūsmas HTTP un SSE — protokola attālinātie transporti: serveris atrodas tur, kur tu vēlies, API tam pieslēdzas.
5. Kādi drošības noteikumi attiecas uz attālinātiem serveriem?
Atbilde: Atļauj tikai nepieciešamos rīkus, veic nopietnu autentifikāciju un uztveri servera atbildes kā datus, kas jāvalidē — trešās puses MCP serveris ir potenciāls uzbrukuma virsmas punkts.
Deklarē, ierobežo, autentificē, apvieno: attālināts MCP paplašina Grok līdz tavām sistēmām — saskaņā ar taviem noteikumiem.