חבר את FREEPAY ל-Claude / ChatGPT בלחיצה - בצורה בטוחה

אפשר לחבר את FREEPAY לעוזר AI (למשל Claude או Cursor) ולשאול אותו בשפה חופשית: "מי עוד לא שילם לי?", "כמה הכנסתי בספטמבר?", "אילו הוצאות מחכות לאישור?". החיבור נעשה בתקן פתוח שנקרא MCP, ועובד עם אותם מפתחות API של המערכת.

הדרך הקלה: חיבור בלחיצה (בלי מפתח)

Claude ו-ChatGPT יודעים להתחבר ל-FREEPAY ישירות: מוסיפים את הכתובת, מתחברים ל-FREEPAY ומאשרים מה מותר.

Claude (באתר claude.ai או באפליקציה):

1. Customize ← Connectors ← Add custom connector.
2. בשדה הכתובת מדביקים: https://<הכתובת-שלכם>/mcp (הכתובת המדויקת מופיעה בהגדרות ← API ← אפליקציות מחוברות). שדות ה-OAuth נשארים ריקים.
3. Add ואז Connect. נפתח מסך של FREEPAY - מתחברים (כולל הקוד מהטלפון אם הפעלתם אימות דו-שלבי).
4. במסך האישור רואים איזו אפליקציה מבקשת, לאן יישלח האישור (למשל claude.ai, עם תג "מאומת"), ואילו הרשאות לתת.

ChatGPT: הגדרות ← Apps & Connectors ← Advanced ← מפעילים Developer mode ← Create ← מדביקים את אותה כתובת ובוחרים OAuth. (שמות התפריטים ב-ChatGPT משתנים מדי פעם.)

GPT מותאם אישית (Actions): ב-Configure ← Actions ← Import from URL מדביקים https://<הכתובת-שלכם>/api/v1/openapi-gpt.json. לאימות אפשר מפתח API (Bearer), או OAuth עם הכפתור "צור לקוח OAuth ל-GPT" בהגדרות ← API ← אפליקציות מחוברות. מדיניות פרטיות: https://<הכתובת-שלכם>/legal/privacy.

מה לסמן במסך האישור

• קריאה מסומנת תמיד - זה ברירת המחדל, ומומלץ להתחיל רק איתה.
• אפשר להוסיף: הפקת מסמכים והצעות מחיר, תשלומים, הוצאות, הנהלת חשבונות. סמנו רק מה שבאמת צריך.
• רואה חשבון מחבר רק לקריאה, ובוחר לאיזה לקוח.
• ראיתם "לא מאומת"? אשרו רק אם אתם התחלתם עכשיו את החיבור ואתם מכירים את האפליקציה.

ניתוק

הגדרות ← API ← אפליקציות מחוברות ← ניתוק. החיבור נעצר מיד. על כל חיבור חדש תקבלו התראה (ובמייל) - אם זה לא אתם, נתקו מיד והחליפו סיסמה.

דרך נוספת: מפתח API (לתוכנות שלא תומכות בחיבור בלחיצה)

הכלל הראשון: מתחילים במפתח לקריאה בלבד.

1. הגדרות ← API ← יצירת מפתח.
2. בוחרים קריאה בלבד. עם מפתח כזה העוזר לא יכול להפיק, לבטל או לשלוח שום דבר - הוא רק קורא ומסכם.
3. מעתיקים את המפתח (מוצג פעם אחת) ושומרים אותו במקום בטוח.

אחרי שהתרגלתם, אפשר ליצור מפתח נפרד עם הרשאות כתיבה מצומצמות (למשל רק documents:write להפקת מסמכים).

איך מחברים

• Claude Code / Cursor: מוסיפים שרת MCP בכתובת https://<הכתובת-שלכם>/mcp עם הכותרת Authorization: Bearer <המפתח>.
• Claude Desktop: מורידים את החבילה freepay-mcp מתיעוד המפתחים ומוסיפים אותה לקובץ ההגדרות של האפליקציה, עם המפתח וכתובת השרת.
• דוגמאות מוכנות להעתקה לכל תוכנה נמצאות בתיעוד המפתחים.

מה העוזר יכול לעשות

• לקרוא: סקירת העסק, לקוחות ויתרות, מסמכים, חשבוניות פתוחות ודוח חייבים, הצעות מחיר, תשלומים וקישורי תשלום, הוצאות, רווח והפסד, מאזן בוחן, מנויים, שער יציג ומע"מ.
• להכין (עם מפתח כתיבה): קבלה או חשבונית, הצעת מחיר, קישור תשלום, מנוי, קליטת הוצאה מקובץ, אישור הוצאה, ביטול מסמך.

פעולות כספיות תמיד עם אישור שלכם

הפקת מסמך, ביטול, קישור תשלום, מנוי ואישור הוצאה הן פעולות שלא מבטלים בקלות. לכן:

1. בפעם הראשונה העוזר מקבל תצוגה מקדימה בלבד - מה יופק, לאיזה לקוח, הסכום המשוער והמספר הבא. שום דבר לא מתבצע.
2. הוא מציג לכם את התצוגה ושואל אם לבצע.
3. רק אחרי שאישרתם במפורש הוא שולח שוב עם confirm: true, ואז הפעולה מתבצעת.

בנוסף, רוב תוכנות ה-AI שואלות אתכם לפני כל הפעלה של כלי. אל תסמנו "אשר תמיד" לכלים שמפיקים או מבטלים מסמכים.

מעקב ושליטה

• כל פעולה של העוזר נרשמת בפעילות ← יומן קריאות API בערוץ "סוכן AI (MCP)", עם הבקשה והתשובה.
• חשבון מוקפא נשאר לקריאה בלבד גם לעוזר.
• רוצים לנתק? חיבור בלחיצה - הגדרות ← API ← אפליקציות מחוברות ← ניתוק; חיבור במפתח - מבטלים את המפתח בהגדרות ← API. בשני המקרים החיבור נעצר מיד.
• פעולות של חיבור בלחיצה מופיעות ביומן בשם האפליקציה, למשל "Claude (OAuth)".

טיפים לשאלות טובות

• "תעבור איתי על סגירת חודש ספטמבר" - העוזר יבדוק חשבוניות פתוחות, הוצאות לאישור ומע"מ.
• "תכין קבלה על ההעברה של דנה מאתמול, 350 ש"ח" - ותבדקו את התצוגה המקדימה לפני האישור.
• "מי הלקוחות שחייבים יותר מ-60 יום?"

שאלות נפוצות

העוזר רואה את כל הנתונים של העסק?

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

האם העוזר יכול להפיק חשבונית בלי שאדע?

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

חיבור בלחיצה בטוח יותר ממפתח?

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

איפה נשמר המפתח?

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