خادم MCP من SingleFax
اربط Cursor أو Claude أو Codex أو ChatGPT أو VS Code بـSingleFax عبر MCP. يرفع المساعد الملف الأصلي (Word أو Excel أو PDF أو صورة، دون تحويل مسبق)، ويعرض سعر الإرسال، ثم يفتح Checkout أو يستخدم حصة صفحاتك.
التثبيت في Cursor وVS Code بنقرة واحدة. أما Claude وCodex وChatGPT، فانسخ المقتطف وافتح صفحة الإعدادات المناسبة. رابط Cursor مباشر إذا لم تفتح صفحة التثبيت التطبيق.
https://singlefax.com/mcp
تطبيقات الدردشة
Cursor وClaude وCodex وChatGPT. MCP + OAuth. يؤكد المستخدم الدفع ما لم تتبقَّ لديك صفحات اشتراك.
البرامج النصية والخوادم الخلفية
مفتاح API ورصيد مدفوع مقدمًا. دون إعادة توجيه إلى صفحة الدفع. الأنسب للعمليات الخلفية الخاصة بك.
أمثلة API وCLI ولغات البرمجةالدفع المستقل
Stripe MPP (HTTP 402). استخدم Link CLI للبطاقات، أو Tempo USDC لمحافظ Tempo Wallet / Privy / AgentCash / Kite.
رابط الآلة وLink CLI وTempoالتثبيت حسب التطبيق
Streamable HTTP على https://singlefax.com/mcp. بعد التثبيت، يشغّل العميل OAuth؛ سجّل الدخول بحساب SingleFax. متاح أيضًا في دليل Smithery باسم @singlefax/fax.
- انقر إضافة إلى Cursor أعلاه، أو احفظ هذا في
~/.cursor/mcp.json. - وافق على شاشة موافقة SingleFax OAuth.
- اطلب من الوكيل إرسال فاكس. للمستند المعتاد، سيستدعي
create_uploadويعطيك رابط رفع؛ ثم يستدعيcreate_fax_draftمعuploadToken. أرسل الملف الأصلي ولا تحوّله إلى PDF أولًا.
{
"mcpServers": {
"singlefax": {
"url": "https://singlefax.com/mcp"
}
}
}Cursor ليس من الأدوات التي تنشئ Stripe Shared Payment Tokens. يُفضّل استخدام رابط Checkout من create_fax_draft. للدفع عبر MPP من طرفية Cursor، راجع MPP أدناه. وثائق Cursor MCP.
Claude Code
- شغّل الأمر ثم أكمل OAuth باستخدام
/mcpفي الجلسة.
claude mcp add --transport http singlefax https://singlefax.com/mcpClaude.ai / Desktop
- افتح تخصيص ← الموصلات.
- أضف موصلًا مخصصًا باسم
singlefaxوبالرابط https://singlefax.com/mcp. - اتصل، ثم فعّل الموصل في الدردشة.
تتيح حسابات Claude.ai المجانية موصلًا مخصصًا واحدًا فقط. لا يدعم Claude رابط تثبيت مباشرًا؛ ينسخ الزر أمر CLI ويفتح صفحة الموصلات. وثائق Claude Code MCP.
- الصق الأوامر في الطرفية (تستخدم CLI وإضافة بيئة التطوير وتطبيق ChatGPT المكتبي
~/.codex/config.tomlنفسها). codex mcp login singlefaxيبدأ OAuth إذا لم تبدأه خطوة الإضافة.- في جلسة Codex، شغّل
/mcpللتحقق من الأدوات.
codex mcp add singlefax --url https://singlefax.com/mcp
codex mcp login singlefax[mcp_servers.singlefax]
url = "https://singlefax.com/mcp"- فعّل وضع المطور (الإعدادات ← الأمان وتسجيل الدخول).
- افتح الموصلات / الإضافات وأنشئ موصلًا مخصصًا.
- الاسم:
SingleFax. رابط MCP: https://singlefax.com/mcp. المصادقة: OAuth. - فعّل وضع المطور وموصل SingleFax داخل المحادثة قبل طلب إرسال فاكس.
https://singlefax.com/mcpMCP المخصص في ChatGPT لوضع المطور، وليس Instant Checkout. يظل الوكيل يعيد رابط SingleFax Checkout لتدفع من خلاله. وثائق موصلات ChatGPT.
- انقر إضافة إلى VS Code، أو افتح لوحة الأوامر ←
MCP: Add Server. - أو احفظ هذا في
.vscode/mcp.jsonلمساحة العمل أو في إعداد MCP للمستخدم.
{
"servers": {
"singlefax": {
"type": "http",
"url": "https://singlefax.com/mcp"
}
}
}ما الذي يمكنك قوله
بعد توصيل الخادم، تكفي مطالبة مثل هذه. للمستند المعتاد، ينبغي للوكيل استدعاء create_upload وإعطاؤك uploadPageUrl لرفع الملف الأصلي، ثم استدعاء create_fax_draft مع uploadToken. لا تستطيع تطبيقات الدردشة تمرير ملف عادي بترميز base64 ضمن استدعاء أداة. لا تحوّل Word أو Excel أو الصور إلى PDF أولًا؛ فنحن نحوّلها قبل الإرسال. يعرض الوكيل السعر، ثم يفتح Checkout أو يرسل باستخدام حصة صفحاتك.
Send this document as a fax to +1-415-555-2671 using SingleFax.list_skus, كتالوج بالأسعار. تبقى خدمات HIPAA وEIN وIRS حصرية للموقع (الروابط مرفقة)quote_fax, عرض سعر إرسال التجزئة. مرّر to؛ ويمكن تمرير pages أو base64 اختياريًا لحساب الصفحات فعليًاcreate_fax_draft, أرسل باستخدام to + uploadToken بعد create_upload؛ يُدرج الفاكس في قائمة الانتظار باستخدام الرصيد أو حصة الصفحات المشتركة، وإلا يُعاد رابط Checkout. استخدم base64 للملفات الصغيرة جدًا فقط. أرسل ملفات Word أو Excel أو PDF أو الصور الأصلية، ولا تحوّلها إلى PDF أولًا.create_inbound_number, احصل على رقم فاكس مخصص. الخيار الافتراضي 30 يومًا ($4.99). يعيد رابط Checkout والرقم المحجوز. ثم استدعِ list_numbers بعد الدفع.list_numbers, اعرض أرقام الفاكس النشطة لهذا الحسابcreate_checkout, رصيد أو أصناف أخرى من الكتالوج؛ يُفضّل create_inbound_number للحصول على رقم فاكسcreate_upload, الملفات الكبيرة: يعيد uploadPageUrl للرفع اليدوي دون تسجيل دخول، وuploadUrl لرفع البايتات الخام عبر PUT دون Authorization. مرّر uploadToken للاستعلام عن حالة التخزينget_fax_status, استعلم دوريًا عن حالة تسليم طلب تملكهget_credits, قراءة الرصيد المدفوع مقدمًاcreate_machine_fax, تحدي MPP بصيغة JSON. Link CLI (SPT) أو محافظ Tempo. REST 402 هو مسار الدفع الفعليMPP، دفع ذاتي
Machine Payment Protocol بروتوكول للمشتري: يعيد الخادم HTTP 402، ويرفق الوكيل رمز Stripe Shared Payment Token أو دفعة Tempo USDC ثم يعيد المحاولة. هذا هو POST https://singlefax.com/api/v1/machine/faxes، وليس أدوات MCP للمحادثة.
يمكن لـCursor وClaude Code وCodex تنفيذ call على ذلك الرابط من الطرفية، لكنها لا تستطيع إنشاء SPT ما لم تزودها بمحفظة. مسار البطاقة لدى Stripe هو Link CLI (لحسابات Link الأمريكية). وافق على كل دفعة في تطبيق Link. تسدد Tempo Wallet وPrivy وAgentCash وKite Passport تحدي Tempo على الرابط نفسه.
- ثبّت المهارة:
npx skills add stripe/link-cli، أو أضف MCP npx @stripe/link-cli --mcp. - سجل الدخول، ثم ادفع عبر نقطة النهاية الآلية (رقم E.164 صالح ومستند حقيقي بترميز base64 للملف الأصلي، وليس عنصرًا نائبًا
+1555، ولا PDF محولًا مسبقًا إلا إذا كان الأصل PDF). - لا توجّه
mpp payإلى/mcp. تحتاج Link CLI إلى رابط يُرجع HTTP 402 معWWW-Authenticate.
npx @stripe/link-cli auth login
npx @stripe/link-cli mpp pay https://singlefax.com/api/v1/machine/faxes \
-X POST \
-d '{"to":"+14155552671","base64":"<document-bytes>","request_id":"mpp-1"}' \
--context "Send a fax via SingleFax after the user asked this agent to pay for the send."البنية الكاملة لتحديات الدفع والتحقق والحالة والاسترداد: mpp.md. الحد الأدنى لعملية SPT هو $0.50؛ ولـTempo USDC هو $0.01؛ والحد الأدنى لسعر التجزئة لدى SingleFax هو $0.99.
REST API وCLI
لنظامك الخلفي، أنشئ مفتاحًا محدد النطاقات واشحن رصيدًا مقدمًا، دون إعادة توجيه إلى Checkout. تتوفر أمثلة جاهزة للنسخ بـcurl وNode وPython وGo وPHP في صفحة المطورين.
الأسئلة الشائعة
وثائق قابلة للقراءة بواسطة الوكلاء
Markdown بسيط لبرامج الزحف ووكلاء البرمجة. المعلومات نفسها الواردة في هذه الصفحة.