بريد MCP: وكيل الذكاء الاصطناعي يفتح صندوقه ويؤكد تسجيله

ما يحتاجه الوكيل ولا تمنحه إياه REST API

توجد REST API على هذا الموقع، وأي مبرمج يدمجها سيبلي حسنًا. أما الوكيل فلن يفعل: فهو لا يستطيع فتح المرجع، وتحديد أي نقطة طرفية من ثلاث يريدها، وكتابة طلب يدويًا بسلسلة الاستعلام الصحيحة. إنه يسأل خادمًا عمّا يستطيع فعله، فيتلقى مخططات مقروءة آليًا، ويستدعي واحدًا منها.

لذا فكل ما تقوم به الخدمة مكشوف مرة ثانية، على هيئة أدوات. ستة منها، ولا حالة يجب إدارتها بين الاستدعاءات:

يجيب الخادم أيضًا عن initialize بفقرة قصيرة من التعليمات، تُمرّرها معظم العملاء مباشرة إلى النموذج. لذا يصل الوكيل وهو يعرف مسبقًا وظيفة هذه الخدمة وتحذيرها الحقيقي الوحيد، دون أن يكتب أحد ذلك في أي موجّه.

وصل عميلاً بسطر واحد

النقطة الطرفية هي رابط واحد، ولا شيء يستوجب التسجيل من أجله على النطاقات العامة. كل عميل MCP يأخذ الشكل نفسه من الإعداد — Claude Desktop وClaude Code وCursor وContinue وOpenAI Agents SDK وأي عميل آخر يتحدث البروتوكول:

{"mcpServers":{"grabmail":{"url":"https://grabmail.io/mcp"}}}

النقل هو Streamable HTTP: طلب POST واحد يحمل JSON-RPC 2.0، ورد JSON واحد، بلا تدفق يبقى مفتوحًا. لذا يمكنك فحص الأمر كله من طرفية قبل أن يدخل أي وكيل في الصورة:

curl -sX POST https://grabmail.io/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

العملاء التي تبحث عن خادم قبل سؤال إنسان ستجد /.well-known/mcp.json على النطاق، وهو يسمّي النقطة الطرفية نفسها ونوع نقلها.

حلقة التسجيل كاملة، في أربعة استدعاءات أدوات

هذا هو التسلسل الذي يحتاجه كل وكيل تقريبًا، ولا شيء أكثر منه:

1. استدعِ create_inbox. يعود عنوان، ومستعار، والنطاق، وملاحظة تخبر الوكيل أيًا من الاثنين يوزّعه. لم يُنشأ شيء بعد — يبدأ وجود الصندوق مع وصول أول رسالة إليه.
2. ضع المستعار في النموذج. تحصل الخدمة التي يجري التسجيل فيها على عنوان يعمل ويصل إلى الصندوق، ولا يمكن استخدامه لقراءته.
3. استدعِ wait_for_message بالعنوان. فور الإرسال مباشرة، لا بحسب مؤقّت. إنها تنتظر؛ ولا تستطلع في حلقة يكتبها الوكيل بنفسه.
4. اقرأ الرمز من الرسالة. يعود المتن كاملاً مع الانتظار، لذا لا حاجة عادةً إلى استدعاء ثانٍ على الإطلاق — read_message لازمة فقط لشيء وصل قبل ذلك.

لماذا تعود wait_for_message قبل وصول البريد

إنها الأداة التي تجعل الوكيل عمليًا، وهي أيضًا الأداة التي يفاجئ سلوكها الناس، فتستحق دقيقة من وقتك. الاستدعاء يبدو هكذا:

curl -sX POST https://grabmail.io/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":
        {"name":"wait_for_message",
         "arguments":{"address":"demo.5kuqarzuch@grabmail.io",
                       "subject_contains":"code"}}}'

تنتظر حتى 25 ثانية كحد أقصى. وإن لم يصل شيء بحلول ذلك، فهي لا تفشل — بل تعود بجواب واضح وتطلب أن تُستدعى مرة أخرى:

{
  "timed_out": true,
  "waited_seconds": 25,
  "message": null,
  "note": "Nothing arrived yet. Call wait_for_message again ..."
}

لماذا هناك سقف من الأساس

كل ثانية انتظار هي عامل خادم لا يفعل شيئًا سوى النوم، وعددهم محدود. انتظار قد يستمر خمس دقائق يعني وكيلاً واحدًا يشغل مكانًا يحتاجه مئة غيره. كما أن 25 ثانية تقع ضمن المهلة الافتراضية لكل عميل، فيعود الاستدعاء بدل أن يتخلى العميل عن انتظاره.

8 عمليات انتظار فقط في آن واحد

بعد ذلك العدد تجيب الأداة فورًا بـtimed_out وملاحظة تقول ذلك. أن يُقال لك عد مرة أخرى أفضل من أن تُصفّ خلف سبعة وكلاء آخرين دون أي وسيلة لمعرفة ذلك.

التصفية، حتى لا ينهيها بريد خاطئ

تجعل from_contains وsubject_contains الانتظار يتجاهل أي شيء آخر يصل في الأثناء. أما since_id فهي ما تُمرَّر حين يكون في الصندوق شيء مسبقًا: أعطها آخر معرّف رأيته، ولن يُرضي الاستدعاءَ إلا بريد جديد فعلاً.

وزّع المستعار، وراقِب العنوان

لكل صندوق بريد هنا عنوان ثانٍ، طوله اثنا عشر حرفًا، يوصل الرسائل إلى الصندوق نفسه ولا يستطيع قراءتها. هذا الفارق يهم الوكيل أكثر بكثير مما يهم الإنسان، لأن الوكيل يلصق بارتياح أي شيء أُعطيه في أي حقل يجده.

