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

Kokkuvõte ja praktiline harjutus

Õppetund 12 / 12 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Mida oleme käsitlenud
  2. Kuus parameetrit ühe pilguga
  3. Kontrollid enne tootmisse viimist
  4. Sinu esimene agent kolmes sammus
  5. Mis jääb pärast seda kursust kehtima
  6. Peamised punktid
  7. Testi oma teadmisi

Mida oleme käsitlenud

See kursus viis sind Model Context Protocoli kontseptsioonist tootmiskeskkonda valmis konfiguratsioonini. Kui peaksid meelde jätma ainult ühe asja, olgu see see: MCP võimaldab Grokil ühenduda väliste tööriistaserveritega HTTPS-i kaudu, avastades ja kasutades automaatselt avaldatud tööriistu ilma kliendipoolse käsitsi seadistamiseta.

Arhitektuuriliselt toetub kõik neljale põhipunktile. Kauge MCP töötab eranditult üle HTTPS-i, välistades tavalise HTTP, localhosti ja lokaalsete serverite stdio-transpordi. Toetatud on kaks transporti: kaasaegne olekuvaba voogedastusega HTTP (Streaming HTTP) ja püsiv SSE, kusjuures server määrab, kumb neist kehtib – sina ei vali. Lõpuks pakuvad sellele mehhanismile juurdepääsu kolm liidest: emakeelne xAI SDK (soovitatav), Responses API OpenAI ühilduvuse jaoks ja Voice Agent API häälagentide jaoks.

Kuus parameetrit ühe pilguga

ParameeterKohustuslikFunktsioon
server_urlJahMCP serveri HTTPS-aadress
server_labelJahUnikaalne identifikaator, lisab tööriistadele eesliite
server_descriptionEiLoomulikus keeles kirjeldus Groki juhendamiseks
allowed_tool_namesEiLubatud tööriistade nimekiri (allowlist)
authorizationEiAutentimistoken (Bearer, API võti)
headersEiTäiendavad HTTP-päised

Kaks kohustuslikku, neli valikulist: see on kauge MCP kogu seadistuspind. Valikulised parameetrid pole pelgalt mugavusfunktsioonid. allowed_tool_names tagab sinu turvalisuse ja server_description tagab täpse valiku olukorras, kus samaaegselt eksisteerib mitu serverit.

Kontrollid enne tootmisse viimist

Kolm kontrollikategooriat vajavad selget kinnitamist. Turvalisuse osas veendu, et URL-id kasutavad kehtivate sertifikaatidega HTTPS-i, igal sisemiselt serveril on oma autentimistoken, need tokenid asuvad keskkonnamuutujates, tööriistad on piiratud vajaliku miinimumini ja tokenite regulaarne rotatsioon on planeeritud, mitte loodetud.

Seadistuse osas peab igal serveril olema unikaalne ja kirjeldav server_label ning selle server_description peab olema täpne ja ajakohane – vanemat serveriversiooni kirjeldav tekst eksitab mudelit. Hoia tööriistade üldarv mõistlikes piirides, umbes kümnest kahekümneni seansi kohta, ja eemalda konfiguratsioonist serverid, mille tööriistu enam keegi ei kasuta.

Jälgitavuse osas planeeri intsidente ette: tööriistakutsed peavad olema logides jälgitavad, MCP ühendusvigade korral peavad töötama hoiatused, tuleb jälgida tokenite kasutust serveriti ja mõõta kutsete latentsust. Viimast sageli eiratakse, kuigi see on esimene signaal serveri jõudluse halvenemisest.

Sinu esimene agent kolmes sammus

Parim viis selle kursuse kinnistamiseks on astmeline ülesehitus. Alusta avalikust serverist ilma autentimiseta, et valideerida mehhanismi toimimist otsast lõpuni.

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

Testi päringuga, mis sunnib mudelit tegelikult repositooriumiga konsulteerima, näiteks: „Selgita mulle fastapi/fastapi projekti arhitektuuri.“ Kui vastus saabub ja viitab tegelikule projekti struktuurile, on sinu MCP ühendus töökorras.

