הפיקו מסמכים עם 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" }
    }
  }
}

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

$ claude mcp add --transport http billos https://api.billos.co.il/mcp \
    --header "X-Api-Key: bk_live_xxxxxxxx"

# ~/.codex/config.toml
[mcp_servers.billos]
url = "https://api.billos.co.il/mcp"
http_headers = { "X-Api-Key" = "bk_live_xxxxxxxx" }

בקשו מהסוכן…

משפטים, לא סכמות. הסוכן בוחר את הכלי, 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הכנסות, הוצאות ומע"מ לתקופה.

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

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

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

tools/call · create_document

{
  "name": "create_document",
  "arguments": {
    "businessId": "biz_9k…",
    "docType": 320,
    "customer": { "name": "דנה לוי", "phone": "0521111111" },
    "lines": [{ "description": "איפור ערב", "amount": 35000 }],
    "paymentMethod": "card"
  }
}
→ "הופקה חשבונית מס/קבלה 1042 על ₪350.00 · https://api.billos.co.il/api/docs/5f3k…/d.pdf"

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

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

בקשו מהסוכן…

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

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

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

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