لذا فإن create_inbox لا تكتفي بإعادة عنوان والتمني. إنها تعيد الاثنين معًا، وحقل next_step يوضّح أيهما أيهما — يقرأ الوكيل نتيجة أداته بنفسه، فتصل التعليمة إلى حيث تلزم بدل أن تبقى في صفحة توثيق لا يقرؤها أحد في الحلقة.

ما تكتبه في تعليمات الوكيل نفسه

تصف الأدوات نفسها بوضوح كافٍ يجعل نموذجًا قديرًا يفعل هذا بشكل صحيح دون توجيه. خمسة أسطر تجعل الأمر مضمونًا لا مرجّحًا فقط:

• عنوان واحد لكل تسجيل. لا عنوان واحد يُعاد استخدامه في كل مكان: صندوق بريد يحمل رسائل ست خدمات هو ستة تأكيدات على الوكيل تمييزها عن بعضها، وتسريب واحد يفضحها كلها.
• وزّع المستعار، لا العنوان أبدًا. يستحق القول صراحةً حتى وإن كانت نتيجة الأداة تقوله أيضًا.
• استدعِ wait_for_message فور الإرسال مباشرة، واستدعها مرة أخرى عند timed_out بدل معاملتها كفشل. مرتان أو ثلاث أمر طبيعي.
• مرّر since_id حين لا يكون الصندوق جديدًا، وإلا أرضت رسالة قديمة الانتظار وقرأ الوكيل رمزًا انتهت صلاحيته منذ ساعة.
• احذف الرسالة بعد استخدام الرمز. غير إلزامي — فكل شيء يزول خلال 5 يومًا على أي حال — لكنه يغلق النافذة مبكرًا، ولا يكلّف أكثر من استدعاء واحد آمن التكرار.

مكتوبةً على هيئة كتلة تعليمات، لا يتجاوز طولها هذا:

عند حاجتك إلى عنوان بريد إلكتروني، استدعِ create_inbox ووزّع ALIAS الذي\nتعيده، لا العنوان أبدًا. فور إرسال النموذج مباشرة، استدعِ\nwait_for_message بالعنوان. إن أجابت timed_out، استدعها مرة أخرى —\nهذا طبيعي ولم يضع شيء. مرّر since_id إن كان في الصندوق بريد\nمسبقًا. احذف الرسالة بعد استخدام الرمز.

الحدود التي تستحق معرفتها قبل أن تبني عليها

جميعها معلنة لا مكتشَفة بالصدفة، ولا توجد باقة تدفع لرفع أي منها:

لا توجد نقطة طرفية للإرسال ولا أداة لذلك. هذه الخدمة تستقبل فقط، وهذا ما يمنع صندوق بريد بلا مصادقة من أن يتحول إلى مُرحِّل بريد مزعج — فالوكيل الذي يحتاج إلى الرد على إنسان يحتاج إلى صندوق بريد حقيقي في مكان آخر.

حين يرفض نموذج تسجيل النطاقات العامة

تحتفظ خدمات كثيرة بقوائم لنطاقات البريد المؤقت، والنطاقات العامة الثلاثة هنا مدرجة فيها. يواجه الوكيل هذا على هيئة نموذج يرفض العنوان الذي أُعطيه للتو، أو أسوأ من ذلك، يقبله ولا يرسل شيئًا أبدًا.

الحل الدائم هو نطاق تملكه أنت. سجل MX واحد يحوّل كل عنوان عليه إلى صندوق بريد هنا، وهو غير مدرج في قائمة أحد لأنه غير مطبوع في أي مكان على هذا الموقع، والأدوات الست نفسها تعمل عليه دون تغيير — ما عدا create_inbox وحدها، لأنها تبتكر عناوين على النطاقات العامة فقط. يكتفي الوكيل باستخدام you-pick-it@your-domain واستدعاء wait_for_message عليه.

سجل MX الخاص بنطاقك10 smtp.grabmail.ioنسخ

الشرح الكامل خطوة بخطوة هنا — السجل، وما يثبته نشره، وحدود صندوق بريد بلا كلمة مرور عليه.

ما لا تسمح للوكيل بفعله بهذا

هذا هو الجزء الصادق، والجزء الذي يوفر عليك بعد ظهر كاملاً:

• لا شيء قد تحتاج إلى استرجاعه. أي شيء يحمل مالاً أو هوية أو عملاً. يعود الصندوق فارغًا خلال 5 يومًا، ويستطيع قراءته أي من يعرف العنوان، فإعادة تعيين كلمة مرور تُرسل إليه العام المقبل لا تصل إلى أحد — أو تصل إلى شخص آخر.
• ليس كعامل تحقق ثانٍ. صندوق بريد بلا كلمة مرور عليه ليس عامل تحقق.
• ليس لأي شيء خاص. ليس لأننا نقرؤه، بل لأن العنوان هو السر الوحيد المطروح، وقد يكون الوكيل قد كتبه في سجل، أو نص محادثة، أو رسالة commit.
• ليس للأعداد الكبيرة. وكيل يفتح حسابات بالمئات هو بالضبط السلوك الذي وُجدت كل قائمة حظر من أجله، وهو أسرع طريقة لجعل النطاقات العامة مرفوضة عند الجميع.

إن استُخدم لما هو مصمم له — خطوة التأكيد التي تقف بين الوكيل وما طُلب منه فعله فعلاً — فإنه يزيل الخطوة الوحيدة التي توقفه بثبات.

أسئلة