ה־API הציבורי

חיבור עוזר AI‏ (MCP)

צרו מפתח API עם ההרשאות שהעוזר צריך בלבד, ותנו ללקוח את הכתובת https://api.mosaqo.app/v1/mcp עם המפתח הזה כאסימון bearer. העוזר יכול בדיוק את מה שהמפתח מתיר ולא יותר, ואפשר לנתק אותו בכל רגע תחת Bulk & API.

נבדק 20 באוגוסט 2026

צעדים

1. פתחו Bulk & API → API keys וצרו מפתח. תחילה תנו הרשאות קריאה בלבד; מפתח שני עם כתיבה תנפיקו כשתראו מה העוזר עושה.
2. העתיקו את הכתובת מהאזור AI assistants (MCP) באותו מסך.
3. בעוזר הוסיפו שרת עם הכתובת הזו ושלחו את המפתח בכותרת Authorization: Bearer. רוב הלקוחות מקבלים בלוק JSON עם url ו-headers.
4. חלק מהמחברים מבקשים שתתחברו ל-Mosaqo במקום להדביק מפתח. המסלול הזה מראה מי מבקש, לאיזה מרחב עבודה זה נוגע ומה הוא יוכל לעשות, לפני שניתן משהו — ורק בעלים או מנהל יכולים לאשר.
5. שאלו את העוזר מה הוא יכול. הוא יפרט את הכלים שהמפתח שלכם מתיר — האישור המהיר ביותר לכך שהחיבור צר כפי שהתכוונתם.

איך לבדוק את התוצאה

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

מה בדרך כלל משתבש

• לתת כתיבה כבר במפתח הראשון. התחילו בקריאה בלבד והרחיבו כשתדעו מה נעשה בו.
• לצפות שיקרא את מה שאנשים כתבו בסקר. התשובות האלה אינן נמסרות למפתח ולא לעוזר — ציונים וספירות כן, המשפטים נשארים בתיבה.
• לצפות שימחק קוד. הוא לא יכול: הריסת ההפניה שמאחורי קוד מודפס אינה הפיכה, ולכן מוצעת לו ארכוב, שהוא כן הפיך.
• לשכוח חיבור. עוזר שחובר דרך התחברות שומר גישה עד שמנתקים אותו תחת Bulk & API, בדיוק כמו מפתח שתקף עד לביטולו.