لا يستطيع ChatGPT الوصول إلى localhost، لذلك يحتاج خادم MCP المحلي إلى نفق. تعرّف على أوامر ngrok وCloudflare الدقيقة، ونموذج الموصل في وضع المطوّر، والأخطاء التي تعيق أول استدعاء لأداة، والعادات التي تُبقي العنوان العام آمنًا، ومتى يتفوّق خادم مستضاف على النفق.
يعمل خادم MCP الخاص بك بشكل مثالي على localhost:3000. ثم تلصق ذلك العنوان في ChatGPT فتظهر رسالة خطأ. لا خلل في الشيفرة. يعمل ChatGPT داخل السحابة التابعة لشركة OpenAI، بينما يقع حاسوبك المحمول خلف جهاز توجيه لم يدعُه إلى الداخل قط. يسدّ نفق ChatGPT MCP هذه الفجوة: برنامج صغير على جهازك يفتح اتصالًا صادرًا إلى وسيط، ويمنحك الوسيط عنوان HTTPS عامًا، وكل طلب يرسله ChatGPT إلى هذا العنوان ينتقل عبر الاتصال المفتوح إلى خادمك المحلي.
يتبع هذا المقال ترتيب العمل الفعلي: ما يشترطه ChatGPT من خادم MCP بعيد، وخادم صغير يستحق الاختبار، وخياران للنفق مع أوامر دقيقة، ونموذج الاتصال داخل ChatGPT، والأخطاء التي تستنزف فترة بعد الظهر كاملة، والعادات التي تمنع تحوّل العنوان العام إلى مصدر خطر. تحتاج إلى حساب مجاني في خدمة النفق على الأكثر، ولا شيء أكثر من حاسوب محمول عادي.
💡 الخلاصة السريعة: قدّم نقطة نهاية MCP عبر Streamable HTTP، ووجّه النفق إلى ذلك المنفذ، والصق
https://<your-tunnel-host>/mcpفي نموذج الاتصال في وضع المطوّر داخل ChatGPT، وأبقِ العمليتين تعملان أثناء المحادثة.
تُبنى موصلات ChatGPT للخوادم التي تعمل على الإنترنت العام. لا يمكن لخادم يعمل عبر stdio، وهو النقل الذي يشغّل فيه العميل المكتبي برنامجك كعملية فرعية، أن يعمل هنا، لأن ChatGPT لا يملك طريقة لتشغيل أي عملية على حاسوبك. ما يستطيعه هو استدعاء نقطة نهاية HTTPS، وتسرد وثائق OpenAI بروتوكولين مدعومين: الأول Server-Sent Events والثاني Streamable HTTP. اختر Streamable HTTP ما لم يكن لديك سبب يمنعك، فهو حلّ محل نقل HTTP مع SSE القديم في مواصفة Model Context Protocol، وهو ما توصي به حزم SDK الحالية.
هناك سبب ثانٍ أبسط لفشل localhost. تعني الكلمة «هذا الجهاز» بالنسبة لمن يقرؤها. وعندما يحاول ChatGPT الوصول إلى http://localhost:3000، فإنه ينظر إلى خوادمه هو، ولا يجد شيئًا على المنفذ 3000، فيستسلم.
يقلب النفق اتجاه الاتصال. يتصل جهازك بمزوّد النفق صادرًا منه، وهو اتصال تسمح به كل أجهزة التوجيه المنزلية ومعظم جدران الحماية في المكاتب، ويُبقي هذا الاتصال مفتوحًا. يملك المزوّد اسم مضيف عامًا بشهادة TLS صالحة، ويدفع الطلبات الواردة عبر الاتصال المفتوح. عمليًا يمر الطلب الواحد بخمس خطوات:
https://abc123.ngrok-free.app/mcp.http://localhost:3000/mcp.مقارنةً بتوجيه المنافذ الكلاسيكي، تتخطى إعدادات جهاز التوجيه وخدمة DNS الديناميكي وتجديد الشهادات. كما تحصل على زر إيقاف: أغلق النفق فيتوقف العنوان العام عن العمل فورًا.
تقع الموصلات المخصصة لخوادم MCP البعيدة خلف وضع المطوّر. تدرجه وثائق OpenAI ضمن الحسابات التالية على الويب: Plus، Pro، Business، Enterprise، Education. في خطط مساحات العمل قد يحتاج مسؤول النظام إلى السماح به أولًا، فتحقّق من ذلك قبل أن تلوم خادمك.
تتغير أسماء القوائم بين الإصدارات. الآن يوجد المفتاح في الإعدادات، ضمن قسم التطبيقات، كمفتاح بعنوان وضع المطوّر قرب الأسفل. وضعته الإصدارات الأقدم تحت الموصلات. إذا لم تجده فابحث في لوحة الإعدادات عن الكلمة "developer".
| المتطلب | ماذا يعني عمليًا |
|---|---|
| خطة ChatGPT | Plus، Pro، Business، Enterprise أو Education، مستخدمة على الويب |
| النقل | Streamable HTTP (يعمل Server-Sent Events أيضًا) |
| العنوان | عنوان HTTPS عام ينتهي بمسار MCP، وغالبًا /mcp |
| المصادقة | OAuth، أو بلا مصادقة لاختبار مؤقت |
| النفق | ngrok أو Cloudflare Tunnel أو Tailscale Funnel |
| العمليات قيد التشغيل | خادمك والنفق، ويبقيان نشطين أثناء المحادثة |
تحتاج إلى شيء صغير تختبر به النفق. يعرض خادم TypeScript هذا أداة واحدة، في الوضع عديم الحالة، فلا توجد جلسات تضيع عند إعادة التشغيل. ثبّت الاعتماديات أولًا:
npm install @modelcontextprotocol/sdk express zod
npm install -D tsx typescript @types/express
ثم احفظ الملف باسم server.ts:
import express from "express";
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
import { z } from "zod";
const app = express();
app.use(express.json());
function buildServer() {
const server = new McpServer({ name: "local-notes", version: "1.0.0" });
server.tool(
"add_numbers",
"Use this when the user asks to add two numbers together.",
{ a: z.number(), b: z.number() },
async ({ a, b }) => ({ content: [{ type: "text", text: String(a + b) }] })
);
return server;
}
app.post("/mcp", async (req, res) => {
const server = buildServer();
const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
res.on("close", () => {
transport.close();
server.close();
});
await server.connect(transport);
await transport.handleRequest(req, res, req.body);
});
app.listen(3000, "127.0.0.1", () => console.log("MCP on http://127.0.0.1:3000/mcp"));
شغّله بالأمر npx tsx server.ts. ثلاثة تفاصيل مهمة. أولًا، المسار هو /mcp، وهذا المسار بالضبط هو ما ينتهي في نموذج ChatGPT. ثانيًا، يجعل sessionIdGenerator: undefined كل طلب مستقلًا، وهذا مناسب لنفق قد يُعاد تشغيله. ثالثًا، يبدأ وصف الأداة بعبارة "Use this when"، وهي عادة تساعد ChatGPT على اختيار الأداة الصحيحة، لأنه يختار الأدوات بقراءة هذه الجمل.
قبل أن يوجد أي نفق، تحقق من أن الخادم يرد على المصافحة:
curl -i http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'
يجب أن ترى استجابة HTTP 200 وردًّا يذكر local-notes. إذا فشل هذا محليًا فلن يصلحه أي نفق.
ثبّت ngrok بالأمر brew install ngrok على macOS، أو استخدم المثبّت من موقع ngrok على Windows أو Linux. ثم أضف الرمز من لوحة التحكم وشغّل النفق:
ngrok config add-authtoken YOUR_TOKEN
ngrok http 3000
تطبع الطرفية سطر إعادة توجيه مثل https://abc123.ngrok-free.app -> http://localhost:3000. أضف /mcp فيكون لديك عنوان الموصل. يوفّر ngrok أيضًا مفتشًا محليًا على http://127.0.0.1:4040 يسرد كل طلب واستجابة، وهو أسرع طريقة لترى ما أرسله ChatGPT فعلًا.
افتراضيًا يتغير العنوان كلما أُعيد تشغيل النفق. احجز نطاقًا ثابتًا مجانيًا من لوحة ngrok، ثم شغّل ngrok http --url=your-name.ngrok-free.app 3000 (الإصدارات الأقدم من العميل تستخدم --domain)، فيبقى عنوان الموصل ثابتًا بعد إعادة التشغيل ولا تعود إلى تعديله كل صباح.
إذا كنت تفضّل Cloudflare، فثبّت cloudflared وشغّل أمرًا واحدًا:
cloudflared tunnel --url http://localhost:3000
يطبع عنوانًا مثل https://random-words.trycloudflare.com. لا تحتاج الأنفاق السريعة إلى حساب، وهذه ما يجعلها جذابة وما يحدّ منها في الوقت نفسه: يكون اسم المضيف جديدًا في كل تشغيل، فتعيد لصقه في ChatGPT كل مرة. ويفيد المطوّرون أيضًا بأن الأنفاق السريعة قد تواجه صعوبة مع Server-Sent Events، ما يجعل Streamable HTTP الاقتران الأكثر أمانًا. للحصول على عنوان دائم، أنشئ نفقًا مسمّى مرتبطًا بنطاق تملكه.
| الخيار | جهد الإعداد | ثبات العنوان | الأنسب في |
|---|---|---|---|
| حساب ngrok المجاني | حساب ورمز | عشوائي ما لم تحجز نطاقًا ثابتًا | اختبار أول سريع |
| نفق Cloudflare السريع | أمر واحد، دون تسجيل دخول | جديد في كل تشغيل | عروض مؤقتة |
| نفق Cloudflare المسمّى | نطاق وتسجيل دخول | ثابت | العمل اليومي |
| Tailscale Funnel | تثبيت Tailscale | اسم مضيف ثابت ضمن tailnet الخاص بك | الإعدادات المستخدمة أصلًا مع Tailscale |
للاختبار الأول، استخدم ngrok أو نفقًا سريعًا. للاستخدام اليومي، يهم ثبات العنوان أكثر من أي ميزة في ذلك الجدول.
https://abc123.ngrok-free.app/mcp. الخطأ الأكثر شيوعًا هو إدخال اسم المضيف وحده دون /mcp.يتصل ChatGPT الآن بعنوانك، ويُجري مصافحة MCP، ويسرد الأدوات التي يجدها. رؤية add_numbers على تلك الشاشة تعني أن السلسلة كاملة تعمل: ChatGPT والنفق وخادمك.
ابدأ محادثة جديدة، وافتح قائمة +، واختر المزيد، ثم اختر وضع المطوّر، وفعّل تطبيقك. بعد ذلك اطلب شيئًا يحتاجه: "استخدم Local Notes لإضافة 19 و 23."
يعرض ChatGPT استدعاء الأداة الذي يريد تنفيذه. الأدوات للقراءة فقط يمكن أن تعمل بحرية، بينما الأدوات التي تكتب البيانات تطلب تأكيدًا صريحًا، لذا وافق على الاستدعاء وراقب ثلاثة أماكن في الوقت نفسه:
حين تتطابق الأماكن الثلاثة، يكون لديك نفق ChatGPT MCP يعمل، وقالب لكل أداة تضيفها لاحقًا.
عندما يرفض ChatGPT حفظ التطبيق أو يبلغ بأنه تعذّر الوصول إلى الخادم، راجع هذه القائمة قبل تغيير أي شيء في الشيفرة:
ngrok http 3000 لا يعمل إلا إذا كان خادمك يستمع على المنفذ 3000.ثم كرّر اختبار المصافحة المحلي على العنوان العام. إذا فشل هناك لكنه نجح على localhost، فالعطل يقع بين النفق وخادمك، وليس داخل ChatGPT أبدًا:
curl -i https://abc123.ngrok-free.app/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'
هناك مشكلتان تبدوان كأخطاء برمجية وليستا كذلك.
أدوات قديمة. يخزّن ChatGPT قائمة الأدوات عند إنشاء التطبيق. إذا أضفت أداة أو غيّرت اسمها أو أعدت صياغتها، تبقى المحادثة تعرض النسخة القديمة حتى تحدّث الموصل من صفحة إعداداته أو تعيد إنشاءه. كلما رفضت أداة جديدة الظهور، فحدّث أولًا.
فحوص ترويسة Host. تتحقق بعض الأطر، وبعض مساعدات SDK لبروتوكول MCP، من ترويسة Host لصد هجمات DNS rebinding. يصل الطلب عبر النفق ويحمل اسم مضيف النفق بدلًا من localhost، لذا قد يرد خادمك بالرمز 403 أو 421. أضف اسم مضيف النفق إلى المضيفين المسموح بهم. تتغير أسماء مضيفي الأنفاق السريعة مع كل تشغيل، لذا اسمح بلاحقة مثل .trycloudflare.com بدلًا من تعطيل الفحص.
| الأعراض | السبب المرجّح | الحل |
|---|---|---|
| خطأ أثناء حفظ التطبيق | مسار خاطئ أو الخادم متوقف | شغّل فحص curl للمصافحة على العنوان العام |
| كان يعمل أمس وتوقف اليوم | تغيّر اسم مضيف النفق | حدّث الموصل أو احجز نطاقًا ثابتًا |
| 403 أو 421 من خادمك | التحقق من ترويسة Host | اسمح باسم مضيف النفق |
| أداة جديدة غير ظاهرة في المحادثة | قائمة أدوات مخزّنة مؤقتًا | حدّث الموصل أو أعد إنشاءه |
| انتهت مهلة استدعاء الأداة | أداة بطيئة خلف النفق | أعد الرد مبكرًا وأبقِ الاستدعاءات بضع ثوانٍ |
أي شخص يحصل على عنوان نفقك يستطيع استدعاء خادمك ما لم يوقفه شيء ما. الاسم المضيف العشوائي مجرّد غموض لا حماية، وهو يظهر في السجلات ولقطات الشاشة وسجل المتصفح. استخدم OAuth على الخادم، أو ضع طبقة وصول أمام النفق: كل من Cloudflare Access وسياسات حركة ngrok موجودة لهذا الغرض تحديدًا. اربط خادمك بالعنوان 127.0.0.1 كما يفعل الكود النموذجي، بحيث يستطيع عميل النفق على جهازك وحده الوصول إليه مباشرة.
الأداة وعد بما يجوز للنموذج أن يفعله على جهازك. اجعلها صغيرة:
Ctrl+C حين تنتهي. العنوان العام الخامل ليس فيه إلا الضرر.النفق هو الأداة المناسبة للبناء والتصحيح. أما للاستخدام اليومي، فيزيل الخادم المستضاف فئة كاملة من المشكلات، لأنه يعيش أصلًا على عنوان عام: لا حاسوب محمول يجب إبقاؤه مستيقظًا، ولا اسم مضيف لإعادة لصقه، ولا منفذ يُنسى.
يعمل PicassoIA بهذه الطريقة في جانب API. تعمل واجهة API الخاصة بالمطورين على https://api.picassoia.com/v1 مع نقاط نهاية بأسلوب Replicate: تنشئ تنبؤًا، ثم تستعلم عن حالته، ثم تجلب النتيجة. تُدار اتصالات MCP من حسابك على picassoia.com/en/mcp/accounts بعد تسجيل الدخول، ويمكن للحساب تشغيل ما يصل إلى 5 تنبؤات في الوقت نفسه، مشتركةً بين توكنات واتصالات MCP. راجع صفحة PicassoIA API للاطلاع على قواعد الوصول الحالية قبل أن تبني عليها.
يتطلب تصحيح خادم MCP الكثير من الكتابة: أوصاف الأدوات، ومخططات JSON، وشروح الأخطاء. يُعد GPT 5.4 شريكًا جيدًا لتلك المهمة. إليك سير عمل يناسب هذا المقال:
نصائح المعاملات: الصق مخططات حقيقية بدلًا من وصفها، وغيّر شيئًا واحدًا في كل أمر، واجعل كل طلب مقتصرًا على أداة واحدة. وللحصول على رأي ثانٍ في الشيفرة المعقدة، شغّل الأمر نفسه عبر Claude Sonnet 5 أو GPT 5.6 Sol وقارن الإجابات.
💡 نصيحة: حين يختلف نموذجان حول سبب فشل طلب ما، صدّق الذي يشير إلى سطر يمكنك التحقق منه في مفتش ngrok.
بعد أن يعمل خادمك، ستحتاج إلى توثيقه أو عرضه أو وضعه في README، ويحتاج المنشور إلى مرئيات. كل صورة في هذا المقال مولّدة، لم تُلتقط بكاميرا: يسمّي كل أمر نصي موضوعًا وبيئة واتجاه الضوء وعدسة ونوع الفيلم الفوتوغرافي. هذه الوصفة تصلح لأي موضوع تطرحه.
افتح PicassoIA، واختر نموذج صور، وجرّب أمرًا نصيًا لمشروعك الخاص. إذا لم تكفِ الصورة الثابتة، فيمكن لنموذج تحويل النص إلى فيديو أن يحوّل الفكرة نفسها إلى حركة. ابدأ بمشهد واحد من إعدادك أنت، وانظر إلى مدى اقتراب النتيجة الأولى مما أردت.
اختر لغتك
