توثيق منصة NabehApp للوكلاء الأذكياء

منصة NabehApp تمنح وكلاء الذكاء الاصطناعي (AI Agents) هوية بريدية معزولة ومستقلة، تمكّنهم من استقبال رسائل البريد الإلكتروني، والتقاط أكواد التحقق (OTP) والتفعيل آلياً ولحظياً عبر بروتوكول Model Context Protocol (MCP) أو عبر واجهات REST API الحديثة.

إعداد الوكيل في 60 ثانية #

لبدء تفعيل وكيلك وربطه، اتبع الخطوات الثلاث التالية:

الربط مع Cursor و Cline عبر بروتوكول MCP #

يدعم NabehApp بروتوكول Remote Model Context Protocol (MCP) رسمياً. لإضافة خادم بريد الوكيل إلى Cursor IDE أو إضافة Cline في VS Code:

{
  "mcpServers": {
    "nabeh-mail": {
      "type": "remote",
      "url": "https://portal.nabehapp.com/api/mcp",
      "headers": {
        "Authorization": "Bearer pn_agt_YOUR_AGENT_KEY",
        "X-Mail-Token": "pn_agt_YOUR_AGENT_KEY",
        "X-Mailbox": "your_agent@nabehapp.com"
      }
    }
  }
}

الربط مع تطبيق Claude Desktop #

في ملف إعدادات Claude Desktop الرسمي (claude_desktop_config.json):

• على نظام macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• على نظام Windows: %APPDATA%\Claude\claude_desktop_config.json
• على نظام Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "nabeh-agent-inbox": {
      "type": "remote",
      "url": "https://portal.nabehapp.com/api/mcp",
      "headers": {
        "Authorization": "Bearer pn_agt_YOUR_AGENT_KEY",
        "X-Mailbox": "your_agent@nabehapp.com"
      }
    }
  }
}

إعداد متغيرات البيئة (.env) #

إذا كنت تبني وكيلاً برمجياً عبر Python أو Node.js أو إطار عمل كـ LangChain أو CrewAI، ضع المتغيرات التالية في ملف .env:

# إعدادات بريد وكيل NabehApp
NABEH_AGENT_KEY="pn_agt_YOUR_AGENT_KEY"
NABEH_MAILBOX="your_agent@nabehapp.com"
NABEH_MCP_URL="https://portal.nabehapp.com/api/mcp"

استدعاء مباشر عبر Python & Requests #

كود بايثون بسيط لاستخراج كود التحقق الأخير ومتابعة تدفق عمل الوكيل تلقائياً:

import os
import requests

AGENT_KEY = os.getenv("NABEH_AGENT_KEY", "pn_agt_YOUR_AGENT_KEY")
MAILBOX = os.getenv("NABEH_MAILBOX", "your_agent@nabehapp.com")

def get_latest_otp():
    """استخراج لحظي لآخر كود تحقق OTP استقبله صندوق الوكيل"""
    url = "https://portal.nabehapp.com/api/mcp"
    payload = {
        "jsonrpc": "2.0",
        "id": "1",
        "method": "tools/call",
        "params": {
            "name": "get_latest_otp",
            "arguments": {
                "mailbox": MAILBOX
            }
        }
    }
    headers = {
        "Authorization": f"Bearer {AGENT_KEY}",
        "Content-Type": "application/json"
    }
    
    response = requests.post(url, json=payload, headers=headers)
    data = response.json()
    return data.get("result", {})

if __name__ == "__main__":
    result = get_latest_otp()
    print("نتيجة استخراج OTP:", result)

أدوات بروتوكول MCP السبع (MCP Tools Reference) #

يوفر خادم NabehApp MCP سبع أدوات متخصصة تمنح الوكيل قدرات بريدية كاملة وأماناً ذاتياً:

1. get_latest_otp ⭐ (الأداة الأساسية)

استخراج فوري لآخر كود تحقق تم استلامه بدون الحاجة لقراءة كل الرسائل وتفكيكها، مع دعم التصفية وخيار الاستهلاك الفوري (consume: true).

2. list_incoming_emails

سرد قائمة الرسائل الواردة لصندوق الوكيل مع معرف كل رسالة، وتاريخها، وموجز المحتوى (Snippet).

3. read_email

جلب المحتوى الكامل لرسالة محددة عبر id بصيغة نصية أو HTML مع المرفقات.

4. send_email

إرسال بريد إلكتروني صادر أو إشعار عبر خوادم المنصة ونطاقاتك المعتمدة.

5. search_emails

بحث سريع بالكلمات المفتاحية في موضوع الرسالة، محتواها، أو عنوان المرسل.

6. delete_email

حذف رسالة محددة نهائياً من الصندوق بعد استهلاكها لتحقيق أقصى درجات الخصوصية وتوفير المساحة.

7. clear_temporary_otps

تنظيف وتفريغ كافة رموز التحقق والرسائل المؤقتة التابعة للصندوق بضغطة زر أو أمر برمجي واحد.

الأمان والعزل التام (Security & Isolation) #

تشفير المفاتيح لمرة واحدة (One-Time Reveal Key)

لحماية بياناتك، تتبع NabehApp أعلى المعايير الأمنية العالمية؛ حيث يُعرض مفتاح الـ API للمستخدم لمرة واحدة فقط عند الإنشاء. بمجرد نسخه يتم إخفاؤه وتشفيره في قاعدة البيانات ولا يمكن لأحد قراءته حتى من خلال واجهة لوحة التحكم.

عزل صناديق الوكلاء (Agent Sandboxing)

كل وكيل يمتلك صندوقاً بريدياً معزولاً ومفتاح اقتران مشفر. لا يمكن لوكيل الاطلاع على رسائل وكيل آخر حتى لو كانا تحت نفس الحساب دون إذن صريح، مما يضمن أماناً كاملاً عند استخدام وكلاء طرف ثالث (Third-Party Autonomous Agents).

الأسئلة الشائعة (FAQ) #