Dit første plugin
På denne side
Lektion omskrevet 3. november 2026 baseret på siderne Quickstart, MCP server and UI quickstart og Connect and test your plugin i OpenAI’s plugindokumentation. Det tidligere eksempel med en “vejr-app på 30 minutter” stolede på et ikke-eksisterende SDK. Vi verificerede npm-pakkeversioner den 3. november 2026:
@modelcontextprotocol/ext-apps2.x bygger på MCP SDK v2, mens OpenAI’s eksempler bruger v1. Kilder: Quickstart · MCP server and UI quickstart · Connect and test.
To trin
Først forbinder du en eksisterende MCP-server for at se hele ChatGPT-workflowet uden at skrive en eneste linje kode. Derefter skriver du din egen server, tester den lokalt og forbinder den på samme måde.
Trin 1: Et personligt plugin på fem minutter
OpenAI tilbyder en offentlig, ikke-autentificeret eksempel-MCP-server, der eksponerer et enkelt skrivebeskyttet værktøj: roll_dice.
- Gå til ChatGPT Plugins, vælg knappen +, og vælg derefter Add custom MCP server.
- Indtast et navn, og sæt Server URL til
https://tinymcp.dev/api/moldy-aloof-zettabyte/mcp. Vælg No authentication. - Læs advarslen om risici, vælg I understand and want to continue, og klik derefter på Create as a plugin.
- Pluginet vises på din liste over personlige plugins: åbn det, og installer det ved hjælp af knappen +.
- Vend tilbage til ChatGPT’s startskærm, skift fra fanen Chat til Work, start en ny samtale, tast
@, og vælg dit plugin. - Bed det om at kaste en tyvesidet terning: det skal kalde
roll_dicepræcis én gang medsidessat til 20 og returnere en værdi mellem 1 og 20.
Stop ikke ved den ideelle situation. Prøv forskellige terningestørrelser, ugyldige værdier og anmodninger, der ikke bør udløse noget værktøj. Denne refleks driver resten af kurset: når modellen vælger det forkerte værktøj eller varierer sine argumenter, skal du finjustere værktøjets beskrivelse og skema. Bemærk også, at dine konto- eller workspace-politikker styrer tilføjelsen af brugerdefinerede MCP-servere: i en organisation kan denne mulighed være begrænset.
Trin 2: Din egen server
Installer de officielle SDK’er
Der findes officielle protokol-SDK’er til TypeScript (@modelcontextprotocol/sdk) og Python (mcp). Dette kursus følger OpenAI’s eksempler, skrevet i TypeScript ved hjælp af SDK v1. Fastlås dine versioner: pr. september 2026 afhænger @modelcontextprotocol/ext-apps 2.x – grænsefladepakken, du tilføjer i lektion 6 – af de nye v2 SDK-pakker (@modelcontextprotocol/server…), som er inkompatible med v1-imports.
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 tilføjer "type": "module" til package.json, hvilket er påkrævet for serverens import-sætninger.
Skriv serveren
Denne server passer i en enkelt fil, server.js. Den gemmer noter i hukommelsen og eksponerer to værktøjer: ét til læsning og ét til skrivning, adskilt som anbefalet i lektion 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 = []; // eksempel på data i hukommelsen: udskift med din egen lagring
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;
}
// Stateless mode: new server and transport per request
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`));
Tre detaljer er vigtige. Hvert værktøj definerer en titel, en beskrivelse af hensigten, skemaer og nøjagtige annotationer: dette er dets „profil” for modellen. Hvert resultat kombinerer structuredContent, som modellen kan genbruge, og content, en kort tekstbesked. Endelig returnerer enhver adresse anden end /mcp en 404: OpenAI’s eksempel gør dette for OAuth-opdagelsesruter, som du endnu ikke bruger, hvilket forhindrer ChatGPT i at vise 502-fejl under dine ikke-autentificerede tests. Det samme eksempel tilføjer et svar til den foreløbige CORS-anmodning (OPTIONS) og en GET / til sundhedsforespørgsler; inkluder disse, hvis din hosting forventer dem.
Test lokalt med MCP Inspector
node server.js
npx @modelcontextprotocol/inspector@latest
Vælg Streamable HTTP i Inspector, indtast http://localhost:8787/mcp, og opret forbindelse. Verificér, at initialiseringen lykkes, at begge værktøjer vises med deres skemaer og annotationer, og kald dem derefter med gyldige og ugyldige input – en tom tekststreng skal afvises af skemaet.
Eksponér serveren, og forbind den
ChatGPT skal kunne nå din server fra internettet. Under udviklingen er en tunnel tilstrækkelig – dokumentationen nævner ngrok:
ngrok http 8787
Du får en offentlig HTTPS-adresse. Forbind den som i trin 1, inklusive stien /mcp (for eksempel https://<subdomain>.ngrok.app/mcp), installer det resulterende plugin, og kald det derefter med @: „Gem en note: ring til leverandøren på mandag.” ChatGPT viser de data, der udveksles med værktøjet, så du kan verificere input og output.
En udviklingstunnel fungerer kun til forsøg: offentliggørelse kræver et stabilt, offentligt HTTPS-endepunkt (lektion 5).
Genindlæs efter hver ændring
ChatGPT cacher din servers metadata. Efter enhver ændring af navn, beskrivelse, skema, annotation, autentificering eller grænsefladeressource: genudgiv eller genstart serveren, åbn forbindelsen på chatgpt.com/plugins, vælg Refresh, verificér, at de annoncerede metadata er ændret, og åbn derefter en ny samtale for at genkøre dine tests. Hvis du springer dette trin over, tester du den gamle version uden at vide det.
Vigtige pointer
- Opret et personligt plugin via Add custom MCP server, og kald det derefter med
@i ChatGPT - Officielle SDK’er:
@modelcontextprotocol/sdk(TypeScript) ogmcp(Python); fastlås v1 medext-apps1.x for at følge OpenAI’s eksempler - Minimal server:
McpServer,registerTool, streamable HTTP-transport på/mcp - Brug MCP Inspector til lokal test, en tunnel til ChatGPT-forsøg
- Efter enhver metadataændring: Refresh, og start derefter en ny samtale