Järgmiseks lisa emakeelne tööriist, et näha, kuidas Grok teeb valiku kahe erineva olemusega allika vahel. Siin muutub serveri kirjeldus kasulikuks just seetõttu, et nüüd tuleb teha valik.

tools=[
    mcp(
        server_url="https://mcp.deepwiki.com/mcp",
        server_label="deepwiki",
        server_description="Avatud lähtekoodiga GitHubi projektide dokumentatsioon"
    ),
    {"type": "web_search"},
]

Lõpuks tee samm sisemise serveri suunas, kasutades autentimist ja tööriistade piiramist. See on etapp, kus kõik seni nähtu turvalisuse kohta muutub konkreetseks.

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="Ettevõtte sisene andmed ja tööriistad",
        authorization=f"Bearer {os.getenv('INTERNAL_TOKEN')}",
        allowed_tool_names=["search", "get_document"]
    ),
    {"type": "web_search"},
]

Mis jääb pärast seda kursust kehtima

Neli piirangut kaasnevad kõigi sinu Groki MCP projektidega. OpenAI vormingus Responses API ei toeta ei require_approval ega connector_id, mis viib sind tagasi emakeelse SDK juurde iga kord, kui soovid enne käivitamist inimkinnitust. Stdio transport ja seega ka lokaalsed MCP serverid jäävad kättesaamatuks: lubatud on ainult HTTPS. Iga avaldatud tööriist tarbib konteksti, muutes minimalismi arhitektuuriliseks otsuseks, mitte järelmõtteks. Ja võrgu latentsus liitub iga kutsega, nii et agent, mis aheldab mitu MCP tööriista, vastab aeglasemalt kui agent, mis kutsub ainult ühte.

Ükski neist piirangutest pole takistuseks. Kõiki saab mööda minna teadlike disainivalikutega, mida see kursus sulle just pakkuski.

Peamised punktid

  • Kauge MCP ühendab Groki väliste tööriistadega HTTPS-i kaudu paari seadistusrealine
  • MCP serveri seadistamiseks piisab kuuest parameetrist (kaks kohustuslikku, neli valikulist)
  • Turvalisus tugineb kolmikule: HTTPS + autentimine + tööriistade piiramine
  • Alusta avaliku serveriga (DeepWiki) ja liigu edasi autentitud mitme serveriga süsteemide juurde
  • Kombineeri MCP ja emakeelseid tööriistu mitmekülgsete agentide loomiseks

Testi oma teadmisi

Kauge MCP serverid Groki API-s: oled selle kokkuvõtte ära teeninud.

1. Mida võimaldab Groki API MCP-tugi?

Vastus: Ühendada kaugeid MCP servereid mudeli tööriistadena: Grok kutsub nende võimekusi genereerimise ajal – sinu süsteemid ja MCP ökosüsteem muutuvad laiendusteks.

2. Kuidas deklareerida MCP serverit päringus?

Vastus: Kasutades server_url ja server_label, koos kirjelduse ja lubatud tööriistade nimekirjaga – ning juurdepääsuks vajalike autentimispäistega.

3. Mida võimaldab mitme serveri konfiguratsioon?

Vastus: Kombineerida ühes päringus mitut MCP serverit – igaüks oma sildiga – ja segada neid sisseehitatud tööriistadega (web, X): orkestreerimine jääb mudeli hooleks.

4. Millised transpordid on toetatud?

Vastus: Streaming HTTP ja SSE – protokolli kaugtranspordid: server asub seal, kus soovid, API ühendub sellega.

5. Millised turvareeglid kehtivad kaugserveritele?

Vastus: Luba ainult vajalikud tööriistad, autentige tõsiselt ja käsitle serveri vastuseid andmetena, mida tuleb valideerida – kolmanda osapoole MCP server on potentsiaalne rünnakupind.

Deklareeri, piira, autentida, kombineeri: kauge MCP laiendab Groki sinu süsteemideni – sinu reeglite järgi.