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

# MCP

> מדריך לחיבור agent התואם ל-MCP ל-Flowglad, כולל מציאת כתובת ה-URL של הארגון, חיבור מ-Claude Desktop או מלקוח MCP אחר, החלת תבנית ופתרון בעיות.

חברו agent התואם ל-MCP ל-Flowglad כדי לעבוד עם הידע העסקי וההקשר התפעולי של הארגון שלכם.

המחבר יכול למצוא ולערוך Pages, לקרוא קבצים ורשומות מחוברות, ליצור Tasks, לנהל Skills לשימוש חוזר, וליצור או להריץ Automations. הכלים הזמינים תלויים בזהות המחוברת, בהרשאות שהוענקו וביכולות המוצר המופעלות.

## החלת תבנית

כאשר `templates.apply` זמין ב-`tools/list`, ספקו `templateId` שפורסם ו-`spaceId` קיים כדי ליצור את כל המשאבים של התבנית. אפליקציות, Automations ועותקים של קבצים רגילים שייכים ל-Space הזה; Skills שייכים לארגון. הקבצים משתמשים בשמות הקבצים שהוגדרו להם בתיקיית השורש של ה-Space ולעולם אינם דורסים קבצים קיימים. התנגשות שמות גורמת לכישלון של הרכיב הזה, בעוד שרכיבים בלתי תלויים יכולים להמשיך. השלמת קובץ פירושה שהבייטים והמטא-נתונים נשמרו באופן עמיד; היא אינה ממתינה לאינדוקס.

באופן אופציונלי, ספקו את `connections` כמערך של אובייקטים מסוג `{ connector, connectionId }`, עם חיבור אחד לכל היותר לכל ספק. חיבורים שסופקו חייבים להיות נגישים, תואמים, ומשויכים כבר ל-Space כשהדבר נדרש. כאשר חיבורים מושמטים, המשאבים נשארים בהמתנה להגדרה. התגובה ממליצה על חיבורים מתאימים, או על יצירת חיבור כאשר אין חיבורים זמינים.

היצירה מתבצעת במשימת Trigger.dev אחת לפי סדר התלויות, והתוצאות של כל רכיב נרשמות במטא-נתונים ובפלט של המשימה. ניסיונות חוזרים אוטומטיים של המשימה כולה מושבתים; משימה שנכשלה או נקטעה עלולה להשאיר משאבים חלקיים. התגובה מאשרת שהיצירה נכנסה לתור וכוללת את הרכיבים המתוכננים ואת המלצות החיבור; היא אינה מאשרת שיצירת המשאבים הסתיימה. השתמשו בכלי list/get של המשאבים כדי למצוא ולבדוק אותם. משאבים שנוצרו בהצלחה נשארים גם אם רכיב אחר נכשל.

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

## לפני החיבור

אתם צריכים:

* חשבון Flowglad עם גישה לארגון שבו תרצו להשתמש.
* כתובת ה-MCP URL של סביבת הייצור של הארגון שלכם.
* agent או לקוח שתומך בשרת MCP מרוחק על גבי Streamable HTTP ו-OAuth.
* הרשאות הארגון וה-Space הנדרשות לעבודה שאתם מתכננים.
* כל Connection מקור או קובץ שכבר זמינים ב-Space הרלוונטי.

