Foodzilla
للمطورين

خادم MCP من Foodzilla

تتحدث Foodzilla بروتوكول Model Context Protocol، فيستطيع مساعد الذكاء الاصطناعي العمل داخل حساب مختص أو مفكرة عميل عبر واجهة معيارية بدل كشط الصفحات. عنوان HTTPS واحد، وOAuth 2.1 مع PKCE، وأكثر من 60 أداة.

العنوان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 وما فوقها للمختصين
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 بقيم حقيقية لكل مكون، وإما أرقاما مجردة لشيء لا تحويه أي قاعدة. وسطر لا تعرفه القاعدة يرفض الاستدعاء كله ويسميه، بدل تسجيل تخمين.

نطاق المختص

46 أداة

الوصفات

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الإعدادات، ثم الموصلات، ثم خيارات متقدمة، وفعل وضع المطور. Foodzilla ليست في دليل الموصلات بعد.
  2. 2أضف موصلا بعنوان https://api.foodzilla.io/mcp.
  3. 3سجل الدخول ببريدك وكلمة مرورك في Foodzilla.
  4. 4تحقق من الحساب المذكور في صفحة الموافقة ثم اضغط اتصال.
  5. 5ابدأ محادثة والموصل مفعل.

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

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

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

يحسب أسبوعيا

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

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

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

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

White Label تحمل أربعة أضعاف رصيد Professional. وTeam تحمل سبعة أضعاف، لكل مختص.

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

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

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

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

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

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

MCP Server for Nutrition Coaching: Endpoint, Scopes, Tools | Foodzilla