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

An Freastalaí MCP: Uirlisí, Torthaí, agus Imscaradh

Ceacht 5 as 14 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. An freastalaí, a chéannacht, agus a threoracha
  2. Uirlis amháin in aghaidh na gníomhaíochta
  3. Torthaí úsáideacha gan comhéadan
  4. Nótaí agus éiliú
  5. Ilchuntais agus eolas cuideachta
  6. An críochphointe a imscaradh
  7. Éabhlóid gan briseadh
  8. Cuimhneacháin slándála
  9. Príomhphointí

An ceacht athscríofa ar an 3 Samhain, 2026 bunaithe ar an leathanach Build an MCP server ó dhoiciméadú Breiseáin OpenAI agus ar chód MCP TypeScript SDK (1.32.2). Thug an ceacht roimhe seo cur síos ar “ghníomhartha” (defineAction, ActionError) ó SDK nach raibh ann riamh; is do uirlisí MCP a thagann an ról sin anois. Foinse: Build an MCP server · MCP TypeScript SDK.

An freastalaí, a chéannacht, agus a threoracha

Cruthaigh freastalaí MCP le hainm seasmhach agus leagan sonraithe. Le linn an tionscnaimh, is féidir leis réimse instructions a thabhairt ar ais a léann ChatGPT agus Codex in éineacht le meiteashonraí na n-uirlisí. Coinnigh an réimse seo do threoracha a bhaineann le gach uirlis—mar shampla, ord glaoige éigeantach nó teorainn ráta roinnte—agus coinnigh an t-ábhar lárnach laistigh de na chéad 512 carachtar. Ná déan cóip-ghreamú de chur síos ar uirlisí anseo, agus ná bí ag iarraidh pearsantacht an mhúnla a athrú.

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

const server = new McpServer(
  { name: "acme-projects", version: "1.0.0" },
  {
    instructions:
      "Before modifying a project, call get_project to confirm its ID and status.",
  }
);

Uirlis amháin in aghaidh na gníomhaíochta

Cruthaigh uirlis amháin do gach gníomh ar leith: list_projects, get_project, update_project, seachas uirlis ghinearálta amháin le líon mór mód. Comhcheanglaíonn gach uirlis ainm atá dírithe ar ghníomh, teideal inléite, cur síos a mhíníonn cathain a úsáid í, scéima ionchurtha sainráite, scéima aschurtha má thugann sí sonraí struchtúrtha ar ais, nótaí beachta, agus láimhseálaí a údaraíonn an t-iarratas sula ndéanann sé gníomh. Braitheann an múnla ar na meiteashonraí seo chun cinneadh a dhéanamh an dtugtar glaoch ar an uirlis agus conas a dhéantar é—caith leis mar chuid den taithí úsáideora.

import { z } from "zod";

const project = z.object({ id: z.string(), name: z.string(), status: z.enum(["active", "archived"]) });

server.registerTool(
  "get_project",
  {
    title: "View a project",
    description:
      "Use when the user wants details about a specific project in their Acme workspace. " +
      "Requires the ID returned by list_projects.",
    inputSchema: { id: z.string().min(1) },
    outputSchema: { project: project },
    annotations: { readOnlyHint: true, openWorldHint: false, destructiveHint: false },
  },
  async ({ id }, extra) => {
    const user = await authenticate(extra); // Your access control (Lesson 8)
    const found = await loadProject(user, id); // Your data access
    if (!found) {
      return {
        isError: true,
        content: [{ type: "text", text: `No project ${id} is accessible with this account.` }],
      };
    }
    return {
      structuredContent: { project: found },
      content: [{ type: "text", text: `Project "${found.name}" (${found.status}).` }],
    };
  }
);

Is iad authenticate agus loadProject do fheidhmeanna féin. Is é an pointe ríthábhachtach ná a suíomh: tarlaíonn údarú ar an bhfreastalaí, le gach iarratas. Ná bíodh muinín agat as an múnla chun cinneadh a dhéanamh an bhfuil cead ag úsáideoir teacht ar shonraí.