מדור התמחור המפורסם ב[דף הבית של Flowglad](https://www.flowglad.com/) כולל MCP בתוכניות Free, Plus ו-Max. הרשאות הארגון וה-Space, הענקת ה-OAuth והגישה למקורות המחוברים עדיין חלות.

יש להגדיר ב-Flowglad חיבורים למערכות עסקיות חיצוניות ולחשוף אותם ל-Space המיועד לפני שה-agent יוכל להשתמש בהם. ראו [Connectors](/docs/he/connectors.md) ו-[Spaces](/docs/he/spaces.md).

## מציאת כתובת ה-URL של הארגון

המחבר בסביבת הייצור משתמש בכתובת URL ייעודית לארגון:

```text theme={null}
https://dashboard.flowglad.com/api/mcp/orgs/{orgId}
```

החליפו את `{orgId}` במזהה הארגון האמיתי שלכם ב-Flowglad. שמרו על המזהה המלא, כולל הקידומת `org_`. אל תזינו את הסוגריים המסולסלים או מזהה ארגון מומצא.

ב-Flowglad, פתחו את **Settings** ← **MCP** ← **Add MCP Connection** ← **Claude** ← **Website**. העתיקו את כתובת ה-MCP URL של הארגון המוצגת שם. השתמשו בהוראות של **Website** עבור URL מרוחק; הלשונית הנפרדת **Desktop app** מכילה הוראות הגדרה דרך שורת הפקודה.

אם אין לכם גישה להגדרות אלה, פנו למנהל Flowglad שלכם או ל[תמיכה](mailto:support@flowglad.com).

השתמשו בכתובת ה-URL של הארגון עבור מחבר זה. כתובת URL ייעודית לחיבור עשויה לחשוף סט כלים מצומצם יותר ואינה ניתנת להחלפה עם כתובת ה-URL של הארגון המתוארת כאן.

## חיבור מ-Claude Desktop

צפו ב[סרטון ההגדרה של Claude Desktop](https://youtu.be/6qqSnrqDJ2o), או בצעו את השלבים שלהלן.

[כיצד לחבר את Flowglad ל-Claude Desktop](https://www.youtube.com/embed/6qqSnrqDJ2o)

השתמשו בתהליך המחבר המותאם אישית של Claude Desktop כדי להוסיף את Flowglad ולאשר גישה לחשבון שלכם.

**1. פתחו את טופס המחבר המותאם אישית.**

ב-Claude Desktop, נווטו אל **Customize** ← **Connectors** ← **+ Add** ← **Add Custom Connector**.

**2. הוסיפו את מחבר Flowglad.**

הזינו **Flowglad** כשם המחבר, או בחרו שם אחר.

הדביקו את כתובת ה-MCP URL המלאה של הארגון שלכם בשדה ה-URL. ניתן להעתיק אותה מ-[Settings > MCP](https://dashboard.flowglad.com/settings/mcp). היא אמורה להיראות כך: `https://dashboard.flowglad.com/api/mcp/orgs/org_...`

אל תשנו הגדרות מחבר אחרות. בחרו **Add** כדי להמשיך. בגרסאות מסוימות Claude Desktop עשוי לתייג כפתור זה **Continue**.

**3. הענקת גישה ל-Claude ל-Flowglad.**

המשיכו בתהליך החיבור כדי לאשר ל-Claude לגשת לחשבון Flowglad שלכם. כשתתבקשו, התחברו, אשרו את ארגון Flowglad המיועד וסקרו את הגישה המבוקשת לפני שתאשרו אותה.

כשהתהליך מסתיים, חזרו ל-Claude Desktop וודאו שחיבור Flowglad זמין. בקשו מ-Claude לבדוק את חיבור Flowglad ולהציג את ה-Spaces שיש לכם גישה אליהם.

OAuth Dynamic Client Registration היא שיטת החיבור המיועדת. אל תוסיפו סיסמה, access token, מפתח API או client secret לכתובת ה-URL של השרת.

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

## חיבור לקוח MCP אחר

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

התמיכה משתנה בין לקוחות. חיבור מוצלח לשרת אינו אומר שהלקוח מייבא את Skills של Flowglad באופן אוטומטי. הרחבת גילוי ה-Skills והכלי `skills.list` הם ממשקים שונים. ראו [Skills](/docs/he/skills.md) להתנהגות הנתמכת של גילוי וניהול חבילות.

## טיפול בנתונים

השימוש ב-MCP של Flowglad כפוף ל[מדיניות הפרטיות של Flowglad](https://www.flowglad.com/privacy-policy). מנהלי ארגון יכולים לראות את כל קריאות כלי ה-MCP שבוצעו לארגון שלהם ב-[Settings > Audit](https://dashboard.flowglad.com/settings/audit).

## פתרון בעיות

| תסמין | השלב הבא |
| - | - |
| החיבור נכשל לפני ההתחברות | בדקו את כתובת ה-HTTPS המלאה ואת מזהה הארגון. ודאו שהלקוח תומך ב-MCP מרוחק עם OAuth. |
| ההתחברות מצליחה אך העבודה אינה זמינה | בדקו את הארגון שנבחר, את החברות ב-Space, את הענקת ה-MCP ואת ה-Connections הזמינים ב-Space. |
| כלי כתיבה אינו זמין או נדחה | ודאו את הרשאות הארגון וה-Space הנדרשות. התחברו מחדש אם נדרש OAuth scope שהוענק לאחרונה. |
| לא ניתן לקרוא ספק מחובר | ודאו שההרשאה שלו פעילה ושה-Connection חשוף ל-Space המיועד. |
| לא ניתן למצוא Page או קובץ | ודאו את ה-Space הנכון, את הגישה הישירה והמקושרת שלו, ושהמקור עדיין זמין. |
| פעולה מחזירה מזהה job או run | בדקו את סטטוס מחזור החיים או ההרצה הסופי שלה לפני שתדווחו על הצלחה או תנסו שוב. |
| כתיבה חורגת מזמן | בדקו אם היא הושלמה לפני ניסיון חוזר. פעולות מסוימות יוצרות רשומה חדשה או מכניסות עבודה לתור בכל קריאה. |
| הגישה פגה או בוטלה | התחברו מחדש דרך OAuth וודאו את הארגון וההענקה המיועדים. אם החיבור מחדש עדיין נכשל, פנו לתמיכה. |

למידע כללי על אבטחה, ראו [Security](/docs/he/security.md) ואת [Trust Center](https://trust.flowglad.com) שלנו. אם אתם נתקלים בבעיה כלשהי בחיבור, [צרו איתנו קשר](mailto:support@flowglad.com).

כשאתם פונים לתמיכה, ציינו את השעה, הלקוח, הכלי המושפע, קוד השגיאה הבטוח ומזהה הבקשה אם זמין. לעולם אל תכללו סיסמאות, bearer tokens, cookies, כתובות URL חתומות להעלאה/הורדה או נתוני לקוחות.


## Related topics

- [Skills](/docs/he/skills.md)
- [ברוכים הבאים](/docs/he/agents/introduction.md)
- [Automations](/docs/he/automations.md)


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