> ## Documentation Index
> Fetch the complete documentation index at: https://sorank.com/llms.txt
> Use this file to discover all available pages before exploring further.

# חיבור עוזר באמצעות MCP

> הגדרת OAuth לשרת MCP של SORANK ושימוש בכלים הציבוריים.

## חיבור עוזר

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** והתחברו מחדש.
* אם מסך ההסכמה אינו מאפשר אישור, השלימו את תהליך ההצטרפות או עדכנו את המנוי כמצוין, ואז התחברו מחדש מהעוזר.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.