iCount MCP

הבעיה

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

מה זה עושה

icount-mcp הוא שרת MCP (Model Context Protocol) שחושף את ה-API של iCount ככלים שכל לקוח MCP — Claude Code, Claude Desktop, Cursor, Windsurf, n8n ואחרים — יכול לקרוא להם ישירות מתוך שיחה. 14 כלים בשני אזורים:

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

השרת רץ מקומית על stdio — הוא לא מתארח בשום מקום, ואין תהליך OAuth. ההזדהות מול iCount היא טוקן API אחד שיושב אצל המשתמש בלבד.

איך זה מותקן

התקנה היא שורה אחת בקונפיג של לקוח ה-MCP: npx -y icount-mcp עם משתנה הסביבה ICOUNT_API_TOKEN. ב-Claude Code זו פקודה אחת — claude mcp add icount --env ICOUNT_API_TOKEN=... -- npx -y icount-mcp. אין build, אין דמון שרץ ברקע, ואין שלב "רישום אפליקציה" מול iCount מלבד יצירת הטוקן עצמו.

הרשאות ושערי אישור

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

פשרות

אין ניהול מצב או cache בצד השרת — כל קריאה היא round trip ישיר ל-iCount. פשוט לתחזק, אבל אומר שסוכן שמריץ כמה שאילתות ברצף מרגיש את זה בזמן תגובה. וזו לא אינטגרציה רשמית של iCount — פרויקט קהילתי, ומתועד ככזה במפורש.

מה עוד חסר

אין עדיין תמיכה בדוחות (מאזן, רווח והפסד) ואין webhook לעדכונים בזמן אמת — כל אינטראקציה יזומה מצד הסוכן, לא push מ-iCount.