Το πρώτο σας πρόσθετο
Σε αυτήν τη σελίδα
Μάθημα αναθεωρημένο στις 3 Νοεμβρίου 2026 με βάση τις σελίδες Quickstart, MCP server and UI quickstart και Connect and test your plugin της τεκμηρίωσης των πρόσθετων OpenAI. Το προηγούμενο παράδειγμα «εφαρμογή καιρού σε 30 λεπτά» βασιζόταν σε ένα ανύπαρκτο SDK. Επαληθεύσαμε τις εκδόσεις των πακέτων npm στις 3 Νοεμβρίου 2026: το
@modelcontextprotocol/ext-apps2.x βασίζεται στο MCP SDK v2, ενώ τα παραδείγματα της OpenAI χρησιμοποιούν το v1. Πηγές: Quickstart · MCP server and UI quickstart · Connect and test.
Δύο βήματα
Πρώτον, θα συνδέσετε έναν υπάρχοντα διακομιστή MCP για να δείτε την πλήρη ροή εργασίας του ChatGPT χωρίς να γράψετε ούτε μία γραμμή κώδικα. Στη συνέχεια, θα γράψετε τον δικό σας διακομιστή, θα τον δοκιμάσετε τοπικά και θα τον συνδέσετε με τον ίδιο τρόπο.
Βήμα 1: Ένα προσωπικό πρόσθετο σε πέντε λεπτά
Η OpenAI παρέχει έναν δημόσιο, μη πιστοποιημένο παραδειγματικό διακομιστή MCP που εκθέτει ένα μόνο εργαλείο ανάγνωσης: roll_dice.
- Μεταβείτε στα Πρόσθετα ChatGPT, επιλέξτε το κουμπί + και στη συνέχεια επιλέξτε Προσθήκη προσαρμοσμένου διακομιστή MCP.
- Εισαγάγετε ένα όνομα και ορίστε το URL διακομιστή στο
https://tinymcp.dev/api/moldy-aloof-zettabyte/mcp. Επιλέξτε Χωρίς πιστοποίηση. - Διαβάστε την προειδοποίηση κινδύνου, επιλέξτε Κατανοώ και θέλω να συνεχίσω και κάντε κλικ στο Δημιουργία ως πρόσθετο.
- Το πρόσθετο εμφανίζεται στη λίστα των προσωπικών σας πρόσθετων: ανοίξτε το και εγκαταστήστε το χρησιμοποιώντας το κουμπί +.
- Επιστρέψτε στην αρχική οθόνη του ChatGPT, μεταβείτε από την καρτέλα Chat στην καρτέλα Work, ξεκινήστε μια νέα συνομιλία, πληκτρολογήστε
@και επιλέξτε το πρόσθετό σας. - Ζητήστε του να ρίξει ένα εικοσάπλευρο ζάρι: θα πρέπει να καλέσει το
roll_diceακριβώς μία φορά με τοsidesορισμένο σε 20 και να επιστρέψει μια τιμή μεταξύ 1 και 20.
Μην αρκεστείτε στην ιδανική περίπτωση. Δοκιμάστε διαφορετικά μεγέθη ζαριού, μη έγκυρες τιμές και αιτήματα που δεν θα έπρεπε να ενεργοποιήσουν κανένα εργαλείο. Αυτός ο αντανακλαστικός έλεγχος καθοδηγεί το υπόλοιπο μάθημα: όταν το μοντέλο επιλέγει το λάθος εργαλείο ή μεταβάλλει τα ορίσματά του, πρέπει να βελτιώσετε την περιγραφή και το σχήμα του εργαλείου. Σημειώστε επίσης ότι οι πολιτικές του λογαριασμού ή του χώρου εργασίας σας διέπουν την προσθήκη προσαρμοσμένων διακομιστών MCP: σε έναν οργανισμό, αυτή η επιλογή ενδέχεται να είναι περιορισμένη.
Βήμα 2: Ο δικός σας διακομιστής
Εγκατάσταση των επίσημων SDK
Υπάρχουν επίσημα SDK πρωτοκόλλου για TypeScript (@modelcontextprotocol/sdk) και Python (mcp). Αυτό το μάθημα ακολουθεί τα παραδείγματα της OpenAI, γραμμένα σε TypeScript χρησιμοποιώντας το SDK v1. Καθορίστε τις εκδόσεις σας: από τον Σεπτέμβριο του 2026, το @modelcontextprotocol/ext-apps 2.x—το πακέτο διεπαφής που θα προσθέσετε στο Μάθημα 6—βασίζεται στα νέα πακέτα SDK v2 (@modelcontextprotocol/server…), τα οποία είναι ασύμβατα με τις εισαγωγές 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
Η εντολή npm pkg set type=module προσθέτει το "type": "module" στο package.json, το οποίο απαιτείται για τις δηλώσεις import του διακομιστή.
Συγγραφή του διακομιστή
Αυτός ο διακομιστής χωράει σε ένα μόνο αρχείο, το server.js. Διατηρεί σημειώσεις στη μνήμη και εκθέτει δύο εργαλεία: ένα για ανάγνωση και ένα για εγγραφή, διαχωρισμένα όπως συνιστάται στο Μάθημα 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 = []; // παράδειγμα δεδομένων στη μνήμη: αντικαταστήστε με τη δική σας αποθήκευση
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;
}
// Λειτουργία χωρίς κατάσταση: νέος διακομιστής και μεταφορά ανά αίτημα
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`));
Τρεις λεπτομέρειες έχουν σημασία. Κάθε εργαλείο δηλώνει έναν τίτλο, μια περιγραφή πρόθεσης, σχήματα και ακριβείς σημειώσεις: αυτό αποτελεί το «προφίλ» του για το μοντέλο. Κάθε αποτέλεσμα συνδυάζει το structuredContent, το οποίο είναι επαναχρησιμοποιήσιμο από το μοντέλο, και το content, ένα σύντομο μήνυμα κειμένου. Τέλος, οποιαδήποτε διεύθυνση εκτός του /mcp επιστρέφει σφάλμα 404: το παράδειγμα της OpenAI το κάνει αυτό για διαδρομές ανακάλυψης OAuth που δεν χρησιμοποιείτε ακόμη, αποτρέποντας το ChatGPT από την εμφάνιση σφαλμάτων 502 κατά τις μη πιστοποιημένες δοκιμές σας. Το ίδιο παράδειγμα προσθέτει μια απόκριση για το προκαταρκτικό αίτημα CORS (OPTIONS) και ένα GET / για ανιχνεύσεις υγείας· συμπεριλάβετε τα εάν η φιλοξενία σας τα αναμένει.
Τοπικός έλεγχος με το MCP Inspector
node server.js
npx @modelcontextprotocol/inspector@latest
Στο Inspector, επιλέξτε Streamable HTTP, εισαγάγετε το http://localhost:8787/mcp και συνδεθείτε. Επαληθεύστε ότι η αρχικοποίηση succeeds, ότι και τα δύο εργαλεία εμφανίζονται με τα σχήματα και τις σημειώσεις τους, και στη συνέχεια καλέστε τα με έγκυρες και μη έγκυρες εισόδους—μια κενή συμβολοσειρά κειμένου πρέπει να απορριφθεί από το σχήμα.
Έκθεση του διακομιστή και σύνδεσή του
Το ChatGPT πρέπει να μπορεί να προσεγγίσει τον διακομιστή σας από το διαδίκτυο. Κατά την ανάπτυξη, μια σήραγγα αρκεί—η τεκμηρίωση αναφέρει το ngrok:
ngrok http 8787
Θα λάβετε μια δημόσια διεύθυνση HTTPS. Συνδέστε την όπως στο Βήμα 1, συμπεριλαμβάνοντας τη διαδρομή /mcp (για παράδειγμα https://<subdomain>.ngrok.app/mcp), εγκαταστήστε το προκύπτον πρόσθετο και στη συνέχεια επικαλεστείτε το με @: «Αποθήκευσε μια σημείωση: κάλεσε τον προμηθευτή τη Δευτέρα». Το ChatGPT εμφανίζει τα δεδομένα που ανταλλάσσονται με το εργαλείο, επιτρέποντάς σας να επαληθεύσετε τις εισόδους και τις εξόδους.
Μια σήραγγα ανάπτυξης λειτουργεί μόνο για δοκιμές: η δημοσίευση απαιτεί ένα σταθερό, δημόσιο σημείο τελικού HTTPS (Μάθημα 5).
Επαναφόρτωση μετά από κάθε αλλαγή
Το ChatGPT κρατάει στη μνήμη cache τα μεταδεδομένα του διακομιστή σας. Μετά από οποιαδήποτε αλλαγή στο όνομα, την περιγραφή, το σχήμα, τη σημείωση, την πιστοποίηση ή τον πόρο διεπαφής: αναπτύξτε ξανά ή επανεκκινήστε τον διακομιστή, ανοίξτε τη σύνδεση στο chatgpt.com/plugins, επιλέξτε Ανανέωση, επαληθεύστε ότι τα διαφημιζόμενα μεταδεδομένα έχουν αλλάξει και στη συνέχεια ανοίξτε μια νέα συνομιλία για να εκτελέσετε ξανά τις δοκιμές σας. Η παράλειψη αυτού του βήματος σημαίνει ότι δοκιμάζετε την παλιά έκδοση χωρίς να το αντιλαμβάνεστε.
Βασικά σημεία
- Δημιουργήστε ένα προσωπικό πρόσθετο μέσω της επιλογής Προσθήκη προσαρμοσμένου διακομιστή MCP και στη συνέχεια επικαλεστείτε το με
@στο ChatGPT - Επίσημα SDK:
@modelcontextprotocol/sdk(TypeScript) καιmcp(Python); καθορίστε την έκδοση v1 με τοext-apps1.x για να ακολουθήσετε τα παραδείγματα της OpenAI - Ελάχιστος διακομιστής:
McpServer,registerTool, μεταφορά streamable HTTP στο/mcp - Χρησιμοποιήστε το MCP Inspector για τοπικό έλεγχο και μια σήραγγα για δοκιμές στο ChatGPT
- Μετά από οποιαδήποτε αλλαγή μεταδεδομένων: Ανανέωση και στη συνέχεια ξεκινήστε μια νέα συνομιλία