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

Yhdistä MCP ja sisäänrakennetut työkalut

Oppitunti 10 / 12 Päivitetty 29. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Kaksi työkaluperhettä, yksi luettelo
  2. Sekoittaminen: ei uutta opittavaa
  3. Orkestrointi tapahtuu automaattisesti
  4. Kaksi tyypillistä kokoonpanoa
  5. Runsauden piilokustannukset
  6. Keskeiset asiat

Kaksi työkaluperhettä, yksi luettelo

MCP ei ole ainoa tapa antaa Grokille uusia kykyjä. xAI:n API sisältää natiiveja työkaluja, joita kutsutaan sisäänrakennetuiksi työkaluiksi (built-in tools). Malli voi kutsua niitä ilman ulkoista palvelinta. Sinun ei tarvitse valita näiden kahden perheen välillä: määrittelet ne samassa paikassa ja yhdistelet niitä vapaasti yhdessä määrityksessä.

Neljä natiivia työkalua kattaa useimmat tarpeet.

  • Web-haku: reaaliaikainen verkkohaku
  • Koodin suoritus: Python-koodin suoritus hiekkalaatikossa
  • Kuva-analyysi: kuvien analysointi ja kuvaus
  • Tiedoston jäsentäminen: tiedostosisällön lukeminen ja purkaminen

Määrittelet ne tools-taulukossa pelkän tyypin perusteella, ilman URL-osoitetta tai nimikettä. Tämä on loogista, sillä etäpalvelinta ei tarvitse osoittaa.

Sekoittaminen: ei uutta opittavaa

Syntaksi ei vaadi erityistä rakennetta. Sijoitat MCP-objektit ja natiivit objektit vierekkäin samaan taulukkoon.

from xai_sdk import Client
from xai_sdk.tools import mcp

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

chat = client.chat.create(
    model="grok-4.20-0309-reasoning",
    tools=[
        # Etä-MCP-työkalu
        mcp(
            server_url="https://mcp.deepwiki.com/mcp",
            server_label="deepwiki",
            server_description="Documentation for GitHub projects"
        ),
        # Natiivi työkalu: web-haku
        {"type": "web_search"},
    ],
)

OpenAI-yhteensopiva Responses API noudattaa samaa logiikkaa, jossa MCP-työkalu saa yksinkertaisesti sanakirjamuotonsa.

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input=[{"role": "user", "content": "Compare React and Vue based on the official docs and current trends"}],
    tools=[
        {
            "type": "mcp",
            "server_url": "https://mcp.deepwiki.com/mcp",
            "server_label": "deepwiki"
        },
        {"type": "web_search"},
    ],
)

Orkestrointi tapahtuu automaattisesti

Mallin näkökulmasta MCP- ja natiivityökalut muodostavat yhden yhtenäisen luettelon. Grok ei tee eroa työkalun välillä, joka kulkee verkon yli kolmannen osapuolen palvelimelle, ja työkalun, jonka xAI:n infrastruktuuri suorittaa: se näkee vain kyvyt, niiden nimet ja kuvaukset, ja valitsee niistä sen, joka vie vastausta eteenpäin jokaisessa vaiheessa.

Ota esimerkiksi kysely: “vertaa Next.js:n reititysmäärityksiä nykyisiin parhaisiin käytäntöihin”. Grok kutsuu ensin deepwiki__search-funktiota lukeakseen reititysdokumentaation Next.js-varastosta, sitten web_search-funktiota löytääkseen tuoreita artikkeleita nykykäytännöistä ja lopuksi syntetisoi molemmat lähteet johdonmukaiseksi vastaukseksi. Et missään vaiheessa määrittänyt tätä järjestystä etkä edes sitä, että näitä kahta työkalua pitäisi käyttää yhdessä. Malli päättää sekvenssin yksin, eikä sinun tarvitse kirjoittaa mitään orkestrointilogiikkaa.

Kaksi tyypillistä kokoonpanoa

Tekninen tutkimusagentti hyödyntää viitedokumentaatiota, verkkokäyttöä ja koodin varmistuskykyjä.

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

Tämä kolmikko antaa sinulle mahdollisuuden konsultoida projektin dokumentaatiota, hakea lisätietoja verkosta ja sen jälkeen suorittaa koodia ratkaisun validoimiseksi ennen sen ehdottamista. Kolmas työkalu muuttaa vastauksen luonnetta: agentti ei vain väitä koodinpätkän toimivan, vaan se varmistaa sen.

Sisäinen tekninen avustaja noudattaa eri logiikkaa, jossa kaksi yksityistä palvelinta hallinnoivat yrityksen tietämystä ja verkko toimii vain varaväylänä.

tools = [
    mcp(
        server_url="https://kb.monentreprise.com/mcp",
        server_label="kb",
        server_description="Internal knowledge base",
        authorization=f"Bearer {os.getenv('KB_TOKEN')}"
    ),
    mcp(
        server_url="https://jira.monentreprise.com/mcp",
        server_label="jira",
        server_description="Jira tickets and projects",
        authorization=f"Bearer {os.getenv('JIRA_TOKEN')}",
        allowed_tool_names=["search_issues", "get_issue"]
    ),
    {"type": "web_search"},
]

Avustaja hakee tietokannasta, konsultoi aiheeseen liittyviä Jira-lippuja ja täydentää tietoja web-haulla, jos tietoa puuttuu sisäisesti. Huomaa Jiran rajoitus, joka on rajoitettu vain lukuoikeuteen: ilman sitä lipun sisältöön solutettu haitallinen ohje voisi pushata mallin suorittamaan kirjoitusoperaation.

Runsauden piilokustannukset

Jokainen lisätty työkalu, olipa se MCP tai natiivi, vie tilaa konteksti-ikkunasta määritelmänsä tallentamiseksi. Antelias määritys maksaa siis sinulle käytettävissä olevaa tilaa keskustelulle, käsittelyajalle ja valinnan tarkkuudelle.

Kolme tapaa riittää pitämään tämän kurissa. Rajoita työkalujen kokonaismäärää ja vastusta kiusausta yhdistää viisi palvelinta ja viisikymmentä työkalua, kun käyttötapauksesi vaatii kymmentä. Käytä allowed_tool_names-asetta jokaisella MCP-palvelimella pitääksesi mukana vain relevantit työkalut. Äläkä lisää natiivia työkalua “varmuuden vuoksi”: jos agentillasi ei ole syytä suorittaa koodia, code_interpreter ei ole ilmainen vaihtoehto, vaan se kuluttaa kontekstia ja lisää mahdollisuutta valita väärä työkalu.

Keskeiset asiat

  • MCP-työkalut ja natiivit työkalut (web-haku, koodin suoritus) coexist samassa tools-taulukossa
  • Grok orkestroi automaattisesti kutsut MCP- ja natiivityökalujen välillä kyselyn perusteella
  • Yhdistelmä mahdollistaa tehokkaiden agenttien luomisen, jotka hyödyntävät sekä sisäisiä lähteitä (MCP) että ulkoisia lähteitä (web-haku)
  • Rajoita työkalujen kokonaismäärää säilyttääksesi kontekstin ja mallin tarkkuuden
  • Käytä allowed_tool_names-asetta jokaiselle MCP-palvelimelle kohinan vähentämiseksi