Foodzilla
للمطورين

خادم MCP من Foodzilla

عنوان HTTPS واحد. OAuth 2.1 مع PKCE. 61 أداة بوسائط محددة النوع. يستدعيها المساعد ليعمل داخل حساب مختص أو مفكرة عميل. أرقام التغذية تأتي من قاعدة أطعمة Foodzilla، لا من النموذج.

العنوانhttps://api.foodzilla.io/mcp

تبحث عما يفعله لا عن كيفية عمله؟ اطلع على نظرة عامة عن أوتوبايلوت

ما هو Model Context Protocol

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

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

مرجع الاتصال

كل ما تحتاجه لتوجيه عميل MCP إلى Foodzilla.

العنوان
https://api.foodzilla.io/mcp
النقل
HTTP متدفق، JSON-RPC 2.0 عبر POST
التفويض
رمز تفويض OAuth 2.1 مع PKCE، وتسجيل ديناميكي للعملاء
الاكتشاف
/.well-known/oauth-protected-resource/mcp
النطاقات
autopilot, coach, openid, offline_access
الباقة
Professional وما فوقها للمختصين، باستثناء خطة No-PHI
autopilot

عميل متابع. خطته هو ومفكرته هو، ولا شيء غير ذلك.

coach

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

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

ما الذي يحصل عليه طلب غير موثق

رد 401 مع ترويسة WWW-Authenticate تذكر عنوان بيانات المورد الوصفية. وهكذا يجد عميل MCP خادم التفويض من تلقاء نفسه.

الـ أدوات

61 أداة حتى الآن. الأسماء ثابتة. وكل ما يستبدل أو يصرف مالا موسوم بأنه مدمر، فيسأل مساعدك قبل تنفيذه.

نطاق العميل

16 أداة

التسجيل

log_food, log_planned_meal, log_water, log_exercise, log_sleep, log_weight, delete_food_log

خطتهم

get_plan, get_todays_meals, get_recipe

المراجعة

get_day, get_progress, get_recent_foods, get_profile, get_status

الحساب

sign_out_everywhere

تقبل log_food إما قائمة أطعمة تطابق قواعد بيانات Foodzilla بقيم حقيقية لكل مكون، وإما أرقاما مجردة لشيء لا تحويه أي قاعدة. وسطر لا تعرفه القاعدة يرفض الاستدعاء كله ويسميه، بدل تسجيل تخمين.

نطاق المختص

45 أداة

الوصفات

generate_recipe, import_recipe_from_url, update_recipe_draft, discard_recipe_draft, save_recipe, list_my_recipes

قوالب الخطط

generate_plan_template, list_my_templates, describe_plan_settings

المجموعات والأطعمة

create_collection, add_recipes_to_collection, list_collections, add_food, add_foods, import_food_from_url, import_food_from_text

النماذج والحجوزات

create_form, update_form, list_forms, get_booking_setup, set_availability, create_appointment_type, update_appointment_type

المحتوى

create_post, update_post, publish_post, pin_post, list_posts

المتجر

get_store, update_store, create_store_plan, update_store_plan, publish_store, unpublish_store

الإعدادات

get_app_experience, set_app_experience, update_my_profile, get_invoice_settings, update_invoice_settings

الحساب والفوترة

get_my_account, get_subscription, preview_plan_change, change_plan, activate_subscription, extend_trial

من كان دون Professional يتصل بخمس منها: أدوات الحساب والاشتراك، ليتمكن المساعد من تسعير الترقية وتنفيذها. ويظهر الباقي فور ارتفاع الباقة، على الاتصال نفسه.

ربط مساعد

لا شيء يثبت ولا مفتاح يولد. تدفق OAuth يتكفل بالباقي.

Claude

  1. 1الإعدادات، ثم الموصلات، ثم إضافة موصل مخصص.
  2. 2الصق https://api.foodzilla.io/mcp كعنوان.
  3. 3سجل الدخول ببريدك وكلمة مرورك في Foodzilla عند فتح الصفحة.
  4. 4تحقق من الحساب المذكور في صفحة الموافقة ثم اضغط اتصال.

ChatGPT

  1. 1افتح Plugins من القائمة الجانبية وابحث عن Foodzilla.
  2. 2افتح Foodzilla من النتائج واضغط Add.
  3. 3سجل الدخول ببريدك وكلمة مرورك في Foodzilla.
  4. 4تحقق من الحساب المذكور في صفحة الموافقة ثم اضغط اتصال.
  5. 5اضغط Try in chat، أو ابدأ محادثة وFoodzilla مفعل.

أي شيء آخر يتحدث MCP

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

الحدود والاستهلاك

يحسب أسبوعيا

لكل باقة رصيد أسبوعي يعاد ضبطه يوم الاثنين. القراءات والكتابات والاستدعاءات التي تستهلك وقت النموذج تحسب في سلال منفصلة، فأسبوع كثير القراءة لا يلتهم ميزانية توليد الوصفات.

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

عملاؤك يسحبون من رصيد واحد بينهم لا رصيد لكل واحد. وبذلك لا يستطيع عميل واحد كثير الكلام أن ينفق أسبوع العيادة.

يكبر مع الباقة

White Label تحمل أربعة أضعاف رصيد Professional. وTeam تحمل من خمسة إلى سبعة أضعاف حسب حجم الفريق، ويتشاركها الفريق كله.

ظاهر كنسبة مئوية

تبويب أوتوبايلوت في Foodzilla يعرض كم مضى من الأسبوع. وعند بلوغ الحد ترد الأداة بذلك صراحة، بدل أن تفشل بصمت.

ما الذي يرفضه الخادم

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

البيانات الشخصية تبقى خارج سجلات الخادم. لا أسماء عملاء أو مختصين، ولا عناوين بريد، ولا أرقام هواتف.

الأسئلة الشائعة

خادم MCP للتدريب الغذائي: العنوان والنطاقات والأدوات | Foodzilla