# סוכני AI ו-MCP

יש שתי דרכים לעבוד עם banta מתוך כלי AI:

1. **לתת לסוכן לקרוא את התיעוד** כדי שיכתוב בשבילכם קוד אינטגרציה מול ה-API. ראו "תיעוד לסוכני AI" בהמשך.
2. **לחבר את הסוכן ישירות לנתוני הארגון** דרך שרת ה-MCP של banta, כדי שיחפש, יסכם ויבצע פעולות בעצמו. ראו "חיבור דרך MCP".

## תיעוד לסוכני AI (גרסת LLM)

כל התיעוד מתפרסם גם כטקסט נקי שמודלי שפה קוראים בקלות. הקבצים מתעדכנים אוטומטית עם כל עדכון של ה-API. הגרסה העברית נמצאת תחת `/he/`, והאנגלית (ברירת המחדל) בשורש האתר. לסוכני קוד מומלצת האנגלית.

| עברית | אנגלית | תוכן |
|---|---|---|
| [`/he/llms.txt`](https://docs.banta.co.il/he/llms.txt) | [`/llms.txt`](https://docs.banta.co.il/llms.txt) | אינדקס לפי התקן [llmstxt.org](https://llmstxt.org): קישור לכל מדריך ולכל נקודת קצה |
| [`/he/llms-full.txt`](https://docs.banta.co.il/he/llms-full.txt) | [`/llms-full.txt`](https://docs.banta.co.il/llms-full.txt) | כל התיעוד בקובץ אחד: מדריכים ו-reference מלא |
| `/he/guides/<slug>.md` | `/guides/<slug>.md` | כל מדריך כקובץ Markdown, למשל [`/he/guides/authentication.md`](https://docs.banta.co.il/he/guides/authentication.md) |
| `/he/reference/<operationId>.md` | `/reference/<operationId>.md` | כל נקודת קצה כקובץ Markdown, למשל [`/he/reference/createLead.md`](https://docs.banta.co.il/he/reference/createLead.md) |
| [`/he/openapi.json`](https://docs.banta.co.il/he/openapi.json) | [`/openapi.json`](https://docs.banta.co.il/openapi.json) · [`/openapi.yaml`](https://docs.banta.co.il/openapi.yaml) | מסמך OpenAPI מלא, לייבוא ל-Postman, ל-Insomnia או למחוללי SDK |

**כפתורים באתר:**

- **שאלו AI** (בכותרת העליונה) - פותח את ChatGPT, את Claude או את Perplexity עם הוראה להתחיל מ-`llms.txt` (ו-`llms-full.txt` לתיעוד המלא).
- **העתקה כ-Markdown** (בכל נקודת קצה) - מעתיק את התיעוד של נקודת הקצה, מוכן להדבקה בצ'אט.

**לסוכני קוד (Claude Code, Cursor, Copilot)** - הוסיפו לפרומפט או לקובץ ההנחיות של הפרויקט:

```text
The banta API reference is at https://docs.banta.co.il/llms.txt (index) and
https://docs.banta.co.il/llms-full.txt (full). Read it before writing integration code.
Auth: header x-api-key. Base URL: https://app.banta.co.il/api-service
```

## חיבור דרך MCP

שרת ה-MCP של banta חושף לסוכני AI כלים לעבודה עם נתוני הארגון: חיפוש לידים ותיקים, סיכום תיק, יצירת משימות ותזכורות ועוד. כתובת השרת:

```text
https://db.banta.co.il/functions/v1/mcp-server
```

### אימות

- **OAuth (מומלץ)** - מדביקים את הכתובת בלקוח ה-MCP. הלקוח מפנה למסך התחברות ואישור של banta, ומשם הכול אוטומטי. כברירת מחדל רק מנהלי הארגון יכולים לאשר חיבור. אפשר לפתוח את האפשרות לכל המשתמשים, או לכבות חיבורים חיצוניים לגמרי, ב[הגדרות הארגון ← חיבורים וטכנולוגיה ← הגדרות בינה מלאכותית](https://app.banta.co.il/organization/settings?group=integrations&tab=ai).
- **טוקן גישה** - ללקוחות שתומכים בכותרות מותאמות. יוצרים טוקן (מתחיל ב-`bnt_mcp_`) באותו מסך הגדרות ושולחים אותו בכותרת `Authorization: Bearer <token>`. לקוחות ששומרים את הכותרת `Authorization` לעצמם יכולים לשלוח במקומה `X-MCP-Token: <token>`.

### חיבור לפי לקוח

- **Claude (claude.ai ואפליקציית Desktop)** - Settings ← Connectors ← Add custom connector, מדביקים את כתובת השרת ומאשרים במסך של banta.
- **Claude Code** - `claude mcp add --transport http banta https://db.banta.co.il/functions/v1/mcp-server`
- **Cursor / VS Code** - כפתור ההתקנה בכותרת העליונה של אתר התיעוד מוסיף את השרת בלחיצה.
- **לקוחות MCP אחרים** - כל לקוח שתומך בשרתי MCP מרוחקים ב-HTTP יכול להתחבר עם כתובת השרת שלמעלה: ב-OAuth אם הוא תומך בזה, ואחרת עם טוקן גישה. ב-ChatGPT זה תלוי בכך שהתוכנית שלכם מאפשרת חיבורים (connectors) מותאמים.

### מה הסוכן יכול לעשות

- הכלים הזמינים נקבעים במדיניות הארגון, ואפשר לצמצם אותם עוד יותר לכל טוקן.
- פעולות רגישות (כספים, שינויי סטטוס ומחיקות) עשויות לדרוש אישור של משתמש במערכת. במקרה כזה הסוכן יקבל `approval_required`, והפעולה תבוצע רק אחרי שהבקשה תאושר ב-banta.
- כל לקוח מחובר מוגבל ל-60 בקשות בדקה.
- כל קריאה של סוכן נרשמת ביומן הביקורת של הארגון.

---

חלק מתיעוד ה-API של banta. אינדקס מלא: https://docs.banta.co.il/he/llms.txt