خادم MCP

فوتّر داخل مساعدك الذكي

خادم MCP رسمي يصل حسابك في فوتّر بمساعد ذكي، فيقرأ فواتيرك وعملاءك ومستحقاتك وملخص ضريبتك، ويصدر فاتورة حين تطلب. تسجّل الدخول مرة واحدة في شاشة موافقة تختار فيها المنشأة وصلاحية القراءة أو الكتابة، وتنهي الربط متى شئت.

ما الذي تستطيع أن تسأله

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

«من عليه مستحقات متأخرة، وكم؟»

كل فاتورة صادرة غير مدفوعة برصيدها المتبقي وعدد أيام التأخير، مع الإجمالي.

fawtar_outstanding

«كم ضريبة القيمة المضافة المستحقة عن الربع الماضي؟»

ضريبة المخرجات على المبيعات، وضريبة المدخلات القابلة للخصم، والصافي — الأرقام التي يُبنى منها الإقرار.

fawtar_vat_summary

«أصدر فاتورة مبسطة بـ ٣٬٠٠٠ ريال لخدمة تصميم»

رقم تسلسلي، احتساب الضريبة، رمز QR متوافق مع هيئة الزكاة والضريبة والجمارك، وترحيل إلى دفتر الأستاذ.

fawtar_create_invoice

«اعرض فواتير هذا العميل هذا العام»

قراءة أي مصدر في الحساب — العملاء والمنتجات والمصروفات والقيود والرواتب — بتصفية وترتيب وصفحات.

fawtar_list

الربط

طريقتان. الأولى لمساعد يضيف الرابط كموصّل من واجهته، والثانية لعميل يُضبط من ملف إعدادات.

١. تسجيل الدخول من المساعد (OAuth)

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

https://fawtar.app/api/mcp

وجود حقل لرابط موصّل مخصص قرار كل مساعد لا قرارنا. وحيثما وُجد، هذا كل ما يحتاجه.

٢. لصق مفتاح واجهة برمجية (ملف إعدادات)

أنشئ مفتاحًا من صفحة التكاملات في حسابك — بصلاحية القراءة ما لم ترد إصدار فواتير — والصق هذا في إعدادات MCP لدى العميل.

{
  "mcpServers": {
    "fawtar": {
      "type": "http",
      "url": "https://fawtar.app/api/mcp",
      "headers": { "Authorization": "Bearer fwt_live_xxxxxxxx" }
    }
  }
}

نقطة الاتصال هي https://fawtar.app/api/mcp عبر Streamable HTTP، بإصدار البروتوكول 2025-06-18. والطريقتان تتطلبان باقة الأعمال، وهي نفس قاعدة الواجهة البرمجية.

الأدوات

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

fawtar_list
List recordsقراءة فقط
fawtar_get
Fetch one recordقراءة فقط
fawtar_create
Create a recordكتابة
fawtar_create_invoice
Issue an invoiceكتابة
fawtar_outstanding
What is owed to this businessقراءة فقط
fawtar_vat_summary
VAT for a periodقراءة فقط

ما يستطيعه المساعد وما لا يستطيعه

المفتاح هو ما يحدد المنشأة

لا شيء في البروتوكول يستطيع تسمية منشأة أخرى. المساعد يرى بيانات المنشأة التي أُنشئ المفتاح فيها، ولا شيء غيرها.

مفتاح القراءة لا يكتب

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

الفاتورة فعل مالي لا رجعة فيه

الفاتورة الصادرة لا تُعدَّل ولا تُحذف؛ تُصحَّح بإشعار دائن. لذلك تطلب الأداة نفسها من المساعد مراجعة المبالغ معك قبل التنفيذ.

لا يرى كلمة مرورك

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

أسئلة

ما الذي أحتاجه للربط؟

حساب فوتّر على باقة الأعمال، وعميل يدعم MCP عبر Streamable HTTP. إن كان العميل يقبل رابط موصّل مخصص فلن تحتاج شيئًا سوى العنوان؛ وإن كان يُضبط من ملف فأنشئ مفتاحًا من صفحة التكاملات.

هل الخادم منشور رسميًا؟

منشور في سجل Model Context Protocol الرسمي باسم app.fawtar/fawtar، وملكية النطاق مُتحقَّق منها مقابل fawtar.app.

هل يستطيع المساعد حذف بياناتي؟

لا. الأدوات المتاحة تقرأ، وتنشئ سجلات بسيطة، وتصدر فاتورة. لا توجد أداة حذف، ولا أداة تعدّل فاتورة صادرة.

هل هذا بديل عن الواجهة البرمجية؟

لا. الواجهة البرمجية لما تبنيه بنفسك، وMCP لما يفعله المساعد نيابة عنك. كلاهما بنفس المفتاح ونفس الصلاحيات.

آخر تحقق: 2026-08-29.