دع وكلاء الذكاء الاصطناعي يجرون المكالمات ويرسلون الرسائل القصيرة

خادم MCP مُستضاف لحسابك في Spoof Caller ID.

اربط Claude Code أو Cursor أو VS Code أو أي عميل MCP آخر بحسابك. يمكن لوكيلك التحقق من الأسعار والرصيد، وإرسال رسائل SMS، وإجراء المكالمات بمعرّف المتصل الخاص بك، وتشغيل مكالمات تحويل النص إلى كلام، والاستعلام عن الأرقام، باستخدام مفتاح API الخاص بك.

ما يمكن للوكيل فعله

اطلب بكلمات بسيطة، وسيختار الوكيل الأداة المناسبة.

تحقق من الأسعار والرصيد

اسأل عن تكلفة مكالمة أو رسالة SMS إلى أي دولة، وعن الرصيد المتبقي.

إرسال SMS

أرسل رسالة SMS باسم المرسل الخاص بك، عبر أرخص مسار أو مسار تختاره.

اتصل بمعرّف المتصل الخاص بك

أجرِ مكالمة تُظهر معرّف المتصل الذي تختاره، وحدّد مدة الرنين، وتحقّق مما إذا تم الرد.

مكالمات تحويل النص إلى كلام

اتصل برقم واقرأ رسالة بالصوت واللغة اللذين تختارهما.

تحقق من الأرقام

احصل على عرض سعر مجاني، ثم أجرِ استعلام HLR فعليًا لمعرفة الأرقام النشطة.

استخدم عميلك الخاص

Claude Code أو Cursor أو VS Code أو Claude Desktop أو أي عميل MCP يدعم الترويسات المخصصة.

الأدوات

ثلاث عشرة أداة. تسع مجانية وأربع مدفوعة.

مجانية

  • get_account الحساب المرتبط بالمفتاح: اسم المستخدم والرصيد والحالة.
  • get_balance رصيدك الحالي باليورو.
  • get_prices أسعار المكالمات لكل دقيقة وأسعار الرسائل القصيرة لكل جزء، لدولة واحدة أو لجميع الدول.
  • list_sms_routes مسارات الرسائل القصيرة التي يمكنك الإرسال عبرها، مع أسعارها لدولة ما.
  • list_tts_voices الأصوات المتاحة لمكالمات تحويل النص إلى كلام.
  • get_tts_call حالة مكالمة تحويل النص إلى كلام ومدتها وتكلفتها.
  • hlr_quote يفحص قائمة أرقام ويخبرك بتكلفة استعلام HLR عنها، دون إجراء الاستعلام.
  • get_call حالة مكالمة واحدة (جارٍ الاتصال، يرن، تم الرد، اكتملت، مشغول، لا رد أو فشلت) مع مدتها والوقت المحتسب وتكلفتها.
  • list_calls مكالماتك، الأحدث أولًا، مع الحالة والمدة والتكلفة.

مدفوعة

  • send_sms يرسل رسالة SMS واحدة باسم المرسل الخاص بك، بسعر المسار لكل جزء من الرسالة.
  • make_spoof_call يُجري مكالمة تُظهر معرّف المتصل الذي تختاره. لا تُحتسب إلا المكالمات التي يُرد عليها، بسعر الدقيقة للوجهة.
  • tts_call يتصل برقم وينطق نصك بصوت اصطناعي، مع الفوترة بالدقيقة.
  • hlr_lookup يتحقق مما إذا كانت الأرقام نشطة، وعلى أي شبكة هي، وما إذا كانت منقولة، بسعر €0.01 لكل رقم يُعاد له نتيجة.

اربط عميلك

نقطة الاتصال https://app.spoofcallerid.com/mcp، عبر HTTP القابل للبث، مع مفتاح API الخاص بك في ترويسة Authorization. بدون OAuth.

شغّل هذا في الطرفية، مع وضع مفتاحك بدلًا من <api_key>:<api_secret>.

claude mcp add --transport http spoofcallerid https://app.spoofcallerid.com/mcp --header "Authorization: Bearer <api_key>:<api_secret>"

أضف إلى Cursor

يفتح الزر Cursor والخادم جاهز للتثبيت. استبدل <api_key>:<api_secret> بمفتاحك بعد التثبيت، أو أضف ما يلي إلى ~/.cursor/mcp.json:

{
  "mcpServers": {
    "spoofcallerid": {
      "url": "https://app.spoofcallerid.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>:<api_secret>"
      }
    }
  }
}

أضف إلى VS Code

يفتح الزر VS Code والخادم جاهز للتثبيت. استبدل <api_key>:<api_secret> بمفتاحك، أو أضف ما يلي إلى .vscode/mcp.json؛ وسيطلب VS Code المفتاح مرة واحدة ويخزنه بأمان:

{
  "servers": {
    "spoofcallerid": {
      "type": "http",
      "url": "https://app.spoofcallerid.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:spoofcallerid-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "spoofcallerid-key",
      "description": "Spoof Caller ID API key as <api_key>:<api_secret>",
      "password": true
    }
  ]
}

