דלג לתוכן הראשי

​
חיבור עוזר

SORANK כבר מארחת את שרת ה-MCP המרוחק בכתובת https://app.sorank.com/mcp. אין צורך ליצור נקודת קצה של MCP או להפעיל שרת מקומי.
  1. בעוזר התומך ב-MCP מרוחק דרך Streamable HTTP וב-OAuth authorization code עם PKCE S256, פתחו את הגדרות MCP או המחברים.
  2. הוסיפו שרת מרוחק עם הכתובת https://app.sorank.com/mcp. בחרו OAuth או אימות אוטומטי. האתר, /api/public/v1 ו-localhost אינם כתובת שרת ה-MCP.
  3. לחצו על חיבור או אישור. הלקוח מגלה את הגדרות OAuth, נרשם לפי הצורך ופותח את מסך ההתחברות של SORANK. בדקו את ההרשאות והאתרים המבוקשים לפני האישור.
  4. חזרו לעוזר, רעננו את הכלים וקראו ל-list_profiles. רק האתרים שאושרו אמורים להופיע. לאחר מכן קראו ל-get_capabilities ועם quotas:read גם ל-get_quotas.
אם הלקוח דורש JSON, הזינו את הכתובת הזאת בשדה כתובת URL מרוחקת ובחרו OAuth. שמות השדות משתנים בין לקוחות; לשרת המתארח אין צורך בפקודת npx מקומית.

​
חלופה: מפתח אישי

אם הלקוח תומך בכותרת Authorization מותאמת ל-MCP מרוחק, צרו מפתח ב-https://app.sorank.com/settings/api עם האתרים וההרשאות הנדרשים. הגדירו Authorization: Bearer <full-key> באחסון הסודי של הלקוח, לעולם לא בהנחיה לעוזר. המפתח המלא מוצג פעם אחת בלבד. OAuth עדיף ללקוחות אינטראקטיביים.

​
הגדרת OAuth

מטא-נתוני משאב ה-MCP נמצאים ב-https://app.sorank.com/.well-known/oauth-protected-resource/mcp, ומטא-נתוני שרת ההרשאה ב-https://app.sorank.com/.well-known/oauth-authorization-server. לקוחות תואמים מגלים אותם אוטומטית. מפתחי לקוחות משתמשים בנקודות הקצה המפורסמות, ב-PKCE S256 ובמשאב המדויק https://app.sorank.com/mcp.

​
בדיקת זכאות

אפשר לחבר עוזר לאחר שהשלמתם את תהליך ההצטרפות ב-Sorank ולפחות לאתר אחד יש מנוי בתוקף. אחרת, מסך ההסכמה מסביר מה חסר, מקשר לתהליך ההצטרפות או ל-הגדרות → חיוב, והאפשרות אישור גישה אינה זמינה. השלימו את השלב והתחילו את החיבור מחדש מהעוזר. אפשר לבחור רק אתרים זכאים, ו-list_profiles מחזירה רק אתרים זכאים. אם אתר מאבד את המנוי מאוחר יותר, הכלים שלו מחזירים subscription_required, גם בסשן שכבר פתוח.

​
בחירת כלים והרשאות

בקשו מהלקוח להציג את רשימת הכלים לאחר החיבור. השרת מציג רק את הכלים שההרשאה שלכם מתירה ובודק אותה שוב בכל קריאה. אי אפשר להפעיל ישירות כלי מוסתר.
  • אתרים ומכסות: list_profiles, get_capabilities, get_quotas.
  • הצגת מוצרים: list_products.
  • הצגת ניתוחים: get_gsc_performance, list_gsc_queries, list_gsc_pages, get_gsc_countries_devices, get_ai_traffic_timeline, list_ai_traffic_pages.
  • הצגת נראות AI: get_geo_stats, get_geo_mentions_evolution, get_geo_citations_timeline, list_geo_citing_sources, get_geo_cited_competitors.
  • הצגת הגדרות: get_settings. עריכת הגדרות: update_site_settings, replace_business_brief, replace_competitors, update_article_settings, update_visual_settings, connect_youtube_channel, set_youtube_channel_enabled, disconnect_youtube_channel.
  • תוכן: create_calendar, generate_articles, publish_article, get_operation ושאר כלי המאמרים ולוח השנה.

​
תהליך עבודה בטוח

התחילו עם list_profiles, get_capabilities ו-get_quotas. צרו לוח שנה או מאמרים אחרי בדיקת המכסה. כל שינוי דורש UUID בשדה idempotency_key. שמרו את מזהה הפעולה ובדקו את get_operation עד לסיום. פעולה שהתקבלה עלולה להיכשל בהמשך; בדקו את התוצאה או השגיאה. קראו מאמר לפני עריכה או פרסום.

​
השפעות וביטול גישה

יצירת לוח שנה יכולה לתזמן יצירה ופרסום מאוחרים יותר. generate_articles משתמש במכסת המאמרים של החשבון; הקבלה שלו במצב succeeded ברגע שהאצווה מתקבלת, ואתם עוקבים אחר כל מאמר שהתקבל באמצעות get_article. publish_article יכול לשלוח תוכן ל-CMS, בהתאם ליכולותיו וליעד שבחרתם. כלי ההגדרות משנים את אותן הגדרות כמו האפליקציה ומחזירים רשימת effects של התהליכים שהופעלו ברקע, למשל יצירה מחדש של שאלות GEO או סנכרון YouTube. לא ניתן לשנות את כתובת האתר. אותם תוכנית, הרשאות ומכסה חלים באפליקציה וב-REST. ביטול החיבור או אובדן הגישה לאתר חוסמים קריאות וקריאת פעולות בהמשך.

​
טיפול בשגיאות כלים

קריאה שנכשלה מחזירה שגיאת כלי עם אותם code, message, request_id, retryable ו-details כמו ה-API של REST, למשל onboarding_required, subscription_required, missing_scope, not_found, gsc_not_connected או business_brief_revision_conflict. נסו שוב רק כאשר retryable הוא true.

​
בדיקת תאימות

גרסה זו תומכת ב-Streamable HTTP ובתהליך OAuth שנבדקו, עם רישום לקוח דינמי מוגבל. לקוחות שדורשים CIMD בלבד אינם נתמכים. בדקו את יכולות הלקוח לפני החיבור. טקסט מאמרים שמוחזר הוא תוכן משתמש, ולא הוראה מהימנה.

​
אם החיבור נכשל

  • פתיחת /mcp בדפדפן אינה בדיקת חיבור. הזינו את הכתובת בלקוח MCP ובחרו Streamable HTTP.
  • אם מסך ההתחברות אינו נפתח, בדקו תמיכה בגילוי OAuth, ב-authorization code עם PKCE S256 וברישום דינמי. מפתח אישי אפשרי אם הלקוח מקבל כותרת Authorization.
  • אם חסרים אתרים או כלים, בדקו את האתרים וההרשאות שאושרו. list_profiles דורש profiles:read; get_quotas דורש quotas:read.
  • אם חיבור קיים הפסיק לעבוד, בדקו ביטול הרשאה וגישה לאתרים ב-הגדרות → גישה ל-API והתחברו מחדש.
  • אם מסך ההסכמה אינו מאפשר אישור, השלימו את תהליך ההצטרפות או עדכנו את המנוי כמצוין, ואז התחברו מחדש מהעוזר.