L-Ewwel Plugin Tiegħek
F'din il-paġna
Lezzjon miktuba mill-ġdid fit-3 ta’ Novembru 2026 ibbażata fuq il-paġni Quickstart, MCP server and UI quickstart, u Connect and test your plugin fid-dokumentazzjoni tal-OpenAI Plugins. L-eżempju preċedenti ta’ “applikazzjoni tat-temp f’30 minuta” kien jiddependi fuq SDK li ma jeżistix. Ivvjerifikajna l-verżjonijiet tal-pakketti npm fit-3 ta’ Novembru 2026:
@modelcontextprotocol/ext-apps2.x jinbena fuq MCP SDK v2, filwaqt li l-eżempji ta’ OpenAI jużaw v1. Sorsi: Quickstart · MCP server and UI quickstart · Connect and test.
Żewġ Passi
L-ewwel, se tikkonnettja server MCP eżistenti biex tara l-fluss tax-xogħol sħiħ ta’ ChatGPT mingħajr ma tikteb linja waħda ta’ kodiċi. Imbagħad, se tikteb is-server tiegħek stess, tittestjah lokalment, u tikkonnettjah bl-istess mod.
Pass 1: Plugin Personali f’Ħames Minuti
OpenAI tipprovdi server MCP ta’ eżempju pubbliku u mhux awtentikat li jesponi għodda waħda biss għall-qari: roll_dice.
- Mur fuq ChatGPT Plugins, agħżel il-buttuna +, imbagħad agħżel Add custom MCP server.
- Daħħal isem u ssettja l-Server URL għal
https://tinymcp.dev/api/moldy-aloof-zettabyte/mcp. Agħżel No authentication. - Aqra t-twissija dwar ir-riskju, agħżel I understand and want to continue, imbagħad ikklikkja Create as a plugin.
- Il-plugin jidher fil-lista tal-plugins personali tiegħek: iftaħha u installaha billi tuża l-buttuna +.
- Erġa’ lura għall-iskrin tad-dar ta’ ChatGPT, ibdel mit-tab Chat għal Work, ibda konversazzjoni ġdida, ikteb
@, u agħżel il-plugin tiegħek. - Itloblu jrollja dad b’għoxrin naħa: għandu jsejjaħ
roll_diceeżattament darba b’sidesimsettjat għal 20 u jirritorna valur bejn 1 u 20.
Tieqafx fil-mogħdija faċli. Ipprova daqsijiet differenti tad-dad, valuri mhux validi, u talbiet li m’għandhomx jattivaw l-ebda għodda. Dan ir-rifless imexxi l-bqija tal-kors: meta l-mudell jagħżel l-għodda ħażina jew ivarja l-argumenti tiegħu, trid tirfina d-deskrizzjoni u l-iskema tal-għodda. Innota wkoll li l-kont tiegħek jew il-politiki tal-ispazju tax-xogħol tiegħek jirregolaw iż-żieda ta’ servers MCP customizzati: f’organizzazzjoni, din l-għażla tista’ tkun ristretta.
Pass 2: Is-Server Tiegħek
Installa l-SDKs Uffiċjali
Jeżistu SDKs uffiċjali tal-protokoll għal TypeScript (@modelcontextprotocol/sdk) u Python (mcp). Dan il-kors isegwi l-eżempji ta’ OpenAI, miktuba f’TypeScript bl-użu ta’ SDK v1. Iffissa l-verżjonijiet tiegħek: sa Settembru 2026, @modelcontextprotocol/ext-apps 2.x—il-pakkett tal-interfaċċa li se żżid fil-Lezzjoni 6—jiddependi fuq il-pakketti ġodda ta’ SDK v2 (@modelcontextprotocol/server…), li mhumiex kompatibbli mal-importazzjonijiet ta’ 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
npm pkg set type=module iżid "type": "module" ma’ package.json, meħtieġ għad-dikjarazzjonijiet import tas-server.
Ikteb is-Server
Dan is-server joqgħod f’fajl wieħed, server.js. Iżomm in-noti fil-memorja u jesponi żewġ għodod: waħda għall-qari u waħda għall-kitba, separati kif irrakkomandat fil-Lezzjoni 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 = []; // eżempju ta' dejta fil-memorja: ibdelha bl-ħażna tiegħek stess
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;
}
// Modalità mingħajr stat: server u trasport ġodda għal kull talba
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`));
Tliet dettalji huma importanti. Kull għodda tiddikjara titlu, deskrizzjoni tal-intenzjoni, skemi, u annotazzjonijiet eżatti: dan huwa l-”profil” tagħha għall-mudell. Kull riżultat jgħaqqad structuredContent, riutilizzabbli mill-mudell, u content, messaġġ qasir tat-test. Fl-aħħar nett, kwalunkwe indirizz ieħor ħlief /mcp jirritorna 404: l-eżempju ta’ OpenAI jagħmel dan għar-rotot ta’ skoperta ta’ OAuth li għadek ma tużax, u jipprevjeni li ChatGPT juri żbalji 502 matul it-testijiet mhux awtentikati tiegħek. Dak l-istess eżempju iżid tweġiba għat-talba preliminari ta’ CORS (OPTIONS) u GET / għal sondi tas-saħħa; inkludi dawn jekk l-hosting tiegħek jistennihom.
Ittestja Lokalment bl-MCP Inspector
node server.js
npx @modelcontextprotocol/inspector@latest
Fl-Inspector, agħżel Streamable HTTP, daħħal http://localhost:8787/mcp, u kkonnettja. Ivvjerifika li l-inizjalizzazzjoni tirnexxi, li ż-żewġ għodod jidhru bl-iskemi u l-annotazzjonijiet tagħhom, imbagħad sejjaħhom b’inputs validi u mhux validi—stringa ta’ test vojta għandha tiġi miċħuda mill-iskema.
Esponi s-Server u Kkonnettjah
ChatGPT irid ikun jista’ jilħaq is-server tiegħek mill-internet. Waqt l-iżvilupp, tunnel huwa biżżejjed—id-dokumentazzjoni tissejjaħ ngrok:
ngrok http 8787
Tikseb indirizz HTTPS pubbliku. Ikkonnettjah bħal fil-Pass 1, inkluż il-mogħdija /mcp (pereżempju https://<subdomain>.ngrok.app/mcp), installa l-plugin li jirriżulta, imbagħad sejjaħlu b’@: “Save a note: call the vendor Monday.” ChatGPT juri d-dejta skambjata mal-għodda, u jħallik tivverifika l-inputs u l-outputs.
Tunnel ta’ żvilupp jaħdem biss għal provi: il-pubblikazzjoni teħtieġ endpoint HTTPS pubbliku u stabbli (Lezzjoni 5).
Erġa’ Tagħbja Wara Kull Bidla
ChatGPT jikkaxxja l-metadejta tas-server tiegħek. Wara kwalunkwe bidla fl-isem, id-deskrizzjoni, l-iskema, l-annotazzjoni, l-awtentikazzjoni, jew ir-riżorsa tal-interfaċċa: erġa’ ddispjega jew erġa’ starta s-server, iftaħ il-konnessjoni fuq chatgpt.com/plugins, agħżel Refresh, ivverifika li l-metadejta rreklamata nbidlet, imbagħad iftaħ konversazzjoni ġdida biex terġa’ tgħaddi mit-testijiet tiegħek. Li taqbeż dan il-pass ifisser li qed tittestja l-verżjoni l-qadima mingħajr ma tirrealizza.
Punti Ewlenin
- Oħloq plugin personali permezz ta’ Add custom MCP server, imbagħad sejjaħlu b’
@f’ChatGPT - SDKs uffiċjali:
@modelcontextprotocol/sdk(TypeScript) umcp(Python); iffissa v1 ma’ext-apps1.x biex issegwi l-eżempji ta’ OpenAI - Server minimu:
McpServer,registerTool, trasport streamable HTTP fuq/mcp - Uża l-MCP Inspector għall-ittestjar lokali, u tunnel għall-provi ta’ ChatGPT
- Wara kwalunkwe bidla fil-metadejta: Refresh, imbagħad ibda konversazzjoni ġdida