Torthaí úsáideacha gan comhéadan

Is féidir le toradh uirlise trí rud a iompar:

  • structuredContent: sonraí gonta is féidir leis an múnla a scrúdú agus a athúsáid i nglaoite ina dhiaidh sin;
  • content: téacs nó ábhar MCP eile a chuidíonn leis freagra a thabhairt;
  • _meta: sonraí atá beartaithe don chliant, atá i bhfolach ón múnla.

Tabhair ar ais dóthain faisnéise chun go bhféadfadh an múnla an obair a chríochnú gan comhpháirt amhairc, ag baint úsáide as IDanna seasmhacha is féidir le huirlisí ina dhiaidh sin a athúsáid. Tá dhá iompar SDK ar fiú a thabhairt faoi deara. Caithfidh uirlis a dhecláraíonn outputSchema structuredContent comhlíontach a thabhairt ar ais i ngach toradh rathúil; murach sin, caithfidh an SDK earráid bailíochtaithe. Cuirtear earráid ghnó—mar shampla, tionscadal in easnamh nó gníomh diúltaithe—in iúl le toradh a bhfuil isError: true air in éineacht le téacs míniúcháin is féidir leis an múnla a sheoladh ar ais chuig an úsáideoir; sáraíonn an cineál seo torthaí bailíochtú scéime aschurtha.

Ná cuir rúin, comharthaí rochtana, ná sonraí pearsanta nach gá isteach i dtoradh riamh, agus ná caith le _meta mar áit cheilte shábháilte: tá an réimse seo i bhfolach ón múnla, ach níl sé cosanta.

Nótaí agus éiliú

Caithfidh nótaí freagairt d’iompar iarbhír na huirlise: socraigh readOnlyHint ar true ach amháin mura féidir léis aon rud a mhodhnú, destructiveHint ar true má is féidir léis éifeacht dochúlaithe nó deacair a chur ar ais a chruthú, agus openWorldHint ar true má bhaineann sí leis an idirlíon poiblí nó le heintitis sheachtracha oscailte. Cuidíonn siad le ChatGPT agus Codex an t-iompar deimhnithe ceart a roghnú; ní chuirtear in ionad údarú, bailíochtú, ná loighic deimhnithe ar do fhreastalaí iad.

Nuair a bhíonn gá ag an bhfreastalaí le faisnéis struchtúrtha atá in easnamh ón nglao—mar shampla, dáta nó rogha idir dhá rogha—is féidir leis é a iarraidh trí éiliú, sásra prótacail MCP. Teorainn é seo leis an méid is féidir leis an úsáideoir a sholáthar go réasúnach; ná húsáid é riamh chun rúin a bhailiú ná chun gnáthúdarú a sheachaint.

Ilchuntais agus eolas cuideachta

Feabhsaíonn dhá chomhoiriúnacht roghnacha an comhtháthú. Chun cabhrú le húsáideoirí a nascann ilchuntais, nocht uirlis próifíle atá údaraithe, inléite amháin, agus marcáilte _meta["openai/profile"]: true. Úsáideann OpenAI é seo chun cuntais nasctha a aithint agus chun cabhrú le húsáideoirí idirdhealú a dhéanamh eatarthu. Díorthaítear an phróifíl ó chreidiúintí bailíochtaithe an iarratais, agus fanann gach glao teoranta do na creidiúintí sin.

Is féidir le gné eolas cuideachta ChatGPT do chuid uirlisí inléite amháin a úsáid. Chun breiseán a dhéanamh incháilithe mar fhoinse, cuir na scéimeanna ionchurtha caighdeánacha i bhfeidhm d’uirlisí search agus fetch, marcáil uirlisí inléite amháin eile le readOnlyHint: true, agus tabhair ar ais URLanna absalóideacha is féidir leis an úsáideoir a oscailt do fhoinsí ar gá don mhúnla lua a dhéanamh orthu.

