חיבור QuoteCraft לכלי AI דרך MCP ו-CLI

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

מה זה נותן

QuoteCraft מדבר MCP, הפרוטוקול הפתוח שכלי AI משתמשים בו כדי להתחבר למערכות חיצוניות.

כמה הצעות פתוחות יש לי מעל 20 אלף שקל, ומי מהן לא נפתחה בשבוע האחרון?
תכין הצעת ריטיינר למרפאת שיניים חיוך רחב - 7,500 לחודש ל-12 חודשים
תראה לי אילו לקוחות במערכת עם פרטי קשר לא תקינים

דרישות

Node.js 18.17 ומעלהבדיקה מהירה: node --version
חשבון QuoteCraft פעילכל מסלול, כולל תקופת ניסיון.
מפתח APIנוצר מתוך המערכת, ומוצג פעם אחת בלבד.

יצירת מפתח API

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

הרשאה	מה היא מאפשרת
`offers:read`	קריאת הצעות מחיר, סעיפים, אנליטיקס וחתימות.
`offers:write`	יצירה, עדכון, שכפול ושליחה של הצעות.
`clients:read`	קריאת כרטיסי לקוח והיסטוריית הצעות.
`clients:write`	הוספה, עדכון ומחיקה רכה של לקוחות.
`documents:read`	קריאת מסמכים לחתימה והסטטוס שלהם.
`documents:write`	יצירה ועדכון של מסמכים לחתימה.

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

התקנה

1. התקנה גלובלית
npm install -g @goatmarketing/quotecraft
2. שמירת המפתח מקומית
quotecraft login
3. חיבור לכלי (לדוגמה Claude Desktop)
quotecraft mcp install claude-desktop

חיבור לכל כלי

Claude Desktop

{
  "mcpServers": {
    "quotecraft": {
      "command": "npx",
      "args": [
        "-y",
        "@goatmarketing/quotecraft",
        "quotecraft-mcp"
      ],
      "env": {
        "QUOTECRAFT_API_KEY": "qc_live_..."
      }
    }
  }
}

מערכת	נתיב הקובץ
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

החליפו את qc_live_... במפתח שלכם, והפעילו מחדש את Claude Desktop.

הכלים הזמינים

קריאה

`quotecraft_whoami`	פרטי החשבון וההרשאות של המפתח.
`quotecraft_list_offers`	רשימת הצעות עם סינון לפי סטטוס, לקוח וסכום.
`quotecraft_get_offer`	הצעה בודדת על כל הסעיפים והתנאים.
`quotecraft_get_offer_analytics`	צפיות, זמן שהייה וחזרות למחירון.
`quotecraft_get_signature`	תמונת החתימה החתומה והבלתי ניתנת לשינוי.
`quotecraft_list_clients`	רשימת לקוחות כולל שלמות פרטי הקשר.
`quotecraft_get_client`	כרטיס לקוח בודד והיסטוריית ההצעות שלו.
`quotecraft_list_documents`	מסמכים לחתימה והסטטוס שלהם.
`quotecraft_list_templates`	תבניות ההצעה הזמינות בחשבון.
`quotecraft_list_landing_pages`	דפי נחיתה, צפיות והמרות.
`quotecraft_get_landing_page_leads`	לידים שנקלטו מדף נחיתה מסוים.
`quotecraft_get_reports`	סיכום משפך: נשלח, נצפה, נחתם, הכנסה.

חישוב

`quotecraft_calculate_totals`	חישוב ביניים, הנחה, מע"מ וסה"כ. מקומי, בלי רשת.
`quotecraft_calculate_retainer`	שווי התחייבות מלא לריטיינר, לא חודש בודד. מקומי, בלי רשת.
`quotecraft_validate_contact`	בדיקת תקינות אימייל, טלפון ותעודת זהות. מקומי, בלי רשת.

כתיבה

`quotecraft_create_offer`	יצירת הצעה חדשה כטיוטה.
`quotecraft_update_offer`	עדכון סעיפים, מחירים ותנאים בהצעה קיימת.
`quotecraft_duplicate_offer`	שכפול הצעה קיימת על כל תוכנה.
`quotecraft_send_offer`	שליחת ההצעה ללקוח במייל.
`quotecraft_create_client`	הוספת לקוח חדש ל-CRM.
`quotecraft_update_client`	עדכון פרטי לקוח קיים.
`quotecraft_delete_client`	מחיקה רכה של לקוח מה-CRM.
`quotecraft_create_document`	יצירת מסמך חדש לחתימה.

