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

Arkkitehtuuri: Työkalut, resurssit ja käyttöliittymä

Oppitunti 2 / 14 Päivitetty 3. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Yleiskatsaus
  2. Mitä MCP-palvelin paljastaa
  3. Pyyntövirta
  4. Kuljetus ja valtuutus
  5. Käyttöliittymä: Valinnainen kerros
  6. Taidot: Työnkulun kerros
  7. Entä kaupankäynti?
  8. Keskeiset asiat

Oppitunti kirjoitettu uudelleen 3. marraskuuta 2026 perustuen OpenAI:n liitännäisdokumentaation sivuihin MCP server, Plugin architecture ja Skills. Vanhentunut “actions, widgets, commerce” -arkkitehtuuri kuvasi SDK:ta, jota ei enää ole olemassa. Lähteet: MCP server · Plugin architecture · Skills.

Yleiskatsaus

Liitännäinen koostuu itsenäisistä kerroksista. Taidot (Skills) tarjoavat toimintamallin, MCP-palvelin tarjoaa ominaisuudet ja käyttöliittymä tarjoaa visuaalisen tavan vuorovaikutukseen tarvittaessa.

Plugin
├── Skills
└── MCP Server (optional)
    ├── Tools and structured results
    └── Interface resources (optional)

Jokaisella kerroksella on erillinen rooli. Dokumentaatio tiivistää rajanvedon seuraavasti: MCP-palvelin tarjoaa datan, tunnistautumisen, valtuutuksen ja toiminnot; taito tarjoaa uudelleenkäytettäviä ohjeita, esimerkkejä ja asiakirjamalleja.

Mitä MCP-palvelin paljastaa

MCP-palvelin voi paljastaa neljän tyyppisiä entiteettejä:

  • Työkalut (Tools): Funktioita, joita malli kutsuu jäsennellyillä syötteillä.
  • Resurssit: Dataa tai sisältöä, jota asiakas voi lukea.
  • Kehotteet (Prompts): Uudelleenkäytettäviä kehotemalleja.
  • Ohjeet: Direktiivejä, jotka koskevat koko palvelinta.

Liitännäiset luottavat ensisijaisesti työkaluihin. Jokaisella työkalulla on nimi, kuvaus, syöteskeema ja valinnaisesti tulosskeema. Nämä kentät mahdollistavat sen, että malli päättää, milloin työkalua kutsutaan ja miten sen tulosta käytetään.

Pyyntövirta

Kun käyttäjä tekee pyynnön, joka vastaa työkalua, tapahtuu neljä vaihetta peräkkäin:

  1. Asiakas havaitsee MCP-palvelimen paljastamat työkalut.
  2. Malli valitsee työkalun ja tarjoaa argumentit, jotka noudattavat sen syöteskeemaa.
  3. Palvelin validoi pyynnön, suorittaa operaation ja palauttaa tuloksen.
  4. Malli käyttää tätä tulosta jatkaakseen keskustelua.

Työkalun tulos voi sisältää kolme osaa. structuredContent kuljettaa tiivistä dataa, jota malli voi tarkastella ja käyttää uudelleen myöhemmissä kutsuissa. content kuljettaa tekstiä tai muuta MCP-sisältöä, joka auttaa mallia muotoilemaan vastauksen. _meta kuljettaa dataa, joka on tarkoitettu asiakkaalle ja piilotettu mallilta – piilotettu, mutta ei suojattu. Tämä kenttä ei korvaa valtuutusta tai turvallista tallennusta.

Kuljetus ja valtuutus

Tuotantoympäristössä ota käyttöön MCP-palvelin vakaassa HTTPS-osoitteessa käyttäen protokollan streamable HTTP -kuljetusta, tyypillisesti polulla /mcp. Jos työkalut lukevat yksityistä dataa tai toimivat käyttäjän puolesta, suojaa palvelin MCP-määrityksen määrittelemällä valtuutusvirralla – OAuth, jota oppitunti 8 käsittelee yksityiskohtaisesti.

Käyttöliittymä: Valinnainen kerros

Työkalun on toimittava ilman käyttöliittymää: tiivis teksti ja jäsennelty tulos ovat usein riittäviä mallille vastaamiseen. Käyttöliittymä on järkevä, kun käyttäjän tarvitsee tarkastella, vertailla, muokata, vahvistaa tai selata jäsenneltyä informaatiota – kuten tuotevertailua, muokattavaa aikataulua tai karttaa. Yksinkertainen tilan tarkistus ei yleensä tarvitse sellaista.

Kun käyttöliittymä on olemassa, se on resurssi, jonka palvelin ilmoittaa. ChatGPT näyttää sen iframe-kehyksessä, kun siihen liittyvä työkalu palauttaa sen. ChatGPT toteuttaa avoimen MCP Apps -standardin: käyttöliittymä kommunikoi isäntäjärjestelmän kanssa JSON-RPC:n kautta käyttäen postMessage-metodia. ChatGPT-specifit laajennukset, jotka ovat saatavilla window.openai:n kautta, täydentävät standardia, kun se ei kata tiettyä tarvetta. Oppitunti 6 käsittelee tätä.

Taidot: Työnkulun kerros

Taito on kansio, joka sisältää SKILL.md-tiedoston – nimen, kuvauksen, joka kertoo mallille, milloin sitä应考虑 (huomioitava), ohjeet – ja tarvittaessa viitteitä, skriptejä tai malleja. Malli näkee aluksi vain nimen ja kuvauksen; se lataa täydelliset ohjeet, kun pyyntö vastaa taitoa tai kun käyttäjä kutsuu sitä suoraan. Tästä syystä OpenAI neuvoo: kirjoita kuvaus käyttäjän tavoitteen ja laukaisuehtojen ympärille ja pidä vaiheittaiset yksityiskohdat rungossa.

Entä kaupankäynti?

Myyminen liitännäisen kautta ei ole erillinen kerros. Se on matka, jota valinnainen käyttöliittymä voi tukea hyödyntäen OpenAI:n dokumentoimaa Checkout API:a. Oppitunti 7 selittää, miten se toimii ja mitkä ovat sen rajoitukset.

Keskeiset asiat

  • MCP-palvelin paljastaa työkaluja, resursseja, kehotteita ja ohjeita; liitännäiset luottavat ensisijaisesti työkaluihin
  • Työkalun tulos yhdistää structuredContent, content ja _meta (piilotettu mallilta, mutta ei turvallinen)
  • Tuotanto: vakaa HTTPS, streamable HTTP -kuljetus, valtuutus MCP-määrityksen mukaisesti
  • Käyttöliittymä on valinnainen resurssi, jonka ChatGPT näyttää MCP Apps -standardin mukaisesti
  • Taidot hoitavat työnkulun; palvelin hoitaa datan, valtuutuksen ja toiminnot