המדריך הזה נכתב למפתחים ולבוני אפליקציות בוייב קודינג. הוא מסביר איך לחבר סליקה ישראלית מורשית לעוזר AI או לאפליקציה דרך שרת ה-MCP של איזיקארד, כולל הגדרות, אימות ותיעוד הכלים.
הבעיה: Stripe לא עובדת עם עסקים בישראל
Stripe היא ברירת המחדל של מפתחים ברחבי העולם, אבל היא לא מקבלת חברות עם רישום עסקי בישראל. בשלב ה-KYC המערכת חוסמת אתכם לפי המיקום, והמעקף הנפוץ הוא לפתוח חברה זרה, באסטוניה, בדלאוור או בבריטניה, עם חשבון בנק זר ועלויות חודשיות. מה שכן עובד בישראל הוא חברת סליקה מקומית מורשית שעומדת בתקן PCI DSS. הרחבנו על שלוש דרכי החיבור הקלאסיות במדריך וייב קודינג וסליקה. כאן נתמקד בדרך המהירה החדשה: שרת ה-MCP.
מה זה שרת ה-MCP של איזיקארד
MCP, ראשי תיבות של Model Context Protocol, הוא תקן פתוח שמאפשר לעוזרי AI להתחבר למערכות חיצוניות ולהפעיל בהן פעולות. שרת ה-MCP של איזיקארד עוטף את ה-API של הסליקה (EasyCard NG), כך שעוזר AI כמו Claude Desktop או ChatGPT Desktop יכול לבצע פעולות תשלום אמיתיות מתוך שיחה. השרת רב-דיירי (multi-tenant) וחסר מצב (stateless): הוא לא מאחסן פרטי גישה, ומעביר את הטוקן שלכם בכל בקשה בלי לשמור אותו.
דרישות מוקדמות
| דרישה | פירוט |
|---|---|
| חשבון סליקה | חשבון פעיל באיזיקארד (EasyCard NG) |
| טוקן API | מלוח הבקרה של החשבון, במסך הגדרות ה-API |
| מזהה מסוף | אופציונלי, רק אם החשבון שלכם עובד עם ניתוב לפי מסוף |
| תוכנת AI | Claude Desktop או ChatGPT Desktop, או כל תוכנה שתומכת ב-MCP |
| Node.js | גרסה 22 ומעלה, רק אם מריצים סביבה מקומית לבדיקות |
חיבור מהיר
פותחים את קובץ ההגדרות של תוכנת ה-AI ומוסיפים את הבלוק הבא. את כתובת השרת ואת הטוקן מקבלים מלוח הבקרה של החשבון שלכם או מצוות התמיכה:
// claude_desktop_config.json / mcp_config.json
{
"mcpServers": {
"ecng": {
"url": "https://YOUR-MCP-ENDPOINT/api/mcp",
"headers": {
"ecng_token": "YOUR_ECNG_TOKEN",
"terminal_id": "YOUR_TERMINAL_ID"
}
}
}
}
מחליפים את YOUR-MCP-ENDPOINT ואת YOUR_ECNG_TOKEN בערכים מלוח הבקרה, שומרים, סוגרים את התוכנה לגמרי ופותחים אותה מחדש. עכשיו שואלים בשיחה: אילו כלים של איזיקארד זמינים? ואתם אמורים לראות את כל תשעת הכלים.
שימו לב: השדה terminal_id אופציונלי. אפשר להוסיף גם redirect_url כדי להפנות את הלקוח לעמוד תודה אחרי התשלום.
אימות
הטוקן נשלח ככותרת HTTP בכל בקשה, מועבר משם ל-API של איזיקארד ואז נמחק. הוא אף פעם לא נחשף כפרמטר של כלי, ואינו נשמר בשרת:
ecng_token: <merchant ECNG token> terminal_id: <optional terminal ID> redirect_url: <optional post-payment URL>
תשעת הכלים
| כלי | מה הוא עושה | פרמטרים עיקריים |
|---|---|---|
ecng_create_customer |
יצירת לקוח חדש | name, email, phone ואופציונלית פרטי בנק וכתובת |
ecng_update_customer |
עדכון פרטי לקוח | customer_id והשדות לעדכון |
ecng_create_payment |
יצירת קישור תשלום או iframe | amount, customer_email ואופציונלית currency, num_payments, description |
ecng_create_card_token |
שמירת כרטיס כטוקן | card_number, exp_month, exp_year, cvv |
ecng_charge_card_token |
חיוב, זיכוי או ביטול של טוקן | token, amount, customer_id |
ecng_delete_card_token |
מחיקת טוקן שמור | token |
ecng_create_invoice_payment |
חיוב טוקן והפקת חשבונית מס | token, amount, customer_email, items |
ecng_get_invoice |
שליפת חשבונית לפי מזהה | invoice_id |
ecng_download_invoice |
קבלת קישור להורדת PDF | invoice_id |
דוגמאות שימוש
אחרי החיבור, מבקשים בשפה חופשית וה-AI בוחר את הכלי הנכון. הנה שלוש בקשות לדוגמה:
תשלום חד פעמי: שלחו בקשת תשלום ללקוח בכתובת customer@example.com על סך 299 ₪, בנושא חבילת פרימיום, בתוקף לשבוע.
חיוב חוזר למנויים:
- צרו לקוח בשם שרה כהן, במייל sarah@example.com.
- שמרו את הכרטיס שלה כטוקן.
- חייבו 49.90 ₪ מהטוקן כמנוי חודשי.
חשבונית עם שורות פירוט: חייבו 2,120 ₪ מהטוקן של david@example.com והפיקו חשבונית מס. פריטים: ייעוץ, 4 יחידות ב-500 ₪, ונסיעות, יחידה אחת ב-120 ₪.
MCP או קריאה ישירה ל-API: במה לבחור
שרת ה-MCP לא מחליף את ה-API, אלא מוסיף מעליו שכבה נוחה. כדאי להבין מתי כל אחד מתאים:
- MCP מתאים לתפעול שוטף בשיחה, לאב-טיפוס מהיר, לבדיקת תרחישים, ולמצבים שבהם אתם או צוות התפעול מנהלים תשלומים דרך עוזר AI. אין צורך לכתוב קוד לכל פעולה.
- קריאה ישירה ל-API מתאימה לזרימות פרודקשן אוטומטיות בתוך האפליקציה שלכם: תהליך תשלום באתר, webhooks וגבייה מתוזמנת. שם תרצו שליטה מלאה, טיפול בשגיאות ולוגים משלכם.
בפועל רוב העסקים משלבים בין השניים: בונים את זרימת התשלום המרכזית מול ה-API, ומשתמשים ב-MCP לתפעול, לתמיכה ולמשימות חד-פעמיות. חיבור בעמוד תשלום מארח או ב-API זמין גם דרך מערכת הסליקה של איזיקארד.
סביבת בדיקות מול פרודקשן
הסביבה נקבעת בצד השרת. טוקן של סביבת בדיקות (Sandbox) מאפשר לתרגל את כל התהליך בלי חיובים אמיתיים, וטוקן של פרודקשן מבצע חיובים אמיתיים. חשוב שהטוקן יתאים לסביבה, אחרת הבקשות ייכשלו.
| סביבה | חיובים אמיתיים? |
|---|---|
| Sandbox (בדיקות) | לא, לבדיקות בלבד |
| פרודקשן | כן |
אבטחה
- אל תשתפו את קובץ ההגדרות, שמכיל את הטוקן שלכם כטקסט גלוי.
- הטוקן מועבר בכל בקשה ואז נמחק; פרטי הגישה לא נשמרים בשרת.
- הטוקן נשאר בשכבת התעבורה בלבד, ולא נחשף כפרמטר של כלי.
- השתמשו בטוקן נפרד לכל סביבה: בדיקות, staging ופרודקשן.
- לגביית כרטיס בשיחה, העדיפו קישור תשלום: הלקוח מזין את הכרטיס בעמוד המאובטח של איזיקארד, כך שפרטי הכרטיס לא עוברים דרך השיחה.
פתרון תקלות
| תסמין | סיבה סבירה | פעולה |
|---|---|---|
| הכלים לא מופיעים | הקובץ לא נשמר, או שהתוכנה לא הופעלה מחדש | לשמור, לסגור לגמרי ולפתוח מחדש |
| אין כלים ב-ChatGPT | MCP כבוי או גרסה ישנה | להפעיל MCP בהגדרות ולעדכן גרסה |
| שגיאת 401 | טוקן שגוי או חסר | לבדוק מחדש את הטוקן בלוח הבקרה |
| בקשות נכשלות למרות שהכלים מופיעים | טוקן בדיקות בפרודקשן, או להפך | לוודא שהטוקן תואם לסביבה |
שאלות נפוצות
האם Stripe עובדת עם עסק ישראלי?
לא. Stripe חוסמת חברות עם רישום עסקי בישראל בשלב ה-KYC. המעקף הנפוץ הוא לפתוח חברה זרה עם חשבון בנק זר, אבל בישראל אפשר פשוט לעבוד עם חברת סליקה מקומית מורשית שעומדת בתקן PCI DSS, כמו איזיקארד, בלי חברה זרה ובלי חשבון בנק בחו״ל.
מה זה שרת MCP?
MCP, ראשי תיבות של Model Context Protocol, הוא תקן פתוח שמאפשר לעוזרי AI להתחבר למערכות חיצוניות ולהפעיל בהן פעולות. שרת ה-MCP של איזיקארד עוטף את ה-API של הסליקה, כך שעוזר AI כמו Claude או ChatGPT יכול לבצע פעולות תשלום אמיתיות מתוך שיחה, בלי לכתוב קוד לכל פעולה.
האם צריך לכתוב קוד כדי לגבות תשלום דרך ה-MCP?
לא בהכרח. אחרי חיבור השרת לעוזר ה-AI, מבקשים תשלום בשפה חופשית וה-AI בוחר את הכלי הנכון. זה מתאים לתפעול שוטף, לאב-טיפוס ולבדיקות. לזרימות פרודקשן אוטומטיות בתוך אפליקציה עדיין כדאי לקרוא ל-API ישירות ולנהל שגיאות ולוגים בעצמכם.
איך שומרים על אבטחת הטוקן?
הטוקן נשלח ככותרת HTTP בכל בקשה, מועבר ל-API של איזיקארד ואז נמחק. הוא לא נשמר בשרת ולא נחשף כפרמטר של כלי. השתמשו בטוקן נפרד לכל סביבה, ואל תשתפו את קובץ ההגדרות שמכיל אותו כטקסט גלוי.
מתי עדיף MCP ומתי קריאה ישירה ל-API?
MCP מתאים לתפעול בשיחה, לאב-טיפוס מהיר ולמשימות חד-פעמיות, בלי לכתוב קוד לכל פעולה. קריאה ישירה ל-API מתאימה לזרימות פרודקשן בתוך האפליקציה: תהליך תשלום באתר, webhooks וגבייה מתוזמנת, שם צריך שליטה מלאה וטיפול בשגיאות.
רוצים לחבר את השרת לעסק שלכם? התחילו מעמוד השירות סליקה עם AI, ואז דברו עם איזיקארד להפקת טוקן וללווי בחיבור.