Paketo laajennus
Tällä sivulla
Oppitunti kirjoitettu uudelleen 3. marraskuuta 2026 perustuen OpenAI:n laajennusdokumentaation sivuun Package your plugin. Edellinen oppitunti kuvasi “paketin” rakentamista olemattomalle “ChatGPT Kaupalle” käyttäen puuttuvaa manifestia. Laajennus paketoidaan
plugin.json-manifestilla, joka noudattaa Agent Plugins -skeemaa. Lähde: Package your plugin.
Miksi paketointi on tarpeen
Kun olet kirjoittanut taitosi ja tarvittaessa rakentanut MCP-palvelimen, viimeinen vaihe on niiden kokoaminen asennettavaksi kokonaisuudeksi. Paketointi antaa laajennuksellesi vakaan identiteetin ja kertoo ChatGPT:lle sekä Codexille, mitkä taidot, MCP-palvelinyhteydet ja resurssit kuuluvat yhteen. Käyttöliittymä- ja tunnistautumislogiikka pysyvät MCP-palvelimen sisällä; manifesti vain linkittää tämän integraation muuhun pakettiin.
Siirrettävän paketin rakenne
Siirrettävässä laajennuksessa on juuressaan plugin.json-manifesti, joka määrittelee Agent Plugins -skeeman. Kansio voi sisältää myös skills/-hakemiston, mcp.json-tiedoston laajennuksen mukana jaettaville MCP-palvelimille sekä visuaaliset resurssit hakemistossa assets/.
mon-plugin/
├── plugin.json
├── mcp.json
├── skills/
│ └── compte-rendu/
│ └── SKILL.md
└── assets/
├── icon.png
└── logo.png
Minimaalinen manifesti mahtuu vain muutamaan riviin. Nimi, joka on pysyvä ja kirjoitettu kebab-case-muodossa, toimii sekä tunnisteena että komponenttien nimiavaruutena; taidot löytyvät automaattisesti hakemistosta skills/ ilman erillistä määrittelyä.
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "notes-equipe",
"version": "0.1.0",
"description": "Team notes and meeting minutes"
}
Jokainen taito sijaitsee polussa skills/<nimi>/SKILL.md. Tiedoston otsikko sisältää nimen ja kuvauksen, jota seuraavat ohjeet:
---
name: compte-rendu
description: Drafts meeting minutes from team notes.
---
Retrieve meeting notes using list_notes, group them by topic,
then draft a summary: decisions, action items with owners, and open points.
MCP-palvelimen määrittely
Laajennuksen mukana jaettavat MCP-palvelimet määritellään juuren mcp.json-tiedostossa käyttäen vastaavaa skeemaa ja määrittämällä kullekin palvelimelle siirtotyyppi:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
"mcpServers": {
"notes": {
"type": "streamable-http",
"url": "https://notes.example.com/mcp"
}
}
}
Palvelimen tunnistautuminen määritellään samassa tiedostossa kohdassa extensions["com.openai"].auth kutakin palvelinta varten – se kuuluu palvelimelle, ei manifestille. Julkista lähetystä varten toimitat etäisen HTTPS-päätepisteen; paikalliset palvelimet noudattavat erillistä polkua, joka on varattu työpöytälaajennuksille.
OpenAI-kohtaiset metatiedot
Hakemiston esitys, kartoitukset jo rekisteröityihin MCP-palvelimiin ja koukut (hooks) määritellään juuren plugin.json-tiedoston extensions.com.openai-objektissa, kun taas siirrettävä identiteetti (name, version, description) pysyy juuritasolla:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "notes-equipe",
"version": "0.1.0",
"description": "Team notes and meeting minutes",
"extensions": {
"com.openai": {
"interface": {
"displayName": "Team Notes",
"shortDescription": "Notes and meeting minutes",
"developerName": "Your Team",
"category": "Productivity",
"capabilities": ["Read", "Write"],
"websiteURL": "https://example.com",
"privacyPolicyURL": "https://example.com/privacy",
"termsOfServiceURL": "https://example.com/terms",
"defaultPrompt": ["Use Team Notes to draft Monday's meeting minutes."],
"composerIcon": "./assets/icon.png",
"logo": "./assets/logo.png"
}
}
}
}
Tämän objektin polut ovat suhteellisia laajennuksen juureen ja alkavat merkeillä ./. Visuaaliset resurssit (composerIcon, logo, screenshots) kannattaa sijoittaa hakemistoon ./assets/. Kenttää apps käytetään vain osoittamaan .app.json-tiedostoon, joka sisältää kartoitukset ChatGPT:ssä jo rekisteröityihin MCP-palvelimiin.
Voit myös määritellä perehdytystaidon (onboarding skill) käyttämällä avainta extensions.com.openai.onboardingSkill (esimerkiksi ./skills/setup/SKILL.md): se ohjaa käyttäjää asennuksen jälkeen valitsemaan työtilan tai asettamaan mieltymykset. Testaa sitä uudessa keskustelussa ja käynnissä olevan asennuksen aikana.
Vanhempaa muotoa, jossa manifesti sijaitsee polussa .codex-plugin/plugin.json, hyväksytään edelleen yhteensopivuuden vuoksi: sitä käytetään vain, jos extensions.com.openai-objekti puuttuu, sillä nämä kaksi eivät yhdy. Uusien pakettien tulisi käyttää juuren plugin.json-tiedostoa.
Pikarata: @plugin-creator
ChatGPT ja Codex sisältävät taidon @plugin-creator, joka luo rakenteen puolestasi – tällä hetkellä yhteensopivassa .codex-plugin/-muodossa. Liittääksesi siihen MCP-palvelimen, yhdistä ensin kyseinen palvelin ChatGPT:ssä (Add custom MCP server, sitten Create as a plugin), huomaa tekninen yhteystunniste selaimen URL-osoitteesta – se alkaa merkkijonolla plugin_asdk_app – ja anna se taidolle @plugin-creator Work-tilassa (tai taidolle $plugin-creator Codexissa). Taito voi myös luoda henkilökohtaisen markkinapaikkamerkinnän, jonka avulla voit asentaa ja testata laajennusta paikallisesta hakemistolähteestä.
Paikalliset markkinapaikat
Markkinapaikka on JSON-muotoinen luettelo laajennuksista. Sitä käytetään kirjoittamiseen, testaamiseen ja tiimijakeluun julkisen hakemiston rinnalla: Work-tilassa tai Codexissa jokainen markkinapaikka näkyy valittavana lähteenä laajennushakemistossa. Näin testaat koko laajennuksen ennen sen lähettämistä (Oppitunti 9).
Koukut: vain työpöytäversio
Elinkaaren koukut (lifecycle hooks) tuetaan vain laajennuksille, jotka on asennettu manuaalisesti Codexin työpöytäsovellukseen. Laajennus, joka sisältää niitä, ei kelpaa julkiseen hakemistoon. Jos tavoitteesi on julkaista laajennus, jätä ne pois.
Keskeiset asiat
- Siirrettävä paketti:
plugin.json(Agent Plugins -skeema),skills/,mcp.json,assets/ - MCP-palvelin määritellään tiedostossa
mcp.jsonsiirtotyypin kanssa; myös tunnistautuminen kuuluu sinne - Esitystapa, kartoitukset ja perehdytystaito määritellään kohteessa
extensions.com.openai @plugin-creatorluo rakenteen; paikallista markkinapaikkaa käytetään testaamiseen- Laajennus, jossa on koukkuja, ei kelpaa julkiseen hakemistoon