Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Az első bővítményed

4. lecke 14 közül Frissítve 2026. november 3. Fejlesztő
Ezen az oldalon
  1. Két lépés
  2. 1. lépés: Személyes bővítmény öt perc alatt
  3. 2. lépés: A saját szervered
  4. Újratöltés minden változtatás után
  5. Főbb megállapítások

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-apps 2.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.

  1. Nyisd meg a ChatGPT Plugins oldalt, kattints a + gombra, majd válaszd az Add custom MCP server lehetőséget.
  2. 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.
  3. 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.
  4. A bővítmény megjelenik a személyes bővítményeid listájában: nyisd meg, és telepítsd a + gombbal.
  5. 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.
  6. Kérd meg, hogy dobjon fel egy húszoldalú kockát: pontosan egyszer kell meghívnia a roll_dice eszközt, ahol a sides é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) és mcp (Python); rögzítsd az v1-et az ext-apps 1.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