يتصل Claude Desktop عبر mcp-remote، الذي يتطلب Node.js 18 أو أحدث. أضف ما يلي إلى claude_desktop_config.json ثم أعد تشغيل Claude Desktop:

{
  "mcpServers": {
    "spoofcallerid": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://app.spoofcallerid.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <api_key>:<api_secret>"
      }
    }
  }
}

استخدم هذه الإعدادات في أي عميل MCP يدعم الخوادم البعيدة مع ترويسة مخصصة:

URL:    https://app.spoofcallerid.com/mcp
Type:   streamable HTTP
Header: Authorization: Bearer <api_key>:<api_secret>

الخادم مُدرج في سجل MCP الرسمي باسم com.spoofcallerid/spoofcallerid.

احصل على مفتاحك في التطبيق ضمن Account → API & keys. وثائق API

أمثلة على الطلبات

ما يمكنك طلبه، وما يحدث.

كم تكلف مكالمة مدتها 5 دقائق إلى ألمانيا؟

يستدعي الوكيل get_prices لألمانيا ويحسب التكلفة من سعر الدقيقة. مجاني.

كم تبقى من رصيدي؟

يستدعي الوكيل get_balance. مجاني.

أرسل رسالة SMS إلى +44 7700 900123 من 'MyShop' تقول 'تم شحن طلبك'.

يمكن للوكيل التحقق من المسارات باستخدام list_sms_routes، ثم يستدعي send_sms. يكلف ذلك سعر المسار لكل جزء من الرسالة. يظهر اسم المرسل حيث يسمح المسار بذلك. الرقم مجرد مثال.

تحقق أيٌّ من هذه الأرقام نشط: …

يستدعي الوكيل hlr_quote لعرض التكلفة أولًا (مجانًا)، ثم hlr_lookup، الذي يكلف €0.01 لكل رقم يُعاد له نتيجة، وحتى 100 رقم في كل استدعاء.

اتصل بالرقم ‎+44 7700 900123 بمعرّف المتصل الخاص بي، ودعه يرن 10 ثوانٍ، وأخبرني إن ردّوا.

يستدعي الوكيل make_spoof_call مع ring_timeout 10، ثم get_call لقراءة الحالة. إذا لم يرد أحد فلا تكلّف المكالمة شيئًا. الرقم مجرد مثال.

اتصل بهذا الرقم وقل 'موعدك غدًا الساعة 10' بصوت ألماني.

يختار الوكيل صوتًا باستخدام list_tts_voices، ويبدأ tts_call (مع الفوترة بالدقيقة)، ويمكنه متابعتها باستخدام get_tts_call.

الأمان والتكاليف

  • أربع أدوات فقط مدفوعة: send_sms وmake_spoof_call وtts_call وhlr_lookup. ويُذكر ذلك في أوصافها، حتى يتمكن عميلك من إظهاره قبل تشغيلها.
  • يطلب الخادم من المساعد أن يتأكد منك من الوجهة ومعرّف المتصل أو المرسل والنص قبل استخدام أداة مدفوعة. ويعتمد ما إذا كان سيسألك على عميلك وإعداداته.
  • امنح الوكيل مفتاح API خاصًا به بالصلاحيات التي يحتاجها فقط. المفتاح الذي يملك صلاحية القراءة فقط لا يمكنه إنفاق أي شيء.
  • اقصر استخدام المفتاح على عناوين IP الخاصة بك في Account → API & keys.
  • تستخدم الأدوات المدفوعة الأسعار نفسها المعروضة في لوحة التحكم. احتفظ برصيد صغير أثناء الاختبار.

أسئلة حول وكلاء الذكاء الاصطناعي

ما عملاء الذكاء الاصطناعي الذين يعملون معه؟

أي عميل MCP يمكنه الاتصال بخادم بعيد عبر HTTP القابل للبث وإرسال ترويسة Authorization مخصصة، مثل Claude Code وCursor وVS Code. ويتصل Claude Desktop عبر mcp-remote.

هل أحتاج إلى OAuth؟

لا. يستخدم الخادم مفتاح API الخاص بك: أرسل Authorization: Bearer <api_key>:<api_secret> مع كل طلب. لا يتطلب عرض قائمة الأدوات مفتاحًا، لكن كل استدعاء لأداة يتطلبه.

هل يمكن للوكيل إنفاق المال دون أن يسألني؟

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

كم التكلفة؟

لا توجد رسوم منفصلة لخادم MCP. تُحتسب الأدوات المدفوعة بالأسعار نفسها المعروضة في لوحة التحكم، أما الأدوات المجانية فلا تكلف شيئًا.

هل توجد نسخة محلية؟

نعم. يتوفر خادم محلي من ملف واحد لـ Node.js 18 أو أحدث. يتضمن ست أدوات أساسية: get_account وget_balance وget_prices وsend_sms وmake_spoof_call وget_call.

امنح وكيلك هاتفًا

أنشئ حسابًا، واشحن رصيدك بدءًا من €50 بالعملات المشفرة، وأنشئ مفتاح API لوكيلك.

إنشاء حساب