An críochphointe a imscaradh

Éilíonn cur isteach poiblí freastalaí ag seoladh HTTPS seasmhach atá inrochtana go poiblí. Ní mór don chríochphointe seo iompar HTTP inshruthlaithe a thacaíocht, freagairt ag URL seasmhach (de ghnáth ag críochnú le /mcp), freastal ar éilimh moille agus infhaighteachta do do shreabha oibre, teacht ar do sheirbhísí agus do shonraí, teorainneacha údaraithe agus údarú a chaomhnú, agus logaí agus méadrachtaí a tháirgeadh do theipthe tionscnaimh agus glaoite uirlisí.

Ceadaíonn Tollán Slándáilte MCP OpenAI duit freastalaí príobháideach a nascadh le ChatGPT, ach ní shásaíonn sé ceanglais cur isteach poiblí, agus ní dhéanann tollán sealadach ná seoladh áitiúil é sin ach oiread. Má chaithfidh an freastalaí fanacht príobháideach, cuir seachfhreastalaí HTTPS poiblí os a chomhair: déanann mTLS arna bhainistiú ag OpenAI fíordheimhniú ar ChatGPT mar chliant, déanann OAuth 2.1 fíordheimhniú ar do chuid úsáideoirí, agus is féidir liosta ceadaithe IP—a chuimsíonn raonta a d’fhoilsigh OpenAI do cheanglóirí ChatGPT, a nuashonraítear go huathoibríoch—a chur leis, ach ní chuirtear in ionad údaraithe é riamh.

Sula dtéann tú beo: insteall creidiúintí trí bhainisteoir rúnda d’óstach, cumraigh an freastalaí údaraithe agus na hathsheoladh, socraigh amanna teorainn agus teorainneacha ráta d’uirlisí costasacha nó atá le feiceáil go seachtrach, bain freagairtí dífhabhtaithe agus sonraí pearsanta nach gá, agus fíoraigh nach bhfuil comharthaí ná torthaí íogaire sna logaí. Tar éis imscartha, athsheinn MCP Inspector i gcoinne an tseolta táirgeachta.

Éabhlóid gan briseadh

Coinnigh ainmneacha uirlisí foilsithe agus scéimeanna comhoiriúnach siar: cuir réimsí nó uirlisí leis, ach ná bris conarthaí atá ann cheana. Má athraíonn meiteashonraí, athnuaigh an nasc agus athsheinn do shraith meastóireachta sula gcuireann tú isteach é. Maidir le comhéadan, athraigh ID an acmhainn nuair a fhorbraíonn HTML, JavaScript, nó CSS ar bhealach a d’fhéadfadh comhpháirt chaisithe a bhriseadh.

Cuimhneacháin slándála

  • Níl ionchur uirlise ar bith muiníneach: bailíochtigh é agus forghníomhaigh údarú ar an bhfreastalaí
  • Éiligh deimhniú do scríbhinní ardbhuailte
  • Coinnigh rúin agus sonraí íogaire as meiteashonraí agus torthaí
  • Logáil dóthain chun fiosrúchán a dhéanamh, ach eisiaigh creidiúintí agus sonraí pearsanta nach gá
  • Cuir teorainn ráta ar ghníomhartha costasacha nó atá le feiceáil go seachtrach

Príomhphointí

  • Freastalaí ainmnithe, leaganaithe le instructions gairid, tras-ghearrtha
  • Uirlis amháin in aghaidh na gníomhaíochta, le teideal, cur síos ar rún, scéimeanna, nótaí, agus údarú sa láimhseálaí
  • structuredContent atá comhlíontach leis an scéima aschurtha, isError: true d’earráidí gnó, gan aon rud rúnda in _meta
  • Foilsiú: HTTPS seasmhach, poiblí trí HTTP inshruthlaithe; níl an Tollán Slándáilte MCP leordhóthanach
  • Conarthaí comhoiriúnacha siar agus IDanna acmhainne leaganaithe