Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Yhteenveto ja käytännön harjoitukset

Oppitunti 12 / 12 Päivitetty 29. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Mitä olemme käyneet läpi
  2. Kuusi parametria pähkinänkuoressa
  3. Tarkistukset ennen tuotantoon siirtymistä
  4. Ensimmäinen agenttisi kolmessa vaiheessa
  5. Mitä pysyy totuutena tämän kurssin jälkeen
  6. Keskeiset asiat
  7. Testaa tietämyksesi

Mitä olemme käyneet läpi

Tämä kurssi vei sinut Model Context Protocol -konseptista tuotantovalmiiseen konfiguraatioon. Jos muistat vain yhden asian, olkoon se tämä: MCP mahdollistaa Grokin yhteyden ulkoisiin työkalupalvelimiin HTTPS:n kautta, löytäen ja käyttäen tarjolla olevia työkaluja automaattisesti ilman manuaalista asiakaspuolen konfigurointia.

Arkkitehtonisesti neljä kohtaa jäsentelee kaiken muun. Etä-MCP toimii yksinomaan HTTPS:n yli, mikä sulkee pois tavallisen HTTP:n, localhost-osoitteet ja stdio-kuljetuksen paikallisille palvelimille. Kaksi kuljetustapaa on tuettu: moderni tilaton Streaming HTTP ja pysyvä SSE, ja palvelin määrää kumpaa käytetään – sinä et valitse. Lopuksi kolme rajapintaa tarjoaa pääsyn tähän mekanismiin: natiivi xAI SDK (suositeltu), Responses API OpenAI-yhteensopivuutta varten ja Voice Agent API ääniagenteille.

Kuusi parametria pähkinänkuoressa

ParametriPakollinenToiminto
server_urlKylläMCP-palvelimen HTTPS-osoite
server_labelKylläYksilöllinen tunniste, lisää etuliitteen työkaluihin
server_descriptionEiLuonnollisen kielen kuvaus Grokin ohjaamiseksi
allowed_tool_namesEiSallittujen työkalujen luettelo
authorizationEiTodennustunnus (Bearer, API-avain)
headersEiLisä-HTTP-otsikot

Kaksi pakollista, neljä valinnaista: siinä on koko etä-MCP:n konfigurointipinta. Valinnaiset parametrit eivät kuitenkaan ole vain mukavuusominaisuuksia. allowed_tool_names hoitaa turvallisuutesi, ja server_description varmistaa tarkan valinnan, kun useita palvelimia on käytössä samanaikaisesti.

Tarkistukset ennen tuotantoon siirtymistä

Kolme valvontakategoriaa vaativat nimenomaista varmistamista. Turvallisuuden osalta varmista, että URL-osoitteet käyttävät HTTPS:ää voimassa olevilla varmenteilla, jokaisella sisäisellä palvelimella on oma todennustunnuksensa, nämä tunnukset säilytetään ympäristömuuttujissa, työkalut on rajoitettu tarvittavaan minimiin ja säännöllinen tunnusten kierrätys on suunniteltu eikä toivottu asia.

Konfiguraation osalta jokaisella palvelimella on oltava yksilöllinen ja kuvaava server_label, ja sen server_description on oltava tarkka ja ajantasainen – vanhemman palvelinversion kuvaus harhaanjohtaa mallia. Pidä työkalujen kokonaismäärä kohtuullisena, noin kymmenestä kahteenkymmeneen istuntoa kohden, ja poista konfiguraatiosta palvelimet, joiden työkaluja kukaan ei enää kutsu.

Havainnoitavuuden osalta suunnittele incidentit etukäteen: työkalukutsut jäljitettynä lokeihisi, hälytykset MCP-yhteysvirheille, tunnusten käytön seuranta palvelinkohtaisesti ja kutsuviiveen mittaaminen. Jälkimmäinen jätetään usein huomiotta, vaikka se muodostaa ensimmäisen signaalin palvelimen heikkenemisestä.

Ensimmäinen agenttisi kolmessa vaiheessa

Paras tapa lujittaa tämän kurssin opit on edetä askel askeleelta. Aloita julkisella palvelimella ilman todennusta varmistaaksesi, että mekanismi toimii päästä päähän.

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

Testaa pyynnöllä, joka pakottaa mallin konsultoimaan repositoriota, kuten “selitä minulle fastapi/fastapi-projektin arkkitehtuuri”. Jos vastaus saapuu ja viittaa todelliseen projektirakenteeseen, MCP-yhteytesi on toiminnassa.

