Tvoj prvý plugin
Na tejto strane
Lekcia prepísaná 3. novembra 2026 na základe stránok Quickstart, MCP server and UI quickstart a Connect and test your plugin v dokumentácii OpenAI Plugins. Predchádzajúci príklad „webová aplikácia počasie za 30 minút“ sa spoliehal na neexistujúce SDK. Dňa 3. novembra 2026 sme overili verzie balíkov npm:
@modelcontextprotocol/ext-apps2.x je postavený na MCP SDK v2, zatiaľ čo príklady od OpenAI používajú v1. Zdroje: Quickstart · MCP server and UI quickstart · Connect and test.
Dva kroky
Najprv pripojíš existujúci MCP server, aby si videl celý pracovný postup ChatGPT bez napísania jediného riadku kódu. Následne napíšeš vlastný server, otestuješ ho lokálne a pripojíš ho rovnakým spôsobom.
Krok 1: Osobný plugin za päť minút
OpenAI poskytuje verejný, neautentifikovaný ukážkový MCP server, ktorý vystavuje jeden nástroj len na čítanie: roll_dice.
- Prejdi na ChatGPT Plugins, klikni na tlačidlo + a vyber možnosť Add custom MCP server.
- Zadaj názov a ako Server URL nastav
https://tinymcp.dev/api/moldy-aloof-zettabyte/mcp. Vyber možnosť No authentication. - Prečítaj si upozornenie na riziká, zaškrtni I understand and want to continue a klikni na Create as a plugin.
- Plugin sa objaví v tvojom zozname osobných pluginov: otvor ho a nainštaluj pomocou tlačidla +.
- Vráť sa na domovskú obrazovku ChatGPT, prepni sa z karty Chat na Work, začni novú konverzáciu, napíš
@a vyber svoj plugin. - Požiadaj ho, aby hodil dvadsaťstennou kockou: mal by zavolať
roll_dicepráve raz s parametromsidesnastaveným na 20 a vrátiť hodnotu medzi 1 a 20.
Nezostávaj len pri šťastnom scenári. Vyskúšaj rôzne veľkosti kociek, neplatné hodnoty a požiadavky, ktoré by nemali spustiť žiadny nástroj. Tento reflex poháňa zvyšok kurzu: keď model vyberie zlý nástroj alebo zmení jeho argumenty, musíš vylepšiť popis a schému nástroja. Všimni si tiež, že pridávanie vlastných MCP serverov sa riadi pravidlami tvojho účtu alebo pracoviska: v rámci organizácie môže byť táto možnosť obmedzená.
Krok 2: Tvoj vlastný server
Inštalácia oficiálnych SDK
Oficiálne SDK protokolu existujú pre TypeScript (@modelcontextprotocol/sdk) a Python (mcp). Tento kurz nasleduje príklady od OpenAI napísané v TypeScripte pomocou SDK v1. Pripni si verzie: k septembru 2026 balík @modelcontextprotocol/ext-apps 2.x – rozhranie, ktoré pridáš v lekcii 6 – závisí od nových balíkov SDK v2 (@modelcontextprotocol/server…), ktoré nie sú kompatibilné s importmi z v1.
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
Príkaz npm pkg set type=module pridá do súboru package.json položku "type": "module", ktorá je potrebná pre príkazy import v serveri.
Napísanie servera
Tento server sa zmestí do jedného súboru, server.js. Uchováva poznámky v pamäti a vystavuje dva nástroje: jeden na čítanie a jeden na zápis, oddelené podľa odporúčaní z lekcie 3.
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 = []; // príklad dát v pamäti: nahraď vlastným úložiskom
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;
}
// Bezstavový režim: nový server a transport pre každú požiadavku
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`));
Dôležité sú tri detaily. Každý nástroj deklaruje názov, popis zámeru, schémy a presné anotácie: toto je jeho „profil“ pre model. Každý výsledok kombinuje structuredContent, ktoré model opätovne využije, a content, čo je krátka textová správa. Nakoniec, akákoľvek adresa iná ako /mcp vráti chybu 404: príklad od OpenAI to robí pre trasy objavovania OAuth, ktoré zatiaľ nepoužívaš, čím zabraňuje tomu, aby ChatGPT počas tvojich neautentifikovaných testov zobrazoval chyby 502. Ten istý príklad pridáva odpoveď na predbežnú požiadavku CORS (OPTIONS) a GET / pre kontroly stavu; zahrň ich, ak ich tvoje hostovanie očakáva.
Lokálne testovanie pomocou MCP Inspector
node server.js
npx @modelcontextprotocol/inspector@latest
V nástroji Inspector vyber Streamable HTTP, zadaj http://localhost:8787/mcp a pripoj sa. Over, či inicializácia prebehne úspešne, či sa objavia oba nástroje so svojimi schémami a anotáciami, a potom ich zavolaj s platnými aj neplatnými vstupmi – prázdny textový reťazec musí byť schémou zamietnutý.
Sprístupnenie servera a jeho pripojenie
ChatGPT sa musí k tvojmu serveru dostať z internetu. Počas vývoja stačí tunel – dokumentácia uvádza ngrok:
ngrok http 8787
Získaš verejnú adresu HTTPS. Pripoj ju ako v kroku 1, vrátane cesty /mcp (napríklad https://<subdomain>.ngrok.app/mcp), nainštaluj výsledný plugin a potom ho vyvolaj pomocou @: „Ulož poznámku: zavolaj dodávateľa v pondelok.“ ChatGPT zobrazí údaje vymenené s nástrojom, čo ti umožní overiť vstupy a výstupy.
Vývojový tunel funguje len na skúšky: publikovanie si vyžaduje stabilný, verejný koncový bod HTTPS (lekcia 5).
Znovu načítaj po každej zmene
ChatGPT ukladá metadáta tvojho servera do vyrovnávacej pamäte. Po akejkoľvek zmene názvu, popisu, schémy, anotácie, autentifikácie alebo zdroja rozhrania: znovu nasadiť alebo reštartovať server, otvoriť pripojenie na chatgpt.com/plugins, vybrať Refresh, overiť, či sa inzerované metadáta zmenili, a potom otvoriť novú konverzáciu na opätovné spustenie testov. Vynechanie tohto kroku znamená, že testuješ starú verziu, ani si to neuvedomuješ.
Kľúčové poznatky
- Vytvor osobný plugin cez Add custom MCP server a potom ho v ChatGPT vyvolaj pomocou
@ - Oficiálne SDK:
@modelcontextprotocol/sdk(TypeScript) amcp(Python); pripni v1 sext-apps1.x, aby si nasledoval príklady od OpenAI - Minimálny server:
McpServer,registerTool, transport streamable HTTP na/mcp - Na lokálne testovanie použi MCP Inspector, na skúšky v ChatGPT tunel
- Po akejkoľvek zmene metadát: Refresh a potom začni novú konverzáciu