Sinu esimene pistikprogramm
Sellel lehel
Õppetund kirjutati ümber 3. novembril 2026, tuginedes OpenAI pistikprogrammide dokumentatsiooni lehtedele Quickstart, MCP server and UI quickstart ja Connect and test your plugin. Eelmine näide „ilmarakendus 30 minutiga“ põhines olematul SDK-l. Kontrollisime npm-i pakettide versioone 3. novembril 2026:
@modelcontextprotocol/ext-apps2.x põhineb MCP SDK v2-l, samas kui OpenAI näited kasutavad v1-d. Allikad: Quickstart · MCP server and UI quickstart · Connect and test.
Kaks sammu
Esmalt ühendad olemasoleva MCP-serveri, et näha kogu ChatGPT töövoogu ilma ühtegi koodirida kirjutamata. Seejärel kirjutad oma serveri, testid seda kohalikult ja ühendad selle samal viisil.
1. samm: Isiklik pistikprogramm viie minutiga
OpenAI pakub avalikku, autentimata näidis-MCP-serverit, mis avaldab ühe ainult lugemiseks mõeldud tööriista: roll_dice.
- Mine aadressile ChatGPT Plugins, vali nupp + ja seejärel Add custom MCP server.
- Sisesta nimi ja määra Server URL väärtuseks
https://tinymcp.dev/api/moldy-aloof-zettabyte/mcp. Vali No authentication. - Loe riskihoiatust, vali I understand and want to continue ja klõpsa Create as a plugin.
- Pistikprogramm ilmub sinu isiklike pistikprogrammide loendisse: ava see ja installi, kasutades nuppu +.
- Naase ChatGPT avalehele, lülitu vahekaardilt Chat vahekaardile Work, alusta uut vestlust, kirjuta
@ja vali oma pistikprogramm. - Palu sel veeretada kahekümnetaolist täringut: see peaks kutsuma
roll_dicetäpselt üks kord, seadessidesväärtuseks 20, ja tagastama väärtuse vahemikus 1–20.
Ära peatu ainult õnnestumise korral. Proovi erinevaid täringu suurusi, vigaseid väärtusi ja päringuid, mis ei tohiks ühtegi tööriista käivitada. See refleks juhatab kogu ülejäänud kursust: kui mudel valib vale tööriista või muudab selle argumente, pead täiustama tööriista kirjeldust ja skeemi. Pane tähele ka seda, et sinu konto või tööruumi poliitikad reguleerivad kohandatud MCP-serverite lisamist: organisatsioonis võib see valik olla piiratud.
2. samm: Sinu oma server
Ametlike SDK-de installimine
Protokolli jaoks on olemas ametlikud SDK-d TypeScriptile (@modelcontextprotocol/sdk) ja Pythonile (mcp). See kursus järgib OpenAI näiteid, mis on kirjutatud TypeScriptis, kasutades SDK v1-d. Lukusta oma versioonid: alates septembrist 2026 tugineb @modelcontextprotocol/ext-apps 2.x – liidesepakett, mille lisad 6. õppetunnis – uutele v2 SDK pakettidele (@modelcontextprotocol/server…), mis ei ühildu v1 importidega.
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
npm pkg set type=module lisab faili package.json kirje "type": "module", mis on serveri import-lause jaoks kohustuslik.
Serveri kirjutamine
See server mahub ühte faili, server.js. See hoiab märkmeid mälus ja avaldab kaks tööriista: üks lugemiseks ja teine kirjutamiseks, nagu soovitatud 3. õppetunnis.
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 = []; // näide mälus hoitavatest andmetest: asenda oma salvestuslahendusega
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;
}
// Olekuta režiim: uus server ja transport iga päringu jaoks
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`));
Kolm detaili on olulised. Iga tööriist deklareerib pealkirja, kavatsuse kirjelduse, skeemid ja täpsed annotatsioonid: see on selle „profiil“ mudeli jaoks. Iga tulemus ühendab structuredContent-i, mida mudel saab uuesti kasutada, ja content-i, lühese tekstisõnumina. Lõpuks tagastab iga muu aadress peale /mcp veakoodi 404: OpenAI näide teeb seda OAuth-i avastamisradade jaoks, mida sa veel ei kasuta, hoides ära ChatGPT 502-vigade ilmumise sinu autentimata testide ajal. Sama näide lisab vastuse esialgsele CORS-päringule (OPTIONS) ja GET / tervisekontrolliks; lisa need, kui sinu majutusteenus neid eeldab.
Kohalik testimine MCP Inspectoriga
node server.js
npx @modelcontextprotocol/inspector@latest
Vali Inspectoris Streamable HTTP, sisesta http://localhost:8787/mcp ja ühendu. Veendu, et initsialiseerimine õnnestub, et mõlemad tööriistad ilmuvad koos oma skeemide ja annotatsioonidega, ning seejärel kutsu neid kehtivate ja vigaste sisenditega – tühi tekstistring tuleb skeemi poolt tagasi lükata.
Serveri avalikustamine ja ühendamine
ChatGPT peab pääsema sinu serverile interneti kaudu. Arenduse ajal piisab tunnelist – dokumentatsioon viitab ngrok-ile:
ngrok http 8787
Saad avaliku HTTPS-aadressi. Ühenda see nagu 1. sammus, kaasates tee /mcp (näiteks https://<subdomain>.ngrok.app/mcp), installi saadud pistikprogramm ja seejärel kutsu seda, kasutades @: „Salvesta märkus: helista müüjale esmaspäeval.“ ChatGPT kuvab tööriistaga vahetatud andmed, võimaldades sul sisendeid ja väljundeid kontrollida.
Arendustunnel sobib ainult katsetusteks: avaldamine nõuab stabiilset, avalikku HTTPS-lõpppunkti (5. õppetund).
Laadi iga muudatuse järel uuesti
ChatGPT vahemällu salvestab sinu serveri metaandmed. Pärast mis tahes muudatust nimes, kirjelduses, skeemis, annotatsioonis, autentimises või liidese ressursis: paiguta server uuesti või taaskäivita see, ava ühendus aadressil chatgpt.com/plugins, vali Refresh, veendu, et reklaamitud metaandmed on muutunud, ja ava seejärel uus vestlus testide uuesti läbiviimiseks. Selle sammu vahelejätmine tähendab, et testid teadmatult vana versiooni.
Peamised punktid
- Loo isiklik pistikprogramm, kasutades Add custom MCP server, ja kutsu seda ChatGPT-s märgiga
@ - Ametlikud SDK-d:
@modelcontextprotocol/sdk(TypeScript) jamcp(Python); lukusta v1 koosext-apps1.x-ga, et järgida OpenAI näiteid - Minimaalne server:
McpServer,registerTool, streamable HTTP transport aadressil/mcp - Kasuta kohalikuks testimiseks MCP Inspectorit ja ChatGPT katsetusteks tunnelit
- Pärast mis tahes metaandmete muutmist: Refresh ja alusta uut vestlust