Docs
مركز المطوّرينلوحة التحكمesimoa.com
    • مقدمة
    • بدء سريع
    • المصادقة
    • Overview
    • عرض قائمة شرائح eSIM
    • احصل على eSIM
    • البلدان
    • OpenAPI
    • التتبع والعمولة
    • حدود المعدل والأخطاء
    • Overview
    • إدراجات MCP
    • Claude
    • ChatGPT
    • Gemini
    • عملاء MCP آخرون
    • Overview
    • المصادقة
    • المنتجات
    • تفاصيل المنتج
    • البلدان
    • Errors & rate limits
  1. Docs
  2. عمليات التكامل مع الذكاء الاصطناعي (MCP)
  3. Overview

Overview

عمليات التكامل مع الذكاء الاصطناعي (MCP)

Connect the official esimoa MCP server so AI assistants can search and compare eSIMs and share purchase links.

On this page
  • Server URL
  • Adding your partner key
  • Available tools
  • Rate limits
  • Connect a client

Server URL#

خادم MCP الرسمي من esimoa https://api.esimoa.com/mcp يتيح لمساعدي الذكاء الاصطناعي البحث عن شرائح eSIM ومقارنتها ومشاركة روابط الشراء. يستخدم Streamable HTTP (JSON عديم الحالة) ويعمل دون مفتاح (120 طلبًا/دقيقة لكل IP).

url
https://api.esimoa.com/mcp

البقشيش

جديد على MCP؟ ابدأ مع Claude: الصق رابطًا واحدًا دون تسجيل دخول، وستكون متصلًا خلال دقيقة تقريبًا. كيفية ربط Claude

Adding your partner key#

البقشيش

للشركاء: أضف مفتاحك حتى تحمل الروابط التي يشاركها الذكاء الاصطناعي رمز الشريك الخاص بك وتحقق لك عمولة. في شاشات الموصّلات في Claude أو ChatGPT التي لا تسمح بتعيين الترويسات، أضف ?key= إلى الرابط:
url
https://api.esimoa.com/mcp?key=esk_live_your_key_here

يمكن للعملاء الذين يدعمون الترويسات إرسال X-API-Key أو Authorization: Bearer بدلًا من ذلك. يُرفض المفتاح الخاطئ بالرمز 401 — لاستخدام الخادم دون مفتاح، احذفه تمامًا.

Available tools#

الحقلالنوعالوصف
search_esimstoolالبحث عن eSIM — country (رمز ISO أو اسم بأي لغة) أو countries (كلها معًا)، days، data_gb / max_data_gb، unlimited، data_type (daily|total)، local_number، network (local|roaming)، multi_country، min_price_krw / max_price_krw، provider، hotspot / five_g، sort، limit (≤10)، lang
get_esimtoolتفاصيل eSIM — id, lang
compare_esimstoolقارن من 2 إلى 5 باقات جنبًا إلى جنب — ids (من search_esims)، lang. يبيّن الباقة الأقل سعرًا والأكثر بيانات والأطول صلاحية والأقل سعرًا لكل غيغابايت
list_countriestoolالبلدان المعروضة للبيع — query، lang
search / fetchtoolأدوات متوافقة مع ChatGPT — search {query} (نص حر؛ يفهم غير المحدود واليومي ورقم الهاتف المحلي والشبكة المحلية ونقطة الاتصال و5G)، fetch {id}

في التطبيقات التي تدعم MCP Apps (مثل Claude وChatGPT وVS Code) تظهر نتائج search_esims وget_esim وcompare_esims على شكل بطاقات باقات. يفتح زر «عرض الباقة» صفحة الباقة على esimoa.com، ولا تتم أي عملية دفع من البطاقات.

Rate limits#

ملاحظة

تتشارك API العامة وMCP المصادق عليه حصة بالساعة لكل شريك (20,000 افتراضيًا). لا تؤدي إضافة المفاتيح أو تدويرها إلى زيادتها.

تبدأ نافذة الـ 3,600 ثانية مع أول طلب، ويُطبَّق الحد لكل دقيقة أيضًا. تُحسب الحصص بعدد الاستدعاءات لا بحجم MB المنقولة. قد تغيّر الإعدادات التشغيلية الحصة.

تقبل دفعات MCP حتى 100 رسالة، وتُحتسب كل رسالة كاستدعاء واحد. الدفعة التي تتجاوز الحصة المتاحة تُرجع 429 قبل التنفيذ.

X-RateLimit-Hour-Limit · X-RateLimit-Hour-Remaining · X-RateLimit-Hour-Reset

تُظهر هذه الترويسات الحد بالساعة والاستدعاءات المتبقية ووقت إعادة التعيين (بثواني Unix). عند استنفاد الحد بالساعة يُرجَع HTTP 429 مع Retry-After بالثواني. لا تُحتسب الاستدعاءات المرفوضة بسبب الحد لكل دقيقة ضمن الحصة بالساعة.

بدون مفتاح يكون الحد 120 طلبًا في الدقيقة لكل عنوان IP، ومع مفتاح شريك 600 طلب في الدقيقة لكل مفتاح. تُحتسب الطلبات التي يرسلها Claude وChatGPT من خوادمهما حسب المنصة لا حسب عنوان IP. عند تجاوز الحد تتلقى خطأ JSON-RPC (-32002) مع HTTP 429.

Connect a client#

إدراجات MCP

Claudeموصل claude.ai · Claude CodeChatGPTموصل وضع المطوّرGeminiGemini CLI · ~/.gemini/settings.jsonعملاء MCP آخرونJSON-RPC 2.0 · POST

آخر تحديث: ٢ أكتوبر ٢٠٢٦

Previousحدود المعدل والأخطاءالتاليإدراجات MCP

On this page

  • Server URL
  • Adding your partner key
  • Available tools
  • Rate limits
  • Connect a client

APIs and MCP for bringing esimoa eSIMs to your product

Resources

  • Docs
  • API reference
  • واجهة API للشركاء (B2B)
  • MCP server
  • OpenAPI spec

esimoa

  • الرئيسية
  • eSIM باقات
  • مركز المطوّرين
  • لوحة التحكم
  • بوابة الشركاء

Company

  • من نحن
  • الشراكات
  • شروط الخدمة
  • سياسة الخصوصية
  • سياسة التسليم والاسترداد

الدعم

  • support@esimoa.com
  • محادثة الدعم

NBase Korea Co., Ltd.

902, Bldg A, 767 Sinsu-ro, Suji-gu, Yongin-si, Gyeonggi-do (Dongcheon-dong, Bundang Suji U-TOWER)

المقر الأمريكي: NBASE CORP. · Corporate Park, Irvine, CA 92606, USA

© 2026 esimoa. جميع الحقوق محفوظة.