BillOS
התחילו עכשיו
BillOS/AI/MCP

הפיקו מסמכים עם MCP

שרת MCP מתארח, בלי להתקין כלום. הסוכן שלכם מקבל שלושה עשר כלים על אותו ספר שה-API מנהל, ומפיק, מבטל ורושם בשפה טבעית.

התחילו עכשיו ‹ תיעוד ‹

בלוק אחד, כל לקוח

Streamable HTTP על https://api.billos.co.il/mcp, מאחורי אותו מפתח, אותו מדידה ואותם מכסים כמו REST.

// claude_desktop_config.json
{
  "mcpServers": {
    "billos": {
      "url": "https://api.billos.co.il/mcp",
      "headers": { "X-Api-Key": "bk_live_xxxxxxxx" }
    }
  }
}

הסוכן מבקש, אתם מאשרים

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

bash
$ npx billos sandbox   # מדפיס קישור, מחכה לאישור שלכם, ושומר את המפתח
$ npx billos init      # מכין את הריפו ל-Claude Code, Cursor ו-Codex

# או בלי כלים: הבקשה, ואז איסוף המפתח אחרי האישור
$ curl -X POST https://api.billos.co.il/v1/sandboxes
{ "status": "authorization_required", "verifyUrl": "https://dash.billos.co.il/device?code=KQ7M-2XHD", "deviceCode": "…" }
$ curl -X POST https://api.billos.co.il/v1/sandboxes/token -d '{"deviceCode":"…"}'
{ "status": "approved", "apiKey": "bk_test_…" }

הערכה המלאה לסוכנים, עם Skill, plugin ל-Claude Code ושלוש אפליקציות דוגמה: github.com/billos-dev/billos

בקשו מהסוכן…

משפטים, לא סכמות. הסוכן בוחר את הכלי, BillOS עושה את החלק החוקי.

תוציא קבלה על 350 שקל לדנה לוי, שילמה באשראי חשבונית מס לנועם אירועים על 2,480 לפני מע"מ, שוטף פלוס 30 מה ההכנסות של החודש לעומת החודש שעבר? תבטל את החשבונית האחרונה של דנה, היא החזירה את ההזמנה תרשום הוצאה: דלק בפז, 118 שקל, אתמול מי הלקוחות שלא שילמו עדיין? כמה מע"מ אני חייב לדיווח הזה? תמצא את יוסי כהן, ואם אין, תפתח לו כרטיס עם הטלפון 054-222-3333 תראה לי את כל המסמכים של ספטמבר

כל כלי שהסוכן צריך לנהל ספר

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

list_businessesנקודת הכניסה: אילו עסקים המפתח מחזיק.
create_documentמפיק חשבונית, קבלה או חשבונית מס/קבלה ומחזיר את קישור ה-PDF הציבורי.
cancel_documentחשבונית זיכוי מקושרת. התיקון החוקי היחיד.
find_or_create_customerהתאמה לפי טלפון קודם, כדי שלקוח חוזר לא יהפוך לשני כרטיסים.
list_customersהלקוחות עם המסמכים והחובות שלהם.
list_documentsמסמכים לפי סטטוס, תאריכים ולקוח.
record_expenseרושם הוצאה. בחשבון ממתין נוחתת טיוטה, והסוכן מקבל את זה בתשובה.
list_expensesההוצאות לפי תקופה וסטטוס.
financial_summaryהכנסות, הוצאות ומע"מ לתקופה.
list_open_itemsמי חייב כסף ומכמה זמן, עם המזהה שקבלה צריכה כדי לסגור את החוב.
create_businessפותח עסק תחת המפתח ומחזיר את המזהה שכל כלי אחר צריך.
seed_sandboxבסנדבוקס בלבד: עסק לדוגמה עם לקוחות, מסמכים והוצאות.
search_docsחיפוש בתיעוד, לפי סעיף. למה שהכלים לא מכסים, ולכתיבת קוד מול ה-API.

מה סוכן יכול, ומה לא

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

  • הסכומים באגורות, כמו בכל שטח של BillOS
  • dryRun בודק הכל ולא מפיק דבר; idempotencyKey מונע הפקה כפולה
  • סירוב מסביר מה לתקן: reason, hint ו-param
  • אין כלי מחיקה, ולא יהיה
  • אין הנפקת מפתחות מתוך MCP: מפתח שדלף לא יכול להוליד יורש
tools/call · create_document
{
  "name": "create_document",
  "arguments": {
    "businessId": "biz_9k…",
    "docType": "invoice_receipt",
    "customerName": "דנה לוי",
    "customerPhone": "0521111111",
    "lines": [{ "description": "איפור ערב", "priceIncVatAgorot": 35000 }],
    "paymentMethod": "card",
    "idempotencyKey": "order-1001"
  }
}
→ { "issued": true, "docNumber": 1042, "totalDisplay": "₪350.00",
    "publicPdfPath": "/api/docs/5f3k…/d.pdf" }

הסוכן שלכם
מנהל ספרים.

התחילו עכשיו ‹