MCP

חברו לקוחות בינה מלאכותית לחשבונות Influence, למדיה, לבדיקות, לתזמון ולתובנות זמינות.

בחרו את נקודת הקצה שמתאימה למשימה. כלי המוצר דורשים סביבת עבודה מורשית ב־Influence; שרת התיעוד קורא רק מדריכים ציבוריים.

נקודת קצה	מטרה
`https://influence.so/api/mcp`	חיבור כללי למוצר, כולל כלי תכנון, תמונות ומחקר שהופעלו.
`https://influence.so/api/mcp/claude`	חיבור ל־Claude. כולל העלאת מדיה, טיוטות, בדיקות, תזמון, תכנון ותובנות; אינו כולל כלי יצירת תמונות ו־`search`/`fetch`.
`https://docs.influence.so/mcp`	חיפוש וקריאה בתיעוד הציבורי. אין צורך בחשבון במוצר; אין לשרת גישה לנתוני סביבת העבודה או אפשרות לפרסם.

חיבור וגילוי

השתמשו בתהליך ה־OAuth של Influence בלקוח, או במפתח API עם הרשאות מוגדרות כשהלקוח תומך באימות מסוג Bearer. באפליקציות ואוטומציות מופיעות הוראות ההגדרה לכל לקוח. שמרו מפתחות API במשתני הסביבה הסודיים של הלקוח.

קראו את profileGet כדי לאמת את כתובת האימייל ואת סביבת העבודה (nickname) ב־Influence, ואז את connectionStatusGet להרשאות ולמכסת התזמון בעזרת בינה מלאכותית. כתובת האימייל שאיתה נכנסים ללקוח הבינה המלאכותית יכולה להיות שונה. בחרו בזהות הרצויה ב־Influence בזמן מתן ההרשאה.

חידוש OAuth דורש הסכמה מפורשת ל־offline_access. לחיבור מותאם אישית חדש ב־ChatGPT, הוראות ההגדרה מציינות גם את הרשאת הבסיס הזאת. רענון כלים אינו מוסיף הרשאות ואינו משדרג את הרשאות הבסיס של חיבור ישן.

השתמשו ב־tools/list ובמפרט כלי ה־MCP. גילוי הכלים עשוי להציג כלים שהרשאותיהם עדיין לא ניתנו; כל קריאה עדיין אוכפת הרשאות. התכונות שהופעלו והתמיכה של הלקוח משפיעות על הזמינות. נקודות הקצה הכללית ושל Claude שונות; הורדת מיומנות או תוסף אינה מוכיחה שהכלים נטענו בלקוח המותקן.

הכנת תוכן מוגמר

קראו את accountList, ואז את integrationSchema להגדרות ולמגבלות המדיה הנדרשות לכל חשבון שנבחר. השתמשו בכלי החיפוש הייעודיים של הספק ללוחות, לערוצים וליעדים דומים.
ייבאו קובץ HTTPS נגיש באמצעות mediaImport עם url ו־name לבחירה. קובץ אמיתי במארח משתמש באובייקט file הנפרד; אל תמציאו מזהי קבצים. לקבצים מקומיים, השתמשו בכלי ההעלאה מסוג multipart או בכלי העזר הקיים ב־SDK או ב־CLI. מגבלות המדיה והדרישה למדיה מוכנה חלות.
ל־1–10 פוסטים מוגמרים לתזמון, השתמשו ב־campaignScheduleBatchReview עם itemKey קבוע, draft ו־scheduledFor לכל פריט. הכלי שומר טיוטות ובדיקות ממתינות יחד, עם טקסט ומדיה לכל יעד ועד 50 מסירות. לעבודה על טיוטות בלבד או לעריכות, השתמשו ב־campaignDraftSave; campaignReview מכין את הפעולה הרצויה לקמפיין שמור.
הציגו את הבדיקה השמורה המלאה. כרטיס שמוצג ונטען מספק את ההצגה הזאת; בלעדיו, הציגו את החשבונות המדויקים, הטקסט, התצוגות המקדימות או הקישורים למדיה, ההגדרות, המועד המתוזמן ואזור הזמן. קראו את campaignReviewGet כשהבדיקה חסרה, אינה עדכנית או אינה ודאית.
קבלו אישור אנושי מפורש חדש לפני הביצוע. לכרטיס נתמך יש כפתור אישור משלו. לפוסטים מתאימים ברשתות חברתיות, אישור בצ׳אט נשלח דרך campaignReviewExecute או campaignScheduleBatchExecute. אסור למודל לקרוא לפעולת הממשק הפרטית campaignReviewApprove.