אבטחה

ה-CLI שומר את המפתח בקובץ ~/.quotecraft/config.json עם הרשאות 0600, קריא רק למשתמש שלכם.
קבצי ההגדרות של כלי ה-AI שומרים את המפתח בטקסט גלוי. זו מגבלה של הכלים עצמם.
השתמשו במפתח נפרד לכל מכשיר, עם ההרשאות המינימליות שנדרשות לעבודה.
הוסיפו את .mcp.json ואת קבצי ההגדרות המקומיים ל-.gitignore.
ביטול מפתח נעשה בהגדרות, בלשונית חיבורים, והוא נכנס לתוקף מיד.

פתרון תקלות

הכלי לא מופיע אחרי ההתקנה

סגרו את האפליקציה לגמרי (ב-macOS: Cmd+Q, לא רק סגירת החלון) ופתחו מחדש.

spawn npx ENOENT

הכלי לא מוצא את npx. השתמשו בנתיב מלא במקום npx. למציאת הנתיב הריצו את אחת הפקודות הבאות.

C:\Program Files\nodejs\npx.cmd

where npx

which npx

401 - מפתח לא תקין

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

403 - אין הרשאה

ההרשאות נקבעות ביצירת המפתח ולא ניתן להוסיף בדיעבד. צרו מפתח חדש עם ה-scope הנכון.

השרת עולה אבל הכלים לא נקראים

ודאו שאתם ב-Agent mode ולא ב-Ask/Chat mode.

בדיקה עצמית

הפקודה בודקת גרסת Node, תקינות המפתח, גישה ל-API וקבצי הגדרות של כלי ה-AI.

quotecraft mcp doctor

למפתחים

שיטה	נתיב	תיאור
`GET`	`/api/v1/me`	פרטי החשבון וההרשאות של המפתח.
`GET`	`/api/v1/offers`	רשימת הצעות עם סינון ועימוד.
`POST`	`/api/v1/offers`	יצירת הצעה חדשה.
`GET`	`/api/v1/offers/:id`	הצעה בודדת על כל הסעיפים.
`PATCH`	`/api/v1/offers/:id`	עדכון הצעה קיימת.
`POST`	`/api/v1/offers/:id/duplicate`	שכפול הצעה.
`POST`	`/api/v1/offers/:id/send`	שליחת ההצעה ללקוח.
`POST`	`/api/v1/offers/:id/archive`	העברת הצעה לארכיון.
`GET`	`/api/v1/offers/:id/analytics`	צפיות, שהייה וחזרות למחירון.
`GET`	`/api/v1/offers/:id/signature`	תמונת החתימה הבלתי ניתנת לשינוי.
`GET`	`/api/v1/offers/:id/pdf`	הפקת ההצעה כ-PDF.
`GET`	`/api/v1/clients`	רשימת לקוחות.
`POST`	`/api/v1/clients`	הוספת לקוח.
`GET`	`/api/v1/clients/:id`	כרטיס לקוח בודד.
`PATCH`	`/api/v1/clients/:id`	עדכון לקוח.
`DELETE`	`/api/v1/clients/:id`	מחיקה רכה של לקוח.
`GET`	`/api/v1/documents`	מסמכים לחתימה.
`GET`	`/api/v1/documents/:id`	מסמך בודד.
`GET`	`/api/v1/landing-pages`	דפי נחיתה וביצועים.
`GET`	`/api/v1/landing-pages/:id/leads`	לידים שנקלטו מדף נחיתה.
`GET`	`/api/v1/templates`	תבניות ההצעה בחשבון.
`GET`	`/api/v1/reports/summary`	סיכום משפך והכנסות.

תשובת רשימה מוחזרת כ-{ data, nextCursor, total }. עימוד נעשה עם cursor ולא עם offset.
שגיאה מוחזרת כ-{ error, message, code, required_scope }.
חריגה ממכסת הקצב מחזירה 429 עם כותרת Retry-After בשניות.
כל תשובה נושאת כותרת x-request-id, שימושית לפניות תמיכה.
סכומים מוחזרים בשקלים, ותאריכים בפורמט ISO 8601 באזור UTC.

GET  https://quote-craft.goatmarketing.co.il/api/v1/offers?status=sent
Authorization: Bearer qc_live_...
Accept: application/json

מוכנים להתחיל

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

כניסה ל-QuoteCraft