MCP ל-Instagram: פרסום תמונות, קרוסלות ו-Reels
מדריך MCP ל-Instagram ב-Mellow Hub: דרישות החשבון, התחברות דרך Instagram או Facebook, קלטי פוסט שנבדקו, תזמון ותיקון שגיאות אימות נפוצות.
מאת Mellow · עודכןהאם עוזר AI יכול לפרסם ב-Instagram דרך MCP?
כן, אם יש לעוזר כלי פרסום מורשה וחשבון Instagram מחובר שעומד בדרישות. Mellow Hub מספק את הכלים האלה בכתובת https://www.mellow.world/mcp. לקוח MCP מרוחק תואם יכול לאמת פוסט, לתזמן אותו בגבולות ההרשאות שבעל החשבון האציל, ולקרוא את התוצאה הסופית ביעד.
כדאי להתחיל מהחשבון ומטיוטה אמיתית אחת. MCP הוא החיבור לכלים; ההחלטה אם החשבון, ההרשאות והמדיה יכולים לפרסם נשארת בידי Instagram. המדריך הזה עוסק ב-Mellow Hub. לתכנון תוכן Instagram משלך ב-iPhone או בדפדפן, כדאי לעיין במדריך התכנון הנפרד של Mellow.
איזה חשבון Instagram צריך?
צריך חשבון Instagram מקצועי, מסוג עסקי (Business) או יוצר תוכן (Creator). חשבון אישי לא מתאים לתהליך הפרסום הזה דרך ה-API. ב-Hub יש לפתוח את הדף חשבונות, לבחור ב-Instagram ולהשלים את חיבור החשבון בעצמך.
| אפשרות התחברות | מה להכין |
|---|---|
| התחברות דרך Instagram | מסלול ההתחברות הישיר. ממשק ה-API של Meta להתחברות דרך Instagram לא דורש דף Facebook מקושר. |
| התחברות דרך Facebook | חשבון ה-Instagram המקצועי כשהוא מקושר לדף Facebook, עם הגישה המתאימה לדף. |
אלה מסלולי הרשאה שונים. יש לבחור את המסלול שמתאים להגדרת החשבון שלך; השלמה של מסלול אחד לא מעניקה את כל ההרשאות של המסלול השני. אוסף ה-API הרשמי של Instagram מבית Meta מתעד את ההבדל. החיבור המנוהל ש-Hub משתמש בו מתואר בדרישות החשבון של Post for Me.
ל-Stories נדרשת בדיקת זכאות נוספת: התיעוד של Meta להתחברות דרך Facebook מגביל את פרסום ה-Stories לחשבונות עסקיים (Business). העובדה שפורמט מופיע בכללי הקלט של Hub לא מוכיחה שהחשבון שלך יכול לפרסם אותו. לפני שמסתמכים על הפורמט הזה, כדאי לבדוק את החשבון המחובר ואת תוצאת הפרסום בפועל שלו.
חיבור העוזר ובדיקת הסמכויות שלו
- לחבר את חשבון ה-Instagram שלך ב-Hub. מזהה הערוץ שמוחזר הוא המזהה של החיבור הזה; שם המשתמש ב-Instagram לא יכול לשמש במקומו.
- להוסיף את נקודת הקצה של Hub בלקוח שתומך ב-MCP מרוחק על גבי Streamable HTTP. לעבור את תהליך ה-OAuth שלו, או להשתמש במפתח Hub שבעל החשבון יצר, אם הלקוח תומך בזה. ההגדרה והזמינות תלויות בלקוח. את פרטי הגישה יש לשמור בהגדרות המאובטחות של הלקוח.
- במסך ההסכמה של OAuth ב-Hub, לבחור הרשאות, ערוצים, מצב, תקרה יומית ותוקף. מצב אישור מכין את העבודה לאישור של אדם. טייס אוטומטי מאפשר לפרסם בגבולות ההרשאות שהואצלו. את הגישה שנוצרה אפשר לראות או לבטל בדף סוכנים.
- לקרוא ל-
whoamiול-list_channels. לבדוק מה המצב בפועל ולהשתמש במזהה ערוץ ה-Instagram שהוחזר. הכללים העדכניים מופיעים בתוצאה שלlist_platforms. - להכין מדיה נגישה. להשתמש ב-
register_mediaכדי לבדוק URL ציבורי קיים, או ב-request_upload_urlכדי להעלות קובץ מקומי. ה-URL שמתקבל צריך להישאר נגיש עד מועד הפרסום המתוכנן.
את רצף החיבור המלא ואת חוזה התוצאה אפשר למצוא במדריך תהליך העבודה עם MCP. הוספת מחבר או הדבקת פרומפט בלבד לא מאשרות גישה לחשבון Instagram.
חיבור Mellow Hub ב-Claude, קודם עם גישת קריאה בלבד
בחשבון Claude שבו זמינים מחברים מותאמים אישית, יש לפתוח את Customize → Connectors → Add custom connector. להזין את השם Mellow Hub ואת כתובת שרת ה-MCP המרוחק https://www.mellow.world/mcp. אם כבר הוספת אותו, אפשר להשתמש במחבר הקיים. Claude יכול לאתר את הגדרות ההזדהות מהכתובת הזו.
| הגדרת חיבור | ערך |
|---|---|
| פרוטוקול תעבורה | Streamable HTTP |
| הזדהות | נדרשת תמיד |
| לקוח OAuth | נרשם אוטומטית באמצעות DCR; אין סוד לקוח (client secret) שצריך להעתיק. |
- לפתוח את המחבר ולבחור Connect. להתחבר ל-Mellow, אם נדרש. מסך ההסכמה אמור להציג את Claude כאפליקציה שמבקשת את הגישה.
- לבדיקה ראשונה, להשאיר מסומנות רק את
channels:readואתposts:read. הן מאפשרות לקרוא את החיבור ולאמת קלט. הן לא מאפשרות להעלות מדיה, ליצור פוסטים או לפרסם. - לבחור את ערוץ ה-Instagram הספציפי שלך ואת מצב האישור. להגדיר תוקף קצר, למשל יום אחד, ותקרה יומית. בחירת ערוצים ריקה נדחית; גישה לערוצים עתידיים דורשת בחירה מפורשת.
- לעבור על ההאצלה הזו ולאשר אותה בעצמך. אחרי החזרה ל-Claude, לוודא שהמחבר מחובר. לבקש מ-Claude לקרוא ל-
whoamiואז ל-list_channelsכדי לקבל את מזהה הערוץ המורשה. את ההרשאות, הערוצים והתוקף שהוענקו כדאי לבדוק ברשימת הגישות של Hub: לקוח עשוי להציג רק את הסיכום הטקסטואלי שהכלי מחזיר, והוא לא כולל את כל השדות המובנים.
השתמש רק ב-Mellow Hub. קרא ל-whoami ואז ל-list_channels.
השתמש בערוץ ה-Instagram היחיד שאישרתי. קרא ל-validate_post פעמיים עם
הכיתוב "Mellow test - example only": קודם עם media [] ואחר כך עם
media ["https://example.com/test.jpg"]. אלה קלטים להמחשה בלבד.
אל תיגש ל-URL ואל תקרא פוסטים קיימים. דווח על כל תוצאת אימות.
אל תיצור, אל תתזמן, אל תבטל ואל תפרסם שום דבר.כש-Claude מבקש להשתמש בכלי, כדאי לבדוק את שם הכלי ואת הקלט לפני שמאשרים את הקריאה. בבדיקה הזו יש לאשר כל קריאה פעם אחת. ה-URL לדוגמה נועד לבדוק רק את כללי הקלט; זו לא תמונה אמיתית לפרסום. האימות לא מוריד את המדיה ולא מוכיח שהפוסט יגיע ל-Instagram.
מה החזירה בדיקת החיבור בפועל
ב-9 בספטמבר 2026, חיבור אמיתי אחד מ-Claude בדפדפן השלים את תהליך ה-OAuth עם channels:read posts:read בלבד, ערוץ Instagram אחד, מצב אישור ותוקף של יום אחד. Claude קרא ל-whoami, ל-list_channels ופעמיים ל-validate_post. בדקנו את תגובות הכלים עצמן, ולא רק את הסיכום של העוזר.
| קלט | התוצאה שנצפתה |
|---|---|
| כיתוב בלי מדיה | נדחה: Instagram דורשת לפחות פריט מדיה אחד. |
| אותו כיתוב עם ה-URL של התמונה לדוגמה | עבר את בדיקת הקלט עבור ערוץ אחד. |
בבדיקה הזו לא נוצר ולא פורסם אף פוסט. לאחר מכן ביטלנו את הרשאת הבדיקה בדף סוכנים ווידאנו שגם טוקן הגישה וגם טוקן הרענון שלה בוטלו. זה מוכיח את תהליך החיבור והאימות הספציפי הזה, לא פרסום ב-Instagram ולא תאימות לכל תצורת לקוח.
לטיוטה שלך צריך כיתוב אמיתי ומדיה נגישה. אם משימה מאוחרת יותר דורשת הרשאות כתיבה, יש לאשר האצלה חדשה עם ההרשאות הנדרשות. רענון טוקן לא מאריך את תוקף הגישה שנבחר עבורו.
בחירת הפורמט לפני האימות
כרגע Hub אוכף ב-Instagram מגבלת כיתוב של 2,200 תווים וטווח כולל של 1–10 פריטי מדיה. כל מיקום מצמצם את הטווח הזה. אלה כללי הקלט ש-Hub אוכף; הם עשויים להיות שמרניים יותר מהעורך של Instagram עצמה.
| פוסט | מיקום ב-Hub | הקלט שצריך להכין |
|---|---|---|
| תמונה בפיד | timeline | תמונה אחת. |
| קרוסלת תמונות | timeline | בין שתיים ל-10 תמונות, בסדר הרצוי. |
| Reel | reels | סרטון אחד בדיוק. shareToFeed קובע אם לשתף אותו גם בפיד הראשי. |
| Story | stories | תמונה אחת או סרטון אחד בדיוק, בכפוף לזכאות החשבון. |
כרגע Hub דוחה שילוב של כתובות URL מזוהות של תמונות ושל סרטונים באותו פוסט. בקלט של הקרוסלה יש להשתמש בסוג מדיה אחד. זו מגבלה של Hub, לא טענה ש-Instagram עצמה אף פעם לא תומכת בקרוסלות מעורבות.
ההתנהגות של כל מיקום מתועדת אצל Post for Me. גודל הקובץ, הקודקים, יחס הרוחב-גובה ומשך הסרטון עדיין צריכים לעמוד בדרישות של Instagram. בודק הקלט של Hub לא מוריד את הקובץ ולא מודד אותו, ו-URL בלי סיומת מוכרת עלול להשאיר את סוג המדיה לא ידוע.
שלושה קלטי פוסט שאפשר להתאים
יש להעביר אחד מהאובייקטים האלה כארגומנטים ל-validate_post. את מזהה הערוץ לדוגמה, כתובות ה-URL של המדיה, הכיתוב וחותמת הזמן של 2030 יש להחליף בערכים משלך. התאריך נבחר בכוונה להמחשה בלבד; יש לציין במפורש Z של UTC או היסט של אזור זמן. הקלטים האלה נבדקו מול מנגנוני הניתוח והאימות של Hub, עם ערוץ סינתטי. הם לא אישורי פרסום אמיתיים מ-Instagram.
One feed photo
{
"channels": [
"spc_your_instagram_channel"
],
"scheduledAt": "2030-01-15T10:00:00Z",
"caption": "A closer look at the glaze on this cup.",
"media": [
"https://cdn.example.com/your-cup.jpg"
],
"options": {
"instagram": {
"placement": "timeline"
}
}
}An ordered photo carousel
{
"channels": [
"spc_your_instagram_channel"
],
"scheduledAt": "2030-01-15T10:00:00Z",
"caption": "From clay to finished cup, in three stages.",
"media": [
"https://cdn.example.com/your-clay.jpg",
"https://cdn.example.com/your-process.jpg",
"https://cdn.example.com/your-cup.jpg"
],
"options": {
"instagram": {
"placement": "timeline"
}
}
}One Reel
{
"channels": [
"spc_your_instagram_channel"
],
"scheduledAt": "2030-01-15T10:00:00Z",
"caption": "How this handle is attached.",
"media": [
"https://cdn.example.com/your-process.mp4"
],
"options": {
"instagram": {
"placement": "reels",
"shareToFeed": true
}
}
}URL אמיתי של מדיה חייב להיות נגיש לשירות הפרסום בזמן שהשירות מוריד אותו. Meta מתארת את הדרישה הזו בתיעוד פרסום התוכן שלה. נתיב מקומי, קישור לכונן פרטי או URL חתום שפג תוקפו לא יכולים לשמש תחליף.
תיקון הבעיה שדווחה לפני יצירת הפוסט
יש לקרוא את ok, issues ו-notes בתוצאת האימות. גם בקשת HTTP שהצליחה יכולה להחזיר ok: false. הבעיה מציינת את הערוץ ואת השדה שהושפעו.
| קוד הבעיה | מה לשנות |
|---|---|
channel_not_connected | להשלים את חיבור החשבון ולהשתמש במזהה הערוץ שהוחזר עבורו. |
media_required | לצרף מדיה; בתהליך הזה Instagram לא יכולה לפרסם פוסט של טקסט בלבד. |
media_too_many | לצמצם את מספר הפריטים למקסימום הנוכחי של Hub, 10; ב-Reel או ב-Story מותרים פחות פריטים. |
reel_media_count | להשתמש בסרטון אחד לכל Reel. כדי ליצור כמה Reels, יש להכין פוסטים נפרדים. |
reel_needs_video | לספק סרטון ל-Reel, או לבחור במיקום הפיד עבור תמונות. |
story_media_count | להשתמש בפריט אחד לכל בקשת Story. |
media_kinds_mixed | לשים תמונות וסרטונים מזוהים בפוסטים נפרדים ב-Hub. |
caption_too_long | לקצר את הכיתוב ל-2,200 תווים לכל היותר. |
אפשר לנסות את בודק הפוסטים החינמי עוד לפני חיבור חשבון. הוא משתמש באותם כללי קלט עם יעדים לדוגמה. אימות בחשבון מחובר בודק את הערוצים המחוברים בפועל; אף אחת מהבדיקות לא מבטיחה שהפרסום דרך הספק יצליח בסופו של דבר.
תזמון פעם אחת ובדיקת התוצאה ב-Instagram
אחרי בדיקה תקינה, יש לקרוא ל-create_post עם אותו פוסט מתוכנן ועם idempotencyKey קבוע, למשל ceramics-instagram-reel-slot-001. היצירה היא השלב שמכין או מתזמן את הפרסום בפועל. במצב אישור הוא ממתין לאישור; בטייס אוטומטי הוא יכול להתבצע בזמן שנבחר. לפני כן כדאי לבדוק את מכסת התוכנית הנוכחית.
יש לשמור את מזהה הפוסט שהוחזר. אם התגובה לבקשת היצירה אבדה, יש לשלוח שוב את אותה בקשה עם אותו מפתח. אין ליצור מפתח חדש רק מפני שזמן ההמתנה פג. פוסט ששונה צריך מפתח חדש.
יש לקרוא ל-get_post ולעיין ברשומה של Instagram ב-targets: לבדוק את הסטטוס הסופי, את ה-URL הציבורי או את השגיאה. העובדה ש-Hub קיבל את הפוסט אינה הוכחה ש-Instagram פרסמה אותו. בבקשה שמיועדת לכמה רשתות, יעד אחר יכול להצליח בזמן ש-Instagram נכשלת.
לאינטגרציות שרת שעובדות ישירות עם HTTP, המתכון לתזמון דרך REST מציג את הבקשות המקבילות ואת כותרת האידמפוטנטיות. בהגדרה ראשונה, כדאי לחבר את ערוץ ה-Instagram שלך ולאמת טיוטה אחת לפני הגדרת תזמון חוזר.