TikTok Direct תומך בצ׳אט רגיל. קראו את tiktokCreatorInfoGet, ואז שאלו שאלה מרוכזת אחת על הבחירות שטרם הושלמו לגבי נראות, אינטראקציות וקידום, וכן לגבי בינה מלאכותית ומוזיקה כשהדבר רלוונטי. הציגו את נוסח ההסכמה והקישורים הרלוונטיים; אל תסיקו שניתנה הסכמה ואל תפעילו אינטראקציות מוגבלות. שמרו את הבחירות המלאות של האדם באמצעות campaignReview עם reviewId ורשומות tiktokSettings שכוללות connectionId ו־settings. הפעולה מחזירה בדיקה ממתינה חדשה, ואינה מהווה אישור. הציגו את הבדיקה המדויקת הזאת והמתינו לאישור מפורש חדש לפני הביצוע. כרטיס בדיקה נתמך אינו חובה. פרסום דרך תיבת ההודעות של TikTok מושלם ב־TikTok.

ההסכמה ל־TikTok שייכת לבדיקה המדויקת; הסכמה שנשמרה בטיוטה אינה משלימה את השלב הזה. שמירת בחירות הבדיקה יוצרת גרסת טיוטה חדשה והופכת את הבדיקה הקודמת ללא עדכנית, גם כשההגדרות לא השתנו.

אישור והתאוששות

כלים שמסומנים ככאלה שדורשים אישור מבצעים תחילה הכנה ללא _confirmationCapability או _idempotencyKey. אשרו קלט עסקי זהה עם ערך האישור שהוחזר ומפתח אידמפוטנטיות קבוע שנוצר בצד הלקוח. התהליך הזה שומר או מבצע את הפעולה המוצהרת של הכלי; הוא נפרד מאישור אנושי לפרסום. כבדו את בקשות ההרשאה של המארח.

mediaUploadPart, mediaUploadComplete ו־mediaUploadAbort ממשיכים ישירות העלאה שכבר ניתנה הרשאה לביצועה. העבירו את בתי הקובץ לכתובות האחסון שהוחזרו, ולא ב־JSON של הכלי. לאחר הפרעה, קראו את סטטוס ההעלאה והמשיכו עם אותו קובץ ואותו clientKey.

expiresAt של העלאה הוא המועד האחרון הנוכחי להעברה או לעיבוד: בתחילה 24 שעות, ואז 15 דקות לאחר שפעולת ההשלמה מפעילה את העיבוד. תוקפה של מדיה מוכנה אינו פג במועד הזה; השתמשו שוב ב־assetId שלה מספריית המדיה.

שמרו את ערכי האישור והניסיון החוזר לאחר תוצאה לא ודאית. קראו את הבדיקה השמורה או את הקמפיין לפני ניסיון חוזר של פעולת פרסום; לעולם אל תניחו שחריגה מזמן ההמתנה פירושה שלא קרה דבר. בדיקה שהשתנתה או שפג תוקפה דורשת בדיקה ואישור חדשים.

מכסת התזמון בעזרת בינה מלאכותית חלה על לקוחות MCP ועל Influence IQ. אוטומציה רגילה דרך HTTP או CLI ותזמון ידני באתר אינם נכללים בה. כיסוי התובנות והתנהגות הרענון מתוארים בתובנות. הרשמה אופציונלית לקבלת אירועים דורשת תמיכה נפרדת שהופעלה במארח; זו אינה הבטחה כללית להתראות ברקע בכל לקוח.