Uw eerste plug-in
Op deze pagina
Les herschreven op 3 november 2026 op basis van de pagina’s Quickstart, MCP server and UI quickstart en Connect and test your plugin in de OpenAI Plug-ins-documentatie. Het eerdere voorbeeld “weer-app in 30 minuten” berustte op een niet-bestaande SDK. We hebben de npm-pakketversies geverifieerd op 3 november 2026:
@modelcontextprotocol/ext-apps2.x bouwt voort op MCP SDK v2, terwijl de voorbeelden van OpenAI v1 gebruiken. Bronnen: Quickstart · MCP server and UI quickstart · Connect and test.
Twee stappen
Eerst koppelt u een bestaande MCP-server om de volledige ChatGPT-workflow te zien zonder ook maar één regel code te schrijven. Vervolgens schrijft u uw eigen server, test u deze lokaal en koppelt u deze op dezelfde manier.
Stap 1: Een persoonlijke plug-in in vijf minuten
OpenAI biedt een openbare, niet-geauthenticeerde voorbeeld-MCP-server die één read-only tool exposeert: roll_dice.
- Ga naar ChatGPT Plugins, selecteer de knop + en kies vervolgens Add custom MCP server.
- Voer een naam in en stel de Server URL in op
https://tinymcp.dev/api/moldy-aloof-zettabyte/mcp. Selecteer No authentication. - Lees de risicowaarschuwing, selecteer I understand and want to continue en klik op Create as a plugin.
- De plug-in verschijnt in uw lijst met persoonlijke plug-ins: open deze en installeer hem met de knop +.
- Ga terug naar het startscherm van ChatGPT, schakel van het tabblad Chat naar Work, start een nieuw gesprek, typ
@en selecteer uw plug-in. - Vraag om een twintigvlakkige dobbelsteen te gooien: deze moet
roll_diceprecies één keer aanroepen metsidesingesteld op 20 en een waarde tussen 1 en 20 retourneren.
Stop niet bij het ideale scenario. Probeer verschillende dobbelsteenformaten, ongeldige waarden en verzoeken die geen enkele tool zouden moeten activeren. Deze reflex drijft de rest van de cursus: wanneer het model de verkeerde tool kiest of zijn argumenten varieert, moet u de beschrijving en het schema van de tool verfijnen. Houd er ook rekening mee dat uw account- of werkplekbeleid het toevoegen van aangepaste MCP-servers regelt: binnen een organisatie kan deze optie beperkt zijn.
Stap 2: Uw eigen server
Installeer de officiële SDK’s
Er bestaan officiële protocol-SDK’s voor TypeScript (@modelcontextprotocol/sdk) en Python (mcp). Deze cursus volgt de voorbeelden van OpenAI, geschreven in TypeScript met behulp van SDK v1. Leg uw versies vast: vanaf september 2026 is @modelcontextprotocol/ext-apps 2.x—het interfacepakket dat u in Les 6 toevoegt—afhankelijk van de nieuwe v2 SDK-pakketten (@modelcontextprotocol/server…), die incompatibel zijn met 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 voegt "type": "module" toe aan package.json, wat vereist is voor de import-instructies van de server.
Schrijf de server
Deze server past in één bestand, server.js. Het bewaart notities in het geheugen en exposeert twee tools: één voor lezen en één voor schrijven, gescheiden zoals aanbevolen in Les 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 = []; // voorbeeld van gegevens in het geheugen: vervang door uw eigen opslag
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 modus: nieuwe server en transport per verzoek
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`));
Drie details zijn belangrijk. Elke tool declareert een titel, een intentiebeschrijving, schema’s en exacte annotaties: dit is het “profiel” voor het model. Elk resultaat combineert structuredContent, herbruikbaar door het model, en content, een kort tekstbericht. Tot slot retourneert elk ander adres dan /mcp een 404: het voorbeeld van OpenAI doet dit voor OAuth-ontdekkingroutes die u nog niet gebruikt, waardoor ChatGPT geen 502-fouten toont tijdens uw niet-geauthenticeerde tests. Datzelfde voorbeeld voegt een respons toe voor het voorlopige CORS-verzoek (OPTIONS) en een GET / voor health-probes; neem deze op als uw hosting ze verwacht.
Lokaal testen met MCP Inspector
node server.js
npx @modelcontextprotocol/inspector@latest
Kies in de Inspector Streamable HTTP, voer http://localhost:8787/mcp in en maak verbinding. Verifieer dat de initialisatie slaagt, dat beide tools verschijnen met hun schema’s en annotaties, en roep ze vervolgens aan met geldige en ongeldige invoer—een lege tekstreeks moet door het schema worden geweigerd.
Stel de server beschikbaar en koppel deze
ChatGPT moet uw server vanaf internet kunnen bereiken. Tijdens de ontwikkeling volstaat een tunnel—de documentatie noemt ngrok:
ngrok http 8787
U ontvangt een openbaar HTTPS-adres. Koppel dit zoals in Stap 1, inclusief het pad /mcp (bijvoorbeeld https://<subdomain>.ngrok.app/mcp), installeer de resulterende plug-in en roep deze vervolgens aan met @: “Sla een notitie op: bel de leverancier maandag.” ChatGPT toont de gegevens die met de tool zijn uitgewisseld, zodat u invoer en uitvoer kunt verifiëren.
Een ontwikkelingstunnel werkt alleen voor proeven: publiceren vereist een stabiel, openbaar HTTPS-eindpunt (Les 5).
Opnieuw laden na elke wijziging
ChatGPT cacheert de metagegevens van uw server. Na elke wijziging in de naam, beschrijving, het schema, de annotatie, de authenticatie of de interface-resource: implementeer de server opnieuw of start deze opnieuw, open de verbinding op chatgpt.com/plugins, selecteer Refresh, verifieer dat de geadverteerde metagegevens zijn gewijzigd en open vervolgens een nieuw gesprek om uw tests opnieuw uit te voeren. Als u deze stap overslaat, test u de oude versie zonder het te beseffen.
Belangrijkste punten
- Maak een persoonlijke plug-in via Add custom MCP server en roep deze vervolgens aan met
@in ChatGPT - Officiële SDK’s:
@modelcontextprotocol/sdk(TypeScript) enmcp(Python); leg v1 vast metext-apps1.x om de voorbeelden van OpenAI te volgen - Minimale server:
McpServer,registerTool, streamable HTTP-transport op/mcp - Gebruik MCP Inspector voor lokaal testen, een tunnel voor ChatGPT-proeven
- Na elke wijziging in metagegevens: Refresh en start vervolgens een nieuw gesprek