Az első bővítményed
Ezen az oldalon
A leckét 2026. november 3-án írtuk át a Quickstart, az MCP server and UI quickstart, valamint a Connect and test your plugin oldalak alapján az OpenAI Plugins dokumentációjából. Az előző „időjárás-app 30 perc alatt“ példa egy nem létező SDK-ra támaszkodott. 2026. november 3-án ellenőriztük az npm csomagverziókat: az
@modelcontextprotocol/ext-apps2.x az MCP SDK v2-re épül, míg az OpenAI példái az v1-et használják. Források: Quickstart · MCP server and UI quickstart · Connect and test.
Két lépés
Először egy meglévő MCP szervert kötsz össze, hogy kódírás nélkül lásd a teljes ChatGPT munkafolyamatot. Ezután megírod a saját szerveredet, helyben teszteled, majd ugyanígy összekötöd.
1. lépés: Személyes bővítmény öt perc alatt
Az OpenAI biztosít egy nyilvános, hitelesítést nem igénylő példaszerver MCP-t, amely egyetlen csak olvasható eszközt tesz közzé: a roll_dice-t.
- Nyisd meg a ChatGPT Plugins oldalt, kattints a + gombra, majd válaszd az Add custom MCP server lehetőséget.
- Adj meg egy nevet, és állítsd be a Server URL címét erre:
https://tinymcp.dev/api/moldy-aloof-zettabyte/mcp. Válaszd a No authentication opciót. - Olvasd el a kockázati figyelmeztetést, jelöld be az I understand and want to continue négyzetet, majd kattints a Create as a plugin gombra.
- A bővítmény megjelenik a személyes bővítményeid listájában: nyisd meg, és telepítsd a + gombbal.
- Térj vissza a ChatGPT kezdőképernyőjére, válts a Chat lapról a Work lapra, indíts egy új beszélgetést, írd be az
@jelet, és válaszd ki a bővítményedet. - Kérd meg, hogy dobjon fel egy húszoldalú kockát: pontosan egyszer kell meghívnia a
roll_diceeszközt, ahol asidesértéke 20, és 1 és 20 közötti értéket kell visszaadnia.
Ne állj meg a hibamentes esetnél. Próbálj ki különböző kockaméreteket, érvénytelen értékeket, és olyan kéréseket, amelyeknek nem szabadna eszközt aktiválniuk. Ez a reflexus hajtja a tanfolyam hátralévő részét: ha a modell rossz eszközt választ, vagy változtatja az argumentumait, finomítanod kell az eszköz leírását és sémáját. Ne feledd azt sem, hogy a fiókodra vagy munkaterületedre vonatkozó irányelvek szabályozzák az egyéni MCP szerverek hozzáadását: egy szervezetnél ez az opció korlátozott lehet.
2. lépés: A saját szervered
A hivatalos SDK-k telepítése
Hivatalos protokoll-SDK-k léteznek TypeScripthez (@modelcontextprotocol/sdk) és Pythonhoz (mcp). Ez a tanfolyam az OpenAI példáit követi, amelyeket TypeScriptben írtak, az SDK v1 verzióját használva. Rögzítsd a verziókat: 2026 szeptemberétől az @modelcontextprotocol/ext-apps 2.x – ez az interfész csomag, amit a 6. leckében adsz hozzá – az új v2 SDK csomagokra (@modelcontextprotocol/server…) támaszkodik, amelyek inkompatibilisek az v1 importokkal.
mkdir notes-plugin && cd notes-plugin
npm init -y
npm pkg set type=module
npm install @modelcontextprotocol/sdk@^1.29 @modelcontextprotocol/ext-apps@^1.7 zod
Az npm pkg set type=module parancs hozzáadja a "type": "module" bejegyzést a package.json fájlhoz, ami szükséges a szerver import utasításaihoz.
A szerver megírása
Ez a szerver egyetlen fájlba, a server.js-be fér el. Memóriában tárolja a jegyzeteket, és két eszközt tesz közzé: egyet az olvasáshoz, egyet az íráshoz, ahogy azt a 3. leckében ajánlottuk.
import { createServer } from "node:http";
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
import { z } from "zod";
const notes = []; // példa a memóriában tárolt adatokra: cseréld le a saját tárolódra
const schemaNotes = {
notes: z.array(z.object({ id: z.string(), text: z.string() })),
};
function creerServeur() {
const server = new McpServer({ name: "notes-demo", version: "0.1.0" });
server.registerTool(
"list_notes",
{
title: "List notes",
description: "Use when the user wants to review notes saved with this plugin.",
inputSchema: {},
outputSchema: schemaNotes,
annotations: { readOnlyHint: true, openWorldHint: false, destructiveHint: false },
},
async () => ({
structuredContent: { notes },
content: [{ type: "text", text: `${notes.length} note(s) saved.` }],
})
);
server.registerTool(
"add_note",
{
title: "Add a note",
description: "Use when the user asks to save a short note.",
inputSchema: { text: z.string().min(1).max(500) },
outputSchema: schemaNotes,
annotations: { readOnlyHint: false, openWorldHint: false, destructiveHint: false },
},
async ({ text }) => {
notes.push({ id: `note-${notes.length + 1}`, text });
return {
structuredContent: { notes },
content: [{ type: "text", text: "Note saved." }],
};
}
);
return server;
}
const PORT = Number(process.env.PORT ?? 8787);
createServer(async (req, res) => {
const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
if (url.pathname !== "/mcp") {
res.writeHead(404).end("Not Found");
return;
}
// Állapot nélküli mód: új szerver és transzport minden kéréshez
const server = creerServeur();
const transport = new StreamableHTTPServerTransport({
sessionIdGenerator: undefined,
enableJsonResponse: true,
});
res.on("close", () => {
transport.close();
server.close();
});
try {
await server.connect(transport);
await transport.handleRequest(req, res);
} catch (error) {
console.error("MCP Error:", error);
if (!res.headersSent) res.writeHead(500).end("Internal server error");
}
}).listen(PORT, () => console.log(`MCP server ready on http://localhost:${PORT}/mcp`));
Három részlet számít. Minden eszköz deklarál egy címet, egy szándékleírást, sémákat és pontos annotációkat: ez a modell számára az eszköz „profilja“. Minden eredmény egyesíti a structuredContent-et, amelyet a modell újra felhasználhat, és a content-et, ami egy rövid szöveges üzenet. Végül bármely más cím, mint a /mcp, 404-es hibát ad vissza: az OpenAI példája ezt teszi az OAuth felderítési útvonalak miatt, amelyeket még nem használsz, így megelőzve, hogy a ChatGPT 502-es hibákat mutasson a hitelesítés nélküli tesztek során. Ugyanez a példa választ ad az előzetes CORS kérésre (OPTIONS) és egy GET / kérésre az állapotfelméréshez; ezeket vedd fel, ha a hosztingod elvárja őket.
Helyi tesztelés MCP Inspectorral
node server.js
npx @modelcontextprotocol/inspector@latest
Az Inspectorban válaszd a Streamable HTTP lehetőséget, add meg a http://localhost:8787/mcp címet, és csatlakozz. Ellenőrizd, hogy az inicializálás sikerül, mindkét eszköz megjelenik a sémáival és annotációival, majd hívd meg őket érvényes és érvénytelen bemenetekkel – egy üres szöveges karakterláncot a sémának el kell utasítania.
A szerver elérhetővé tétele és összekötése
A ChatGPT-nek el kell érnie a szerveredet az interneten. Fejlesztés közben egy alagút is elegendő – a dokumentáció az ngrok-ot említi:
ngrok http 8787
Kapni fogsz egy nyilvános HTTPS címet. Kösd össze úgy, mint az 1. lépésben, beleértve a /mcp útvonalat is (például https://<subdomain>.ngrok.app/mcp), telepítsd a létrejött bővítményt, majd hívd meg az @ jellel: „Ments el egy jegyzetet: hívd fel a szállítót hétfőn.“ A ChatGPT megjeleníti az eszközzel folytatott adatcserét, így ellenőrizheted a bemeneteket és kimeneteket.
A fejlesztői alagút csak próbákra alkalmas: a közzétételhez stabil, nyilvános HTTPS végpontra van szükség (5. lecke).
Újratöltés minden változtatás után
A ChatGPT gyorsítótárazza a szervered metaadatait. Bármilyen változtatás után a névben, leírásban, sémában, annotációban, hitelesítésben vagy interfész erőforrásban: telepítsd újra vagy indítsd újra a szervert, nyisd meg a kapcsolatot a chatgpt.com/plugins oldalon, válaszd a Refresh lehetőséget, ellenőrizd, hogy a hirdetett metaadatok megváltoztak-e, majd nyiss egy új beszélgetést a tesztek újbóli futtatásához. E lépés kihagyása azt jelenti, hogy akaratlanul is a régi verziót teszteled.
Főbb megállapítások
- Hozz létre személyes bővítményt az Add custom MCP server segítségével, majd hívd meg a
@jellel a ChatGPT-ben - Hivatalos SDK-k:
@modelcontextprotocol/sdk(TypeScript) ésmcp(Python); rögzítsd az v1-et azext-apps1.x verziójával, hogy kövesd az OpenAI példáit - Minimális szerver:
McpServer,registerTool, streamable HTTP transzport a/mcpútvonalon - Használd az MCP Inspectort helyi tesztelésre, egy alagutat a ChatGPT próbákhoz
- Bármilyen metaadat-változtatás után: Refresh, majd indíts egy új beszélgetést