Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Do Chéad Bhreiseán

Ceacht 4 as 14 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Dhá Chéim
  2. Céim 1: Breiseán Pearsanta i gCúig Nóiméad
  3. Céim 2: Do Fhreastalaí Féin
  4. Athlódáil Tar éis Gach Athraithe
  5. Príomhphointí

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

  1. Téigh go dtí Breiseáin ChatGPT, roghnaigh an cnaipe +, agus ansin roghnaigh Add custom MCP server.
  2. Cuir isteach ainm agus socraigh an Server URL go https://tinymcp.dev/api/moldy-aloof-zettabyte/mcp. Roghnaigh No authentication.
  3. Léigh an rabhadh riosca, roghnaigh I understand and want to continue, agus ansin cliceáil Create as a plugin.
  4. Feicfidh tú an breiseán i do liosta breiseán pearsanta: oscail é agus suiteáil é ag baint úsáide as an gcnaipe +.
  5. 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.
  6. Iarr air ciúb fiche taobh a rolladh: ba chóir go nglaofadh sé roll_dice uair amháin go díreach le sides socraithe 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) agus mcp (Python); socraigh v1 le ext-apps 1.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