# תיעוד כלי MCP

- [תיעוד כלי MCP](https://sosoapi.ai/he/docs/mcp): מצאו את קלט הכלים, הפלט שלהם, הפרופילים והזמינות בחיבור מקומי או מתארח.
- [קבלת פרופיל משתמש](https://sosoapi.ai/he/docs/mcp/get-user-profile): MCP: קבלת פרופיל משתמש. קריאת הפרופיל של המשתמש המחובר עצמו (שם תצוגה, אזור זמן, תמונת פרופיל, ערכת נושא); profile הוא null עד שקיים פרופיל.
- [עדכון פרופיל משתמש](https://sosoapi.ai/he/docs/mcp/update-user-profile): MCP: עדכון פרופיל משתמש. שינוי הפרופיל של המשתמש המחובר עצמו (display_name, timezone, avatar_url, theme). שלחו רק את השדות שיש לשנות.
- [חתימה על העלאת תמונת פרופיל](https://sosoapi.ai/he/docs/mcp/sign-avatar-upload): MCP: חתימה על העלאת תמונת פרופיל. קבלת URL חתום להעלאת תמונת פרופיל חדשה למשתמש המחובר (filename ו-content_type נדרשים). אינה משנה את הפרופיל כשלעצמה.
- [רשימת מפתחות API](https://sosoapi.ai/he/docs/mcp/list-api-keys): MCP: רשימת מפתחות API. הצגת מפתחות ה-API של המשתמש (שם, 4 תווים אחרונים, סטטוס, תוקף ורצף מקור); הגדירו include_authority כדי לקבל גם יכולות והגבלת סביבת עבודה לכל מפתח. סודות לעולם אינם מוחזרים. נדרשת הרשאת ניהול מפתחות API; ‏PAT אינו יכול להשתמש בפעולה.
- [יצירת מפתח API](https://sosoapi.ai/he/docs/mcp/create-api-key): MCP: יצירת מפתח API. יצירת מפתח גישה אישי עם יכולות נבחרות (agent:operate, agent:publish, agent:engage), הגבלת workspace_ids אופציונלית ותוקף של עד 365 ימים; הסוד מוחזר פעם אחת ואי אפשר לקרוא אותו שוב. סוכן יכול להעניק רק מה שההרשאה שלו כוללת, למשך עד 30 ימים, והמפתח מפסיק לפעול כשההרשאה מסתיימת. נדרשת הרשאת ניהול מפתחות API; ‏PAT אינו יכול להשתמש בפעולה.
- [הארכת מפתח API](https://sosoapi.ai/he/docs/mcp/extend-api-key): MCP: הארכת מפתח API. הגדרת תוקף מאוחר יותר (expires_at) למפתח API המזוהה לפי id: עד 365 ימים מעכשיו, או 30 למפתח שנוצר על ידי סוכן. סוכן יכול להאריך רק מפתחות שנוצרו תחת ההרשאה שלו. נדרשת הרשאת ניהול מפתחות API.
- [חידוש מפתח API](https://sosoapi.ai/he/docs/mcp/renew-api-key): MCP: חידוש מפתח API. יצירת מחליף למפתח API ‏(id) עם סוד חדש המוחזר פעם אחת ואותן יכולות והגבלת סביבת עבודה, ובאופן אופציונלי שם או תוקף חדש (עד 365 ימים, 30 למפתח שנוצר על ידי סוכן). המפתח המקורי אינו מבוטל. נדרשת הרשאת ניהול מפתחות API.
- [ביטול מפתח API](https://sosoapi.ai/he/docs/mcp/revoke-api-key): MCP: ביטול מפתח API. ביטול מפתח API לפי id כך שיפסיק לעבוד מייד; מפתח שכבר בוטל מדווח already_revoked. סוכן יכול לבטל רק מפתחות שנוצרו תחת ההרשאה שלו. נדרשת הרשאת ניהול מפתחות API.
- [קבלת מצב חיוב](https://sosoapi.ai/he/docs/mcp/get-billing-status): MCP: קבלת מצב חיוב. קריאת מסלול החיוב, מצב התשלום, תאריכי המחזור הנוכחי וניצול המכסות של המשתמש (פרסומים מוצלחים, פוסטים מתוזמנים ממתינים, חשבונות מחוברים). בדקו לפני סבבי תזמון גדולים.
- [קבלת גישה מסחרית](https://sosoapi.ai/he/docs/mcp/get-commercial-access): MCP: קבלת גישה מסחרית. קריאת נתוני המסלול והמכסות עבור חשבון החיוב של סביבת עבודה אחת, יחד עם commercial_access_mode שלה (off, shadow או enforce).
- [קבלת הקשר הארגון](https://sosoapi.ai/he/docs/mcp/get-organization-context): MCP: קבלת הקשר הארגון. קריאת המפה העדכנית של הארגונים, סביבות העבודה והערוצים שלכם, עם מזהים ותפקידים. השתמשו בה כשנדרשים מזהי ארגון או ערוץ. לפרסום בסביבת עבודה, השתמשו שוב במזהה סביבת עבודה שהוחזר; אין צורך לקרוא גם את הקשר סביבת העבודה.
- [יצירת סביבת עבודה](https://sosoapi.ai/he/docs/mcp/create-workspace): MCP: יצירת סביבת עבודה. יצירת סביבת עבודה בארגון שבבעלותכם או בניהולכם. העבירו organization_id אם אתם חברים במספר ארגונים. השתמשו ב-id שהוחזר לקריאות הבאות: אין להניח שסביבת העבודה החדשה הופכת לפעילה.
- [קבלת הקשר סביבת העבודה](https://sosoapi.ai/he/docs/mcp/get-workspace-context): MCP: קבלת הקשר סביבת העבודה. הצגת סביבות העבודה שהמשתמש המחובר חבר בהן ואיזו מהן פעילה. השתמשו כש-workspace_id אינו ידוע; השתמשו שוב בהקשר העדכני במקום לחזור על שתי קריאות ההקשר. סביבת העבודה הפעילה המדווחת היא הבחירה שאדם ביצע באפליקציית הווב, ולא ברירת מחדל לקריאות שלכם: העבירו workspace_id במפורש. זו אינה קריאה בלבד: לחשבון ללא סביבת עבודה נוצרת הראשונה.
- [עדכון סביבת עבודה](https://sosoapi.ai/he/docs/mcp/update-workspace): MCP: עדכון סביבת עבודה. שינוי שם סביבת עבודה או ה-slug שלה. לבעלים של סביבת העבודה בלבד.
- [רשימת ארגונים](https://sosoapi.ai/he/docs/mcp/list-organizations): MCP: רשימת ארגונים. הצגת הארגונים שהמשתמש המחובר חבר בהם, עם המזהים שכלים ברמת הארגון מקבלים בתור organization_id.
- [רשימת חיבורי הארגון](https://sosoapi.ai/he/docs/mcp/list-organization-connections): MCP: רשימת חיבורי הארגון. הצגת חיבורי הספקים של ארגון (Meta, Instagram, Threads, YouTube) והסטטוס שלהם. נדרש organization_id.
- [בדיקת חיבור ארגוני](https://sosoapi.ai/he/docs/mcp/review-organization-connection): MCP: בדיקת חיבור ארגוני. קריאת חשבונות הספק והדפים שהתגלו בפעולת חיבור ממתינה אחת (operation_id) לצורך בדיקה. לקריאה בלבד: אדם מאשר את החיבור באפליקציית הווב.
- [רשימת ערוצי הארגון](https://sosoapi.ai/he/docs/mcp/list-organization-channels): MCP: רשימת ערוצי הארגון. הצגת ערוצי הארגון (חשבונות ספק מחוברים) וסביבת העבודה שאליה משויך כל אחד.
- [תצוגה מקדימה של העברת ערוץ](https://sosoapi.ai/he/docs/mcp/preview-organization-channel-move): MCP: תצוגה מקדימה של העברת ערוץ. הרצת ניסיון: בדיקה אם אפשר להעביר ערוץ לסביבת עבודה אחרת והצגת החסמים. אינה משנה דבר.
- [רשימת חברים בסביבת העבודה](https://sosoapi.ai/he/docs/mcp/list-workspace-members): MCP: רשימת חברים בסביבת העבודה. הצגת חברי סביבת עבודה וההזמנות הממתינות שלה.
- [שליחת משוב](https://sosoapi.ai/he/docs/mcp/submit-feedback): MCP: שליחת משוב. שליחת משוב על המוצר (type הוא bug, feature או general; עד 4,000 תווים) לצוות SosoAPI בשם המשתמש. השתמשו רק כשהמשתמש מבקש.
- [קבלת העדפות התראות](https://sosoapi.ai/he/docs/mcp/get-notification-preferences): MCP: קבלת העדפות התראות. קריאת הגדרות ההתראות של המשתמש (כרגע, האם נשלח דוא״ל כשפוסט נכשל).
- [עדכון העדפות התראות](https://sosoapi.ai/he/docs/mcp/update-notification-preferences): MCP: עדכון העדפות התראות. שינוי הגדרות ההתראות של המשתמש (הפעלה או כיבוי של email_post_failed).
- [רשימת התראות בתיבת הדואר הנכנס](https://sosoapi.ai/he/docs/mcp/list-inbox-notifications): MCP: רשימת התראות בתיבת הדואר הנכנס. קריאת תיבת הדואר הנכנס של המשתמש באפליקציה, מהחדש לישן (עד 50), ואפשר לסנן לפריטים שלא נקראו או לסוג אחד.
- [רשימת חשבונות מחוברים](https://sosoapi.ai/he/docs/mcp/list-connected-accounts): MCP: רשימת חשבונות מחוברים. הצגת החשבונות החברתיים (Instagram, Threads, Facebook, YouTube) המחוברים לסביבת עבודה, עם נתוני תקינות החיבור והיכולות. השתמשו במזהים שלהם בתור social_account_id בתזמון או בתגובות. העבירו workspace_id: בקשה בלעדיו נדחית לאחר אכיפת יעד מפורש.
- [ניתוק חשבון חברתי](https://sosoapi.ai/he/docs/mcp/disconnect-social-account): MCP: ניתוק חשבון חברתי. ניתוק חשבון חברתי מסביבת העבודה שלו (לבעלים של סביבת העבודה בלבד). הפרסום אליו נעצר עד שאדם מחבר אותו שוב באמצעות `sosoapi connect`.
- [הגדרת סנכרון אוטומטי לחשבון חברתי](https://sosoapi.ai/he/docs/mcp/set-social-account-auto-sync): MCP: הגדרת סנכרון אוטומטי לחשבון חברתי. הפעלה או כיבוי של סנכרון אוטומטי לחשבון חברתי מחובר אחד (תפקיד editor). לא מתפרסם דבר.
- [הסרת חסימה מחשבון חברתי](https://sosoapi.ai/he/docs/mcp/clear-social-account-block): MCP: הסרת חסימה מחשבון חברתי. סיום צינון של הספק בחשבון כדי שהפרסום יוכל להתחדש. אינו מנסה שוב לפרסם פוסט שנכשל; לשם כך השתמשו ב-sosoapi_retry_scheduled_post.
- [שאילתת נכסים](https://sosoapi.ai/he/docs/mcp/query-assets): MCP: שאילתת נכסים. מציאת נכסי סביבת עבודה לפי asset_type, ‏source או tag; מוחזרים עמוד (limit עד 100, בתוספת offset) והסכום הכולל. העבירו workspace_id במפורש.
- [קבלת נכס](https://sosoapi.ai/he/docs/mcp/get-asset): MCP: קבלת נכס. קריאת נכס אחד לפי id: מטא-נתונים ו-URL לתצוגה מקדימה לזמן קצר.
- [יצירת נכס](https://sosoapi.ai/he/docs/mcp/create-asset): MCP: יצירת נכס. רישום רשומת נכס עבור מדיה או טקסט שכבר מאוחסנים אצלכם (asset_url, asset_type). הפעולה אינה מעלה דבר: השתמשו ב-sosoapi_upload_asset לקובץ מקומי או ב-sosoapi_import_asset_url כדי ש-SosoAPI ימשוך URL ציבורי. העבירו workspace_id (הבקשה תידחה בלעדיו לאחר אכיפת יעד מפורש). idempotency_key אופציונלי.
- [עדכון נכס](https://sosoapi.ai/he/docs/mcp/update-asset): MCP: עדכון נכס. שינוי כותרת, תיאור או תגיות של נכס (תפקיד editor).
- [מחיקת נכס](https://sosoapi.ai/he/docs/mcp/delete-asset): MCP: מחיקת נכס. מחיקת נכס אחד מספריית סביבת העבודה לפי id. לבעלים של סביבת העבודה בלבד.
- [רשימת נכסים](https://sosoapi.ai/he/docs/mcp/list-assets): MCP: רשימת נכסים. הצגת נכסי סביבת עבודה בסינון לפי kind ‏(video, image, audio, cover, thumbnail, frame, video-source, branding) או customer_ready_only, עם דפדוף next_offset. ‏workspace_id נדרש.
- [ייבוא נכס מ-URL](https://sosoapi.ai/he/docs/mcp/import-asset-url): MCP: ייבוא נכס מ-URL. בקשה מ-SosoAPI להוריד תמונה או סרטון מ-URL ציבורי מסוג http(s) לאחסון פרטי בסביבת העבודה כנכס חדש. מוחזר import_id; בדקו באמצעות sosoapi_get_asset_import_status. נדרשים idempotency_key ותפקיד editor.
- [קבלת סטטוס ייבוא נכס](https://sosoapi.ai/he/docs/mcp/get-asset-import-status): MCP: קבלת סטטוס ייבוא נכס. קריאת ייבוא לפי import_id. לצורך פרסום, העבירו include_asset=true: תוצאה במצב ready כוללת את מזהה הנכס הרשום, הסוג ו-asset_url יציב, וחוסכת קריאת get_asset נפרדת. אי אפשר לתזמן נכסים ממתינים או חסרים. לעולם אין להשתמש ב-URL המקור או התצוגה המקדימה כזהות המדיה. אם הייבוא תקוע, קראו sosoapi_job_status עם job_id; לעולם אין להתחיל ייבוא כפול.
- [רשימת נכסים יתומים](https://sosoapi.ai/he/docs/mcp/list-orphan-assets): MCP: רשימת נכסים יתומים. הצגת אובייקטים מאוחסנים בסביבת עבודה ששום רשומת נכס אינה מפנה אליהם (ניקוי אחסון), עם דפדוף באמצעות אסימון המשך. לבעלים של סביבת העבודה בלבד.
- [מחיקת נכסים יתומים](https://sosoapi.ai/he/docs/mcp/delete-orphan-assets): MCP: מחיקת נכסים יתומים. מחיקת אובייקטי אחסון נבחרים שאינם רשומים לפי key. לבעלים של סביבת העבודה בלבד; הציגו אותם תחילה באמצעות sosoapi_list_orphan_assets.
- [קבלת מצאי אחסון הנכסים](https://sosoapi.ai/he/docs/mcp/get-asset-storage-inventory): MCP: קבלת מצאי אחסון הנכסים. קריאת מצאי מדופדף של הנכסים הרשומים והאובייקטים המאוחסנים בסביבת עבודה לצורך ביקורת אחסון.
- [יצירת ייצוא נכסים](https://sosoapi.ai/he/docs/mcp/create-asset-export): MCP: יצירת ייצוא נכסים. ייצוא נכסים נבחרים (asset_ids) כמניפסט. מצב export_verify_then_purge מכין אותם למחיקה סופית מאוחרת יותר. idempotency_key אופציונלי.
- [אימות ייצוא נכסים](https://sosoapi.ai/he/docs/mcp/verify-asset-export): MCP: אימות ייצוא נכסים. התחלת אימות ייצוא נכסים (export_id). יש לאמת ייצוא לפני שאפשר לבקש מחיקה סופית.
- [קבלת סטטוס ייצוא נכסים](https://sosoapi.ai/he/docs/mcp/get-asset-export-status): MCP: קבלת סטטוס ייצוא נכסים. קריאת סטטוס ייצוא נכסים: exported, verification_required, verifying, verified או failed.
- [בקשת מחיקה סופית של נכסים](https://sosoapi.ai/he/docs/mcp/request-asset-purge): MCP: בקשת מחיקה סופית של נכסים. בקשת מחיקה לצמיתות של בתי האחסון של נכסים הכלולים בייצוא מאומת (export_id, asset_ids; ייתכן שיידרש confirm_history_loss). לבעלים של סביבת העבודה בלבד; המחיקה בלתי הפיכה.
- [ניסיון חוזר למחיקה סופית של נכסים](https://sosoapi.ai/he/docs/mcp/retry-asset-purge): MCP: ניסיון חוזר למחיקה סופית של נכסים. ניסיון חוזר לבקשת מחיקה סופית שנעצרה (purge_request_id). לבעלים של סביבת העבודה בלבד.
- [רשימת פרויקטים](https://sosoapi.ai/he/docs/mcp/list-projects): MCP: רשימת פרויקטים. הצגת פרויקטי סביבת עבודה (שכבה אופציונלית למקור ולברירות מחדל של חשבונות) ואיזה מהם פעיל.
- [קבלת פרויקט](https://sosoapi.ai/he/docs/mcp/get-project): MCP: קבלת פרויקט. קריאת פרויקט אחד לפי id: שם, מצב מחזור החיים וגרסאות מחזור החיים וברירות המחדל הנדרשות לכתיבות בהמשך.
- [יצירת פרויקט](https://sosoapi.ai/he/docs/mcp/create-project): MCP: יצירת פרויקט. יצירת פרויקט בסביבת עבודה. לבעלים של סביבת העבודה בלבד; idempotency_key אופציונלי.
- [עדכון פרויקט](https://sosoapi.ai/he/docs/mcp/update-project): MCP: עדכון פרויקט. שינוי שם פרויקט (שמו הוא השדה היחיד שניתן לעריכה). לבעלים של סביבת העבודה בלבד.
- [הגדרת פרויקט פעיל](https://sosoapi.ai/he/docs/mcp/set-active-project): MCP: הגדרת פרויקט פעיל. הגדרת הפרויקט הפעיל של המשתמש (ברירת מחדל בצד השרת).
- [קבלת ברירות המחדל של חשבונות הפרויקט](https://sosoapi.ai/he/docs/mcp/get-project-account-defaults): MCP: קבלת ברירות המחדל של חשבונות הפרויקט. קריאת חשבונות ברירת המחדל של פרויקט והחרגות לכל חשבון, עם defaults_version הנדרש להחלפה הבאה.
- [החלפת ברירות המחדל של חשבונות הפרויקט](https://sosoapi.ai/he/docs/mcp/replace-project-account-defaults): MCP: החלפת ברירות המחדל של חשבונות הפרויקט. החלפת חשבונות ברירת המחדל של פרויקט וההחרגות בצעד אחד. נדרשים expected_defaults_version מהקריאה האחרונה ו-idempotency_key (תפקיד editor).
- [העברת פרויקט לארכיון](https://sosoapi.ai/he/docs/mcp/archive-project): MCP: העברת פרויקט לארכיון. העברת פרויקט לארכיון בלי לשנות את ה-Scheduled Posts שלו. כדי לעצור פוסט, יש לבטל את ה-Scheduled Post הזה בנפרד. לבעלים של סביבת העבודה בלבד; העבירו expected_lifecycle_version ו-idempotency_key.
- [הוצאת פרויקט מהארכיון](https://sosoapi.ai/he/docs/mcp/unarchive-project): MCP: הוצאת פרויקט מהארכיון. הפעלה מחדש של פרויקט בארכיון. פעולה זו אינה מחדשת או מתזמנת מחדש פוסטים; נהלו אותם דרך Scheduled Posts. לבעלים של סביבת העבודה בלבד; העבירו expected_lifecycle_version ו-idempotency_key.
- [קבלת היסטוריית מחזור החיים של הפרויקט](https://sosoapi.ai/he/docs/mcp/get-project-lifecycle-history): MCP: קבלת היסטוריית מחזור החיים של הפרויקט. קריאת אירועי מחזור החיים של פרויקט (כגון העברה לארכיון והוצאה ממנו), עד 200.
- [קבלת פרופיל פרויקט](https://sosoapi.ai/he/docs/mcp/get-project-profile): MCP: קבלת פרופיל פרויקט. קריאת פרופיל המותג של פרויקט (סלוגן, קול, קהל יעד, מטרות, פלטת צבעים ועוד); profile הוא null כשאין פרופיל.
- [עדכון פרופיל פרויקט](https://sosoapi.ai/he/docs/mcp/update-project-profile): MCP: עדכון פרופיל פרויקט. עדכון חלקי של שדות פרופיל המותג של פרויקט. שדות שהושמטו נשארים ללא שינוי. נדרשים expected_profile_version מהקריאה האחרונה ו-idempotency_key (תפקיד editor).
- [רשימת נכסי הפרויקט](https://sosoapi.ai/he/docs/mcp/list-project-assets): MCP: רשימת נכסי הפרויקט. הצגת נכסים המקושרים לפרויקט עם relationship של כל קישור (identity, source או reference), בדפדוף באמצעות סמן.
- [קישור נכס לפרויקט](https://sosoapi.ai/he/docs/mcp/link-project-asset): MCP: קישור נכס לפרויקט. קישור נכס קיים לפרויקט בתור identity, ‏source או reference. תפקיד editor; ‏idempotency_key נדרש.
- [ביטול קישור נכס לפרויקט](https://sosoapi.ai/he/docs/mcp/unlink-project-asset): MCP: ביטול קישור נכס לפרויקט. הסרת קישור נכס לפרויקט; הנכס עצמו נשמר. idempotency_key נדרש.
- [רשימת חשבונות הפרויקט](https://sosoapi.ai/he/docs/mcp/list-project-accounts): MCP: רשימת חשבונות הפרויקט. הצגת החשבונות החברתיים המקושרים לפרויקט, בדפדוף באמצעות סמן.
- [קישור חשבון לפרויקט](https://sosoapi.ai/he/docs/mcp/link-project-account): MCP: קישור חשבון לפרויקט. קישור חשבון חברתי מחובר לפרויקט. תפקיד editor; ‏idempotency_key נדרש.
- [ביטול קישור חשבון לפרויקט](https://sosoapi.ai/he/docs/mcp/unlink-project-account): MCP: ביטול קישור חשבון לפרויקט. הסרת קישור חשבון חברתי לפרויקט; החשבון נשאר מחובר. idempotency_key נדרש.
- [יצירת ייצוא פרויקט](https://sosoapi.ai/he/docs/mcp/create-project-export): MCP: יצירת ייצוא פרויקט. התחלת ייצוא פרויקט (לבעלים של סביבת העבודה בלבד); בדקו באמצעות sosoapi_get_project_export_status לקבלת URL להורדה. idempotency_key נדרש.
- [קבלת סטטוס ייצוא פרויקט](https://sosoapi.ai/he/docs/mcp/get-project-export-status): MCP: קבלת סטטוס ייצוא פרויקט. קריאת ייצוא פרויקט (export_id): ‏queued, ‏processing, ‏completed (עם URL קצר-חיים להורדה) או failed. לבעלים של סביבת העבודה בלבד.
- [רשימת תוצאות פרסום הדורשות טיפול](https://sosoapi.ai/he/docs/mcp/list-publication-attentions): MCP: רשימת תוצאות פרסום הדורשות טיפול. הצגת פרסומים בסביבת עבודה הדורשים טיפול, בסינון לפי status ‏(open או resolved) או scheduled_post_id, עם דפדוף לפי offset.
- [קבלת קרדיטים לפרסום ב-X](https://sosoapi.ai/he/docs/mcp/get-x-usage): MCP: קבלת קרדיטים לפרסום ב-X. קריאת קרדיטי הפרסום ב-X של הארגון המשותפים לסביבת העבודה הזו. נדרש workspace_id. ‏Free מקבל 10 פעם אחת; Pro מקבל 100 לכל תקופת חיוב. טקסט עולה 1, טקסט המכיל URL עולה 10. ‏text אופציונלי מחזיר הצעת עלות. הפעולה קוראת מכסה שמורה ואינה קוראת ל-X API.
- [רשימת פוסטים מתוזמנים](https://sosoapi.ai/he/docs/mcp/list-scheduled-posts): MCP: רשימת פוסטים מתוזמנים. הצגת פוסטים מתוזמנים של סביבת עבודה, בסינון לפי פרויקט, status ‏(scheduled, publishing, published, failed, expired, needs_reschedule, cancelled, deleted) וטווח זמן, בדפדוף באמצעות סמן.
- [קבלת פוסט מתוזמן](https://sosoapi.ai/he/docs/mcp/get-scheduled-post): MCP: קבלת פוסט מתוזמן. קריאת פוסט מתוזמן אחד לפי id: תוכן, סטטוס, מצב מסירה ותוצאות. הגרסה שלו היא זו ש-update, publish, retry ו-cancel דורשים בתור expected_version.
- [קבלת התאמה לתזמון פוסט](https://sosoapi.ai/he/docs/mcp/get-scheduled-post-eligibility): MCP: קבלת התאמה לתזמון פוסט. בדיקה מקדימה לקריאה בלבד לכל יעד. כללו draft ‏(caption, hashtags, scheduled_at, display_timezone, ובאופן אופציונלי זמן מקומי/DST) לבדיקות תוכן ותזמון; include_quota=true מוסיף תמונת מצב מייעצת לתקופה. העלו/ייבאו מדיה והמתינו למוכנות תחילה. ללא draft נבדקים רק החשבון והמדיה. דבר אינו נשמר כמכסה; create/dispatch בודקים שוב מגבלות והרשאה.
- [יצירת פוסט מתוזמן](https://sosoapi.ai/he/docs/mcp/create-scheduled-post): MCP: יצירת פוסט מתוזמן. תזמון חשבון אחד ב-scheduled_at עם provider_payload. מדיה דורשת asset_id מוכן ו-URL קנוני; לתמונת מקור אחת השתמשו ב-sosoapi_post_image_url. יש לצרף local_scheduled_at יחד עם schedule_dst_disambiguation או להשמיט את שניהם. נדרשים publish, תפקיד editor ו-idempotency_key. מתוזמן אינו מפורסם: קראו את התוצאה.
- [יצירת פוסטים מתוזמנים באצווה](https://sosoapi.ai/he/docs/mcp/bulk-create-scheduled-posts): MCP: יצירת פוסטים מתוזמנים באצווה. תזמון פוסטים למספר חשבונות בקריאה אחת (targets). מדיה דורשת asset_ids של נכסים מוכנים שהועלו/יובאו ואת כתובות ה-URL הקנוניות שלהם. כל יעד מצליח או נכשל בנפרד ומדווח ב-successes או failures. נדרשת יכולת publish.
- [עדכון פוסט מתוזמן](https://sosoapi.ai/he/docs/mcp/update-scheduled-post): MCP: עדכון פוסט מתוזמן. עריכת פוסט מתוזמן שטרם שוגר (כיתוב, תגיות, מדיה, קישור, שעה). נדרש expected_version מהקריאה האחרונה; גרסה מיושנת נדחית.
- [פרסום פוסט מתוזמן עכשיו](https://sosoapi.ai/he/docs/mcp/publish-scheduled-post-now): MCP: פרסום פוסט מתוזמן עכשיו. פרסום פוסט מתוזמן מייד במקום ב-scheduled_at. ציבורי ואינו ניתן לביטול; נדרש expected_version. כניסה לתור אינה פרסום: קראו את התוצאה.
- [ניסיון חוזר לפוסט מתוזמן](https://sosoapi.ai/he/docs/mcp/retry-scheduled-post): MCP: ניסיון חוזר לפוסט מתוזמן. ניסיון חוזר לפוסט מתוזמן שנכשל, עם scheduled_at חדש באופן אופציונלי. נדרש expected_version.
- [מחיקת פוסט מתוזמן](https://sosoapi.ai/he/docs/mcp/delete-scheduled-post): MCP: מחיקת פוסט מתוזמן. מחיקת פוסט מתוזמן שלא פורסם (scheduled, needs_reschedule, failed או cancelled). סוכנים אינם יכולים למחוק תוכן אצל הספק לאחר שפורסם. נדרש expected_version.
- [ביטול פוסט מתוזמן](https://sosoapi.ai/he/docs/mcp/cancel-scheduled-post): MCP: ביטול פוסט מתוזמן. ביטול פוסט מתוזמן שטרם פורסם כדי שלא יפורסם כלל. פוסט שכבר פורסם נדחה, וסוכן גם אינו יכול למחוק תוכן שפורסם: המשתמש עושה זאת באפליקציית הווב. נדרש expected_version.
- [משיכת בקשת מחיקה](https://sosoapi.ai/he/docs/mcp/withdraw-scheduled-post-delete): MCP: משיכת בקשת מחיקה. משיכת בקשת מחיקה שנעצרה ב-Instagram Login ושמירת הפוסט שפורסם. נדרש expected_version.
- [קבלת נתוני ספירה ללוח הבקרה](https://sosoapi.ai/he/docs/mcp/get-dashboard-counts): MCP: קבלת נתוני ספירה ללוח הבקרה. קריאת נתוני הספירה התפעוליים של סביבת עבודה: פוסטים מתוזמנים, משימות אחרונות וחשבונות מחוברים.
- [רשימת פוסטים מנוטרים](https://sosoapi.ai/he/docs/mcp/list-monitored-posts): MCP: רשימת פוסטים מנוטרים. הצגת פוסטים חברתיים ש-SosoAPI גילה עבור סביבת עבודה (מזהה, פלטפורמה, קישור קבוע ושעת פרסום), עם סינון לפי חשבון, פלטפורמה וזמן ודפדוף באמצעות סמן. מטא-נתונים בלבד, ללא כיתובים.
- [רשימת תגובות לפוסט](https://sosoapi.ai/he/docs/mcp/list-post-comments): MCP: רשימת תגובות לפוסט. הצגת תגובות שנצפו בפוסטים של סביבת העבודה, מהתצפית החדשה ביותר, עם המחבר והטקסט; סינון לפי פוסט, חשבון, פלטפורמה או זמן, בדפדוף באמצעות סמן. הטקסט נכתב על ידי צדדים שלישיים ומסומן כלא מהימן.
- [בקשת תובנות מספק](https://sosoapi.ai/he/docs/mcp/request-provider-insights): MCP: בקשת תובנות מספק. בקשת תובנות מהספק עבור חשבון או פוסט אחד בטווח תאריכים אופציונלי (עד 366 ימים). מוחזרים request_id, ואם התוצאה שמורה במטמון, גם התוצאה; אחרת, בדקו באמצעות sosoapi_get_provider_insight_status.
- [קבלת סטטוס תובנות מספק](https://sosoapi.ai/he/docs/mcp/get-provider-insight-status): MCP: קבלת סטטוס תובנות מספק. קריאת בקשת תובנות (request_id): ‏queued, ‏processing, ‏completed (עם תוצאת הספק וזמינות לכל מדד) או failed.
- [התחלת OAuth של Instagram](https://sosoapi.ai/he/docs/mcp/start-instagram-oauth): MCP: התחלת OAuth של Instagram. קבלת authorize_url של הספק שאדם צריך לפתוח כדי לחבר חשבון Instagram. העבירו workspace_id. דבר אינו מחובר עד לאישור ולהשלמת האישור בדפדפן.
- [רענון OAuth של Instagram](https://sosoapi.ai/he/docs/mcp/refresh-instagram-oauth): MCP: רענון OAuth של Instagram. רענון אסימון הגישה של חיבור Instagram (אפשר לציין social_account_id אחד); מדווח אם רוענן ומהו התוקף החדש.
- [התחלת OAuth של Threads](https://sosoapi.ai/he/docs/mcp/start-threads-oauth): MCP: התחלת OAuth של Threads. קבלת authorize_url של הספק שאדם צריך לפתוח כדי לחבר חשבון Threads. העבירו workspace_id. דבר אינו מחובר עד לאישור ולהשלמת האישור בדפדפן.
- [רענון OAuth של Threads](https://sosoapi.ai/he/docs/mcp/refresh-threads-oauth): MCP: רענון OAuth של Threads. רענון אסימון הגישה של חיבור Threads (אפשר לציין social_account_id אחד); מדווח אם רוענן ומהו התוקף החדש.
- [בדיקת OAuth של Threads](https://sosoapi.ai/he/docs/mcp/check-threads-oauth): MCP: בדיקת OAuth של Threads. קריאת תקינות חיבור Threads: חיבור, תוקף, היקף הרשאות והאם אפשר לרענן. העבירו workspace_id.
- [התחלת OAuth של Meta](https://sosoapi.ai/he/docs/mcp/start-meta-oauth): MCP: התחלת OAuth של Meta. קבלת authorize_url של הספק שאדם צריך לפתוח כדי לחבר דף Facebook, או Instagram דרך Facebook ‏(connection_intent). העבירו workspace_id. דבר אינו מחובר עד לאישור ולהשלמת האישור בדפדפן.
- [רענון OAuth של Meta](https://sosoapi.ai/he/docs/mcp/refresh-meta-oauth): MCP: רענון OAuth של Meta. אימות מחדש של חיבור Facebook/Meta ‏(social_account_id) ודיווח capability_verified.
- [התחלת OAuth של YouTube](https://sosoapi.ai/he/docs/mcp/start-youtube-oauth): MCP: התחלת OAuth של YouTube. קבלת authorize_url של הספק שאדם צריך לפתוח כדי לחבר ערוץ YouTube. העבירו workspace_id. דבר אינו מחובר עד לאישור ולהשלמת האישור בדפדפן.
- [רענון OAuth של YouTube](https://sosoapi.ai/he/docs/mcp/refresh-youtube-oauth): MCP: רענון OAuth של YouTube. רענון אסימון חיבור YouTube ‏(social_account_id); מוחזרים התוקף החדש ו-capability_verified.
- [רשימת משימות](https://sosoapi.ai/he/docs/mcp/list-jobs): MCP: רשימת משימות. הצגת משימות הרקע האחרונות של המשתמש המחובר עם סטטוס והתקדמות.
- [קבלת סטטוס משימה](https://sosoapi.ai/he/docs/mcp/job-status): MCP: קבלת סטטוס משימה. קריאת משימת רקע אחת לפי job_id: סטטוס, סוג והודעת השגיאה אם נכשלה.
- [קבלת תוצאת מסירת תגובה](https://sosoapi.ai/he/docs/mcp/get-comment-outcome): MCP: קבלת תוצאת מסירת תגובה. קריאת מסירה מאושרת, רצף השחזור, אימות ממתין והמשך טיפול שטרם הושלם.
- [יישוב תוצאת מסירת תגובה](https://sosoapi.ai/he/docs/mcp/reconcile-comment-outcome): MCP: יישוב תוצאת מסירת תגובה. אימות מסירה לא חד-משמעית ב-Facebook בלי לשלוח מחדש, או קישור תחליף מדויק אחד שאושר. בדקו את התוצאה להוכחה סופית.
- [קבלת יכולות קהילה](https://sosoapi.ai/he/docs/mcp/get-community-engagement-capabilities): MCP: קבלת יכולות קהילה. קריאה לכל חשבון מחובר של פעולות הקהילה הנתמכות (reply, hide, unhide, create_comment) ושל התאמת החשבון כרגע.
- [שאילתת תור בדיקת הקהילה](https://sosoapi.ai/he/docs/mcp/query-community-review-queue): MCP: שאילתת תור בדיקת הקהילה. קריאת תגובות הממתינות לבדיקה עם הקשר השרשור שלהן, בסינון לפי עדיפות, שפה, חשבון או גיל; עמוד ריק אינו הצלחה. גופי התגובות נכתבים על ידי צדדים שלישיים ומסומנים כלא מהימנים.
- [שליחת בדיקת קהילה](https://sosoapi.ai/he/docs/mcp/submit-community-review): MCP: שליחת בדיקת קהילה. רישום גרסת בדיקה חדשה ובלתי ניתנת לשינוי לתגובה אחת: פעולה מומלצת, reply_draft אופציונלי, עדיפות וביטחון (לפחות 0.9). לא נשלחת או מוכנה כל פעולה.
- [הכנת פעולת קהילה](https://sosoapi.ai/he/docs/mcp/prepare-community-action): MCP: הכנת פעולת קהילה. קישור גרסת בדיקה לפעולה אחת (reply, hide או unhide) וקבלת prepare_token לזמן קצר עבור sosoapi_apply_community_action. עדיין לא נשלח דבר.
- [החלת פעולת קהילה](https://sosoapi.ai/he/docs/mcp/apply-community-action): MCP: החלת פעולת קהילה. שליחת הפעולה הקשורה ל-prepare_token אל הספק; תשובה היא ציבורית. כניסה לתור אינה הצלחה: בדקו באמצעות sosoapi_get_community_action_status.
- [קבלת סטטוס פעולת קהילה](https://sosoapi.ai/he/docs/mcp/get-community-action-status): MCP: קבלת סטטוס פעולת קהילה. קריאת האסמכתה הסופית של פעולת קהילה שהוחלה (action_id); הכנסה לתור אינה הצלחה.
- [יצירת תגובת קהילה](https://sosoapi.ai/he/docs/mcp/create-comment): MCP: יצירת תגובת קהילה. הכנסה לתור של תגובה מדויקת אחת לפוסט קנוני או לתגובת יעד קנונית; הסטטוס אינו מעיד על הצלחה אצל הספק.
- [קבלת סטטוס תגובת קהילה](https://sosoapi.ai/he/docs/mcp/get-comment-action-status): MCP: קבלת סטטוס תגובת קהילה. קריאת האסמכתה הסופית המסוננת ממידע רגיש לפעולת תגובה ישירה.
- [קבלת סיכום קהילה](https://sosoapi.ai/he/docs/mcp/get-community-engagement-summary): MCP: קבלת סיכום קהילה. קריאת סיכום פעולות הקהילה של סביבת עבודה: מצב המסלול, עבודה ממתינה, זמני תגובה, סטטוסי פעולות וקצבי הספק.
- [פרסום תמונה אחת מ-URL](https://sosoapi.ai/he/docs/mcp/post-image-url): MCP: פרסום תמונה אחת מ-URL. שליחת פוסט התמונה המלא מ-URL פעם אחת, עם media ריק. השרת מכין ומפרסם אותו גם לאחר ניתוק. מוחזרת תוצאת פרסום סופית אם היא זמינה בתוך 35 שניות, אחרת מוחזר מזהה פוסט עמיד; לעולם אין לשלוח שוב עם מפתח חדש. נדרשות הרשאות operate ו-publish. שדות זמן מקומי/DST נמסרים יחד. import_id מיועד רק להמשך פעולה של לקוחות ישנים.
- [העלאת תמונה או סרטון מקומיים](https://sosoapi.ai/he/docs/mcp/upload-asset): MCP: העלאת תמונה או סרטון מקומיים. העלאת קובץ תמונה או סרטון מקומי לספריית נכסים בסביבת עבודה ורישומו כנכס. מתקבלים רק קובצי PNG/JPEG/GIF/WebP/MP4/MOV/WebM/MKV/MPEG אמיתיים עד 500 MiB מתיקיית העבודה, התיקייה הזמנית, Pictures/Movies/Videos או SOSOAPI_UPLOAD_ROOTS; קבצים ותיקיות ששמם מתחיל בנקודה נדחים. מוחזרים מזהה הנכס וה-URL לשימוש במדיה של Scheduled Post.