Do Chéad Bhreiseán
Ar an leathanach seo
An ceacht athscríofa an 3 Samhain, 2026 bunaithe ar na leathanaigh Quickstart, MCP server and UI quickstart, agus Connect and test your plugin i ndoiciméadú Breiseáin OpenAI. Bhí an sampla roimhe seo “feidhmchlár aimsire i 30 nóiméad” ag brath ar SDK nach raibh ann. Rinneamar seiceáil ar leaganacha pacáiste npm an 3 Samhain, 2026: tá
@modelcontextprotocol/ext-apps2.x tógtha ar MCP SDK v2, ach úsáideann samplaí OpenAI v1. Foinse: Quickstart · MCP server and UI quickstart · Connect and test.
Dhá Chéim
Ar dtús, nascfaidh tú freastalaí MCP atá ann cheana féin chun an sruth oibre iomlán ChatGPT a fheiceáil gan aon líne cód a scríobh. Ina dhiaidh sin, scríobhfaidh tú do fhreastalaí féin, déanfaidh tú tástáil air go logánta, agus nascfaidh tú é ar an mbealach céanna.
Céim 1: Breiseán Pearsanta i gCúig Nóiméad
Soláthraíonn OpenAI sampla poiblí, gan fíordheimhniú, de fhreastalaí MCP a nochtann uirlis amháin inléite amháin: roll_dice.
- Téigh go dtí Breiseáin ChatGPT, roghnaigh an cnaipe +, agus ansin roghnaigh Add custom MCP server.
- Cuir isteach ainm agus socraigh an Server URL go
https://tinymcp.dev/api/moldy-aloof-zettabyte/mcp. Roghnaigh No authentication. - Léigh an rabhadh riosca, roghnaigh I understand and want to continue, agus ansin cliceáil Create as a plugin.
- Feicfidh tú an breiseán i do liosta breiseán pearsanta: oscail é agus suiteáil é ag baint úsáide as an gcnaipe +.
- Fill ar an bpríomhscáileán ChatGPT, athraigh ón gcluaisín Chat go Work, tosaigh comhrá nua, clóscríobh
@, agus roghnaigh do bhreiseán. - Iarr air ciúb fiche taobh a rolladh: ba chóir go nglaofadh sé
roll_diceuair amháin go díreach lesidessocraithe go 20 agus go dtabharfadh sé luach idir 1 agus 20 ar ais.
Ná stop ag an gcosán sona. Bain triail as méideanna éagsúla ciúba, luachanna neamhbhailí, agus iarratais nach ba chóir aon uirlis a spreagadh. Is é an freagairt reflex seo a thiomáineann an chuid eile den chúrsa: nuair a roghnaíonn an tsamhail an uirlis mhícheart nó nuair a athraíonn sí a hargóintí, ní mór duit cur síos agus scéima na huirlise a bheachtú. Tabhair faoi deara freisin go rialaíonn polasaithe do chuntais nó d’fhospaithe cur le freastalaithe MCP saincheaptha: in eagraíocht, d’fhéadfadh an rogha seo a bheith teoranta.
Céim 2: Do Fhreastalaí Féin
Na SDKanna Oifigiúla a Shuiteáil
Tá SDKanna prótacail oifigiúla ann do TypeScript (@modelcontextprotocol/sdk) agus do Python (mcp). Leanann an cúrsa seo samplaí OpenAI, atá scríofa i TypeScript ag baint úsáide as SDK v1. Socraigh do leaganacha go docht: ó Mheán Fómhair 2026, braitheann @modelcontextprotocol/ext-apps 2.x—an pacáiste comhéadain a chuirfidh tú leis i gCeacht 6—ar na pacáistí SDK v2 nua (@modelcontextprotocol/server…), atá neamh-chomhoiriúnach le hiompórtálacha 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
Cuireann npm pkg set type=module "type": "module" le package.json, rud atá riachtanach do ráitis import an fhreastalaí.
An Freastalaí a Scríobh
Oireann an freastalaí seo i gcomhad amháin, server.js. Coinníonn sé nótaí sa chuimhne agus nochtann sé dhá uirlis: ceann amháin chun léamh agus ceann amháin chun scríobh, deighilte mar a mholtar i gCeacht 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 = []; // sampla sonraí sa chuimhne: cuir do stóráil féin ina n-áit
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;
}
// Mód gan staid: freastalaí agus iompar nua in aghaidh gach iarratais
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`));
Tá trí mhionsonraí tábhachtach ann. Dearbhaíonn gach uirlis teideal, cur síos ar an rún, scéimí, agus nótaí beachta: is é seo a “phróifíl” don tsamhail. Comhcheanglaíonn gach toradh structuredContent, atá in-athúsáidte ag an tsamhail, agus content, teachtaireacht ghairid téacs. Ar deireadh, filleann aon seoladh seachas /mcp ar 404: déanann sampla OpenAI é seo do bhealaí aimsithe OAuth nach bhfuil tú ag úsáid fós, rud a choscann ar ChatGPT earráidí 502 a thaispeáint le linn do thástálacha gan fíordheimhniú. Cuireann an sampla céanna freagra leis don iarratas CORS réamhthionscnaimh (OPTIONS) agus GET / do bhraiteoirí sláinte; cuir na cinn seo san áireamh má tá súil ag do óstáil leo.
Tástáil go Logánta le MCP Inspector
node server.js
npx @modelcontextprotocol/inspector@latest
San Inspector, roghnaigh Streamable HTTP, cuir isteach http://localhost:8787/mcp, agus nasc. Dearbhaigh go n-éiríonn leis an tionscnaimh, go bhfeictear an dá uirlis lena scéimí agus a nótaí, agus ansin glaoidh orthu le hionchuir bhailí agus neamhbhailí—caithfidh an scéima teaghrán téacs folamh a dhiúltú.
An Freastalaí a Nochtadh agus a Nascadh
Ní mór do ChatGPT teacht ar do fhreastalaí ón idirlíon. Le linn forbartha, is leor tollán—luaann an doiciméadú ngrok:
ngrok http 8787
Gheobhaidh tú seoladh HTTPS poiblí. Nasc é mar i gCéim 1, lena n-áirítear an cosán /mcp (mar shampla https://<subdomain>.ngrok.app/mcp), suiteáil an breiseán a thagann as, agus ansin glaoidh air le @: “Sábháil nóta: glaoigh ar an díoltóir Dé Luain.” Taispeánfaidh ChatGPT na sonraí a malartaíodh leis an uirlis, rud a ligeann duit ionchuir agus aschuir a fhíorú.
Ní oibríonn tollán forbartha ach do thrialacha: éilíonn foilsiú críochphointe HTTPS poiblí cobhsaí (Ceacht 5).
Athlódáil Tar éis Gach Athraithe
Déanann ChatGPT meiteashonraí do fhreastalaí a chur i dtaisce. Tar éis aon athrú ar an ainm, an cur síos, an scéima, an nóta, an fíordheimhniú, nó an acmhainn comhéadain: ath-imscar nó atosú an freastalaí, oscail an nasc ag chatgpt.com/plugins, roghnaigh Refresh, dearbhaigh go bhfuil athrú tagtha ar na meiteashonraí fógartha, agus ansin oscail comhrá nua chun do thástálacha a athdhéanamh. Má fhágann tú an céim seo ar lár, ciallaíonn sé go bhfuil tú ag tástáil an leagan sean gan a bheith ar an eolas faoi.
Príomhphointí
- Cruthaigh breiseán pearsanta trí Add custom MCP server, agus ansin glaoidh air le
@i ChatGPT - SDKanna oifigiúla:
@modelcontextprotocol/sdk(TypeScript) agusmcp(Python); socraigh v1 leext-apps1.x chun samplaí OpenAI a leanúint - Freastalaí íosta:
McpServer,registerTool, iompar streamable HTTP ar/mcp - Úsáid MCP Inspector le haghaidh tástála logánta, tollán le haghaidh trialacha ChatGPT
- Tar éis aon athraithe meiteashonraí: Refresh, agus ansin tosaigh comhrá nua