Flova MCP برای استودیو
برنامههای متصل را از طریق سرور Flova MCP به داشبوردهای استودیو وصل کنید.
Flova MCP به برنامههای متصل اجازه میدهد از طریق پروتکل زمینهٔ مدل، منابع فضای کاری فلووا را بخوانند و تغییر دهند. ابزارهای استودیو میتوانند داشبورد را فهرست کنند، اطلاعات آن را بخوانند، گرهها و قابلیتهای ویرایش را بررسی کنند، تغییر را بهصورت آزمایشی اجرا کنند، تغییر تأییدشده را اعمال کنند، پیشنویس را ذخیره و اعتبارسنجی کنند و داشبورد را منتشر یا بایگانی کنند.
نشانی سرور:
https://mcp.flova.ir/mcpMCP برای ورود از OAuth فلووا استفاده میکند. برنامه در صورت نیاز مرورگر را باز میکند. وارد شوید، فضای کاری فلووا را انتخاب کنید، دسترسی را تأیید کنید و اگر برنامه خواست، نشست آن را دوباره شروع کنید.
افزودن Flova MCP
این مثالها سرور را با نام flova ثبت میکنند.
codex mcp add flova --url https://mcp.flova.ir/mcp
codex mcp listهنگام افزودن، در صورت نیاز صفحهٔ ورود فلووا در مرورگر باز میشود. اگر نشست
OAuth منقضی شد، از دستور codex mcp login flova استفاده کنید.
بررسی اتصال و ویرایش امن
از برنامهٔ متصل بخواهید منابع فضای کاری فلووا را فهرست کند یا راهنمای ویرایش داشبورد استودیو را بخواند. برنامه فقط ابزارهایی را نشان میدهد که بر اساس محدودههای OAuth و نقش فضای کاری اجازهٔ استفاده از آنها را دارد.
برای تغییر داشبورد این ترتیب را دنبال کنید:
- اطلاعات داشبورد را بخوانید.
- صفحه یا گرههایی را که قرار است تغییر کنند، بازبینی کنید.
- یک دستهٔ کوچک از تغییرهای معنایی آماده کنید.
- ویرایش داشبورد را بهصورت آزمایشی اجرا کنید.
- همان دستهٔ موفق را با شناسهٔ عملیات و اثر انگشت پیشنمایش جدید اعمال کنید.
- پیشنویس را ذخیره یا اعتبارسنجی کنید.
- پیش از انتشار، داشبورد را در استودیو بررسی کنید.
برای یک ویرایش معمولی، ابزارها را به این ترتیب به کار ببرید:
dashboard_authoring_contextdashboard_nodes_inspectبرای صفحه یا ویجتهای درگیرdashboard_edit_dry_runبا ۱ تا ۱۲ تغییر معناییdashboard_edit_semanticبا همان دستهٔ موفق،operationIdتازه وpreviewFingerprintبرگشتیdashboard_visual_inspectدر اندازههای نمایشی درخواستیdashboard_validatedashboard_publishباconfirm: trueفقط پس از تأیید روشن کاربر
اگر اجرای آزمایشی ناموفق بود، راهنمای nextTool و repair برگشتی را دنبال
کنید، تغییر را اصلاح کنید و همان failureFingerprint را دوباره نفرستید. اگر
تاریخچه ناسازگار بود، ابتدا اطلاعات تازهٔ داشبورد را بخوانید و سپس بخش درگیر را
بازبینی کنید. اگر خطای هندسهٔ واکنشگرا گرفتید، Grid یا Stack درگیر را بررسی
کنید و در صورت نیاز محتوا را در یک والد واکنشگرای کوچکتر تقسیم کنید.
ناسازگاری تاریخچه یعنی داشبورد بعد از خواندن برنامه تغییر کرده است. اطلاعات تازه را بخوانید و فقط بخشهای لازم را دوباره بررسی کنید. خطای هندسهٔ چیدمان واکنشگرا یعنی Grid یا Stack نمیتواند محتوای درخواستی را در یک یا چند اندازهٔ نمایش جا دهد.
| بخش | نمونه |
|---|---|
| ویرایش کنسول | قالب، کانال داده، نگاشت، اتوماسیون و نسخه |
| ویرایش استودیو | داشبورد، صفحه، ویجت، اتصال، ظاهر، اعتبارسنجی و انتشار |
| FlovaQL | فهرست، اعتبارسنجی، اجرای پرسوجو و پرسوجوی ذخیرهشده |
| دستگاه | فهرست دستگاه و وضعیت زمان اجرا |
| برنامهریزی میانافزار | اطلاعات قالب و کانالهای داده |
MCP فرمان مستقیم دستگاه، راهاندازی، بارگذاری میانافزار، انتشار OTA یا ساخت کد فعالسازی را در اختیار نمیگذارد. عملیات حساس یا مخرب به تأیید نیاز دارند و مصرف فراخوانیهای MCP از سهمیهٔ طرح سازمان حساب میشود.
این سهمیه بین اعضای workspace مشترک است و هر ۳۰ روز بازنشانی میشود:
| پلن | فراخوانی MCP |
|---|---|
| رایگان | ۲۵۰ |
| استارتر | ۵۰۰ |
| حرفهای | ۲٬۵۰۰ |
| کسبوکار | ۱۰٬۰۰۰ |
صفحهٔ پلن و پرداخت در کنسول مصرف MCP دورهٔ فعلی را نشان میدهد. پس از پایان
سهمیه، MCP خطای mcp_quota_exhausted را همراه با نشانی پرداخت برمیگرداند.
برای دیدن رابطهٔ برنامههای بیرونی با دستیار داخل ویرایشگر، به دستیار برگردید.