Seuraavaksi lisää natiivi työkalu nähdäksesi, kuinka Grok tekee päätöksen kahden eri luonteisen lähteen välillä. Palvelimen kuvaus tulee tässä hyödylliseksi, juuri siksi, että nyt on tehtävä valinta.

tools=[
    mcp(
        server_url="https://mcp.deepwiki.com/mcp",
        server_label="deepwiki",
        server_description="Avoimen lähdekoodin GitHub-projektien dokumentaatio"
    ),
    {"type": "web_search"},
]

Lopuksi ota askel sisäiseen palvelimeen todennuksen ja työkalurajoitusten kera. Tämä on vaihe, jossa kaikki turvallisuuteen liittyvä muuttuu konkreettiseksi.

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="Yrityksen sisäiset tiedot ja työkalut",
        authorization=f"Bearer {os.getenv('INTERNAL_TOKEN')}",
        allowed_tool_names=["search", "get_document"]
    ),
    {"type": "web_search"},
]

Mitä pysyy totuutena tämän kurssin jälkeen

Neljä rajoitusta seuraa kaikkia MCP-projektejasi Grokin kanssa. OpenAI-muotoinen Responses API ei tue kohtia require_approval eikä connector_id, mikä palauttaa sinut natiiviin SDK:hun aina, kun haluat ihmisen vahvistuksen ennen suorittamista. Stdio-kuljetus ja siten paikalliset MCP-palvelimet pysyvät ulottumattomissa: vain HTTPS. Jokainen esillä oleva työkalu kuluttaa kontekstia, mikä tekee minimalismista arkkitehtonisen päätöksen eikä jälkikäteen tehtävän harkinnan. Ja verkkoviive kasvaa jokaisen kutsun myötä, joten useita MCP-työkaluja ketjuttava agentti vastaa hitaammin kuin vain yhtä työkalua käyttävä agentti.

Mikään näistä rajoituksista ei ole este. Kaikki ne kiertävät suunnitteluratkaisuilla, jotka on tehty täydellä tietämyksellä, mikä on juuri sitä, mitä tämä kurssi on sinulle antanut.

Keskeiset asiat

  • Etä-MCP yhdistää Grokin ulkoisiin työkaluihin HTTPS:n kautta muutamalla konfiguraatiorivillä
  • Kuusi parametria riittää MCP-palvelimen konfigurointiin (kaksi pakollista, neljä valinnaista)
  • Turvallisuus perustuu kolmikkoon HTTPS + todennus + työkalurajoitus
  • Aloita julkisella palvelimella (DeepWiki) ja etene sitten todennettuun monipalvelinratkaisuun
  • Yhdistä MCP ja natiivit työkalut luodaksesi monipuolisia agentteja

Testaa tietämyksesi

Etä-MCP-palvelimet Groki-API:ssa: olet ansainnut tämän yhteenvedon.

1. Mitä Groki-API:n MCP-tuki mahdollistaa?

Vastaus: Yhdistää etä-MCP-palvelimet mallin työkaluiksi: Grok kutsuu niiden ominaisuuksia generoinnin aikana – järjestelmäsi ja MCP-ekosysteemi muuttuvat laajennuksiksi.

2. Miten MCP-palvelin ilmoitetaan pyynnössä?

Vastaus: Kohtien server_url ja server_label kautta, lisäten kuvauksen ja valtuutettujen työkalujen sallimisluettelon – sekä pääsyn vaatimat todennusotsikot.

3. Mitä monipalvelinkonfiguraatio mahdollistaa?

Vastaus: Yhdistää useita MCP-palvelimia yhteen pyyntöön – kukin nimettynä – ja sekoittaa niitä sisäänrakennettuihin työkaluihin (web, X): orkestrointi pysyy mallilla.

4. Mitkä kuljetustavat ovat tuettuja?

Vastaus: Streaming HTTP ja SSE – protokollan etäkuljetukset: palvelin sijaitsee missä haluat, API yhdistää siihen.

5. Mitkä turvallisuussäännöt koskevat etäpalvelimia?

Vastaus: Valtuuta vain tarvittavat työkalut, todenna vakavasti ja käsittele palvelinvastauksia datana, joka on validoitava – kolmannen osapuolen MCP-palvelin on potentiaalinen hyökkäyspinta.

Ilmoita, rajoita, todenna, yhdistä: etä-MCP laajentaa Grokin järjestelmiisi – sinun sääntöjesi mukaan.