REST ו-MCP · בטא

Clubzzy למפתחים

האקדמיה שלכם, פתוחה ל-Claude, ל-ChatGPT ולקוד שלכם. שואלים מי בסיכון, מושכים את הקורסים ל-Make, בונים טיוטה של קורס מתוך שיחה. מפתח אחד, באותן הרשאות שכבר יש לכם.

14
נקודות קצה
10
סוכנים מוכנים
60
בקשות בדקה
GET/api/v1/students/at-risk200
curl https://www.clubzzy.co.il/api/v1/students/at-risk \
  -H "Authorization: Bearer $CLUBZZY_API_KEY"
התשובה, בעברית ובמספרים של האקדמיה (דוגמה)
{
  "segments": [
    {
      "key": "churned",
      "name": "נוטשים",
      "students": 14
    },
    {
      "key": "no_login",
      "name": "לא מתחברים",
      "students": 9
    }
  ],
  "students": [
    {
      "id": "9a1b3c5d-7e9f-4a2b-8c4d-6e8f0a2b4c6d",
      "name": "יואב לוי",
      "segments": [
        "נוטשים"
      ],
      "reason": "נוטשים: 34 ימים ללא פעילות למידה",
      "days_without_learning": 34
    },
    {
      "id": "2c4e6a8b-0d1f-4e3a-9b5c-7d9e1f3a5b7c",
      "name": "שירה מזרחי",
      "segments": [
        "לא מתחברים"
      ],
      "reason": "לא מתחברים: 12 ימים בלי להתחבר",
      "days_without_learning": 12
    }
  ],
  "total": 23,
  "next_cursor": "eyJ0IjoiYXRfcmlza19zdHVkZW50cyIsIm8iOjUwfQ"
}
שלושה צעדים

התחלה מהירה

מהמפתח הראשון ועד תשובה ראשונה, בלי לכתוב שורת קוד.
  1. 1

    יוצרים מפתח

    ב-Clubzzy: הגדרות ← אינטגרציות ← מפתחות API. בוחרים מה המפתח רשאי לעשות, מעתיקים אותו ושומרים במקום בטוח. הוא מוצג פעם אחת בלבד.

  2. 2

    בוחרים סוכן

    Claude, ChatGPT, Cursor, Codex ועוד: לכל אחד יש הגדרה מוכנה להעתקה. כותבים קוד בעצמכם? לכל נקודה יש curl, Node.js ו-Python.

  3. 3

    שואלים בעברית

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

    מי מהתלמידים שלי בסיכון השבוע, ולמה?

    23 תלמידים. יואב לוי לא למד 34 ימים, שירה מזרחי לא התחברה 12 ימים. לשלוח לך את הרשימה המלאה?

מפתח אחד, ההרשאות שלכם

אימות ומפתחות

כל בקשה נושאת את המפתח בכותרת Authorization. מפתח לסוכנים מתחיל ב-clz_live_.
הכותרת בכל בקשה
Authorization: Bearer clz_live_…
  • אקדמיה אחת

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

  • בהרשאות של מי שיצר אותו

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

  • קריאה וטיוטות

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

  • פרטי קשר מוסתרים

    מייל וטלפון של תלמידים ולידים לא חוזרים בתשובות, אלא אם הדלקתם "פרטי קשר" כשיצרתם את המפתח.

  • תוקף

    30, 90 או 365 יום, או בלי תאריך. מפתח שפג או שבוטל מקבל 401, וביטול עובד מיד.

  • מתקדמים ופרימיום, בעלים ומנהלים

    מפתחות זמינים במסלולי מתקדמים ופרימיום, ויוצרים אותם בעלים ומנהלים. החיבור ל-Claude ול-ChatGPT עם התחברות פתוח בכל המסלולים.

ה-API בבטא

מפתח לסוכנים עובד באקדמיות ש-Clubzzy הדליקה בהן את הבטא. באקדמיה אחרת התשובה היא 404. רוצים להצטרף? כתבו לנו ל-support@clubzzy.co.il.

שומרים את המפתח מחוץ לקוד

כל הדוגמאות כאן קוראות אותו ממשתנה הסביבה CLUBZZY_API_KEY. אם החיבור לחשבון נסגר (למשל אחרי איפוס סיסמה) התשובה היא key_session_ended, ובמסך המפתחות לוחצים "חידוש".

Claude, ChatGPT, Cursor ועוד

חיבור לסוכנים

Clubzzy הוא שרת MCP. סוכן שמחובר אליו רואה את הכלים שלמטה (סיכום האקדמיה, תלמידים, קורסים, לידים) ומחליט לבד מתי לקרוא להם. הכתובת: https://www.clubzzy.co.il/api/mcp
  • התחברות

    Claude, ChatGPT

    בלי מפתח: נכנסים עם החשבון ב-Clubzzy, והחיבור פועל בהרשאות שלכם. פתוח בכל המסלולים.

  • מפתח

    Claude Code, Cursor, Codex, Gemini CLI, Grok, OpenClaw

    הכתובת של שרת ה-MCP ומפתח בכותרת, בלי ?biz=: המפתח כבר יודע לאיזו אקדמיה הוא שייך.

  • HTTP

    Make, n8n

    בקשות REST רגילות לנקודות שלמטה, עם המפתח בכותרת Authorization.

Claude

  1. 1ב-claude.ai או באפליקציה: Customize ← Connectors ← Add custom connector.
  2. 2שם: Clubzzy. בשדה Remote MCP server URL מדביקים את הכתובת שלמטה, עם המזהה של האקדמיה.
  3. 3לוחצים Connect ונכנסים עם החשבון שלכם ב-Clubzzy. החיבור פועל בהרשאות שלכם, בלי מפתח.
המדריך הרשמי של Claude
כתובת המחבר
https://www.clubzzy.co.il/api/mcp?biz=<academy-id>

סוכן אחר?

זו הצורה הכללית של הגדרת שרת MCP מרוחק עם כותרת. רוב הכלים מקבלים אותה, לפעמים עם שם שדה אחר (Gemini CLI למשל רוצה httpUrl). אם בכלי שלכם אין מקום לכותרת, חפשו "Bearer token" בהגדרות שלו.

ולסוכן שכותב קוד: קובץ skill עם כל מה שהוא צריך לדעת כדי לעבוד מול Clubzzy, ו-llms.txt עם תקציר העמוד הזה.

הצורה הכללית (JSON)
{
  "mcpServers": {
    "clubzzy": {
      "type": "http",
      "url": "https://www.clubzzy.co.il/api/mcp",
      "headers": {
        "Authorization": "Bearer clz_live_YOUR_KEY"
      }
    }
  }
}
נקודות קצה

האקדמיה

תמונת מצב בבקשה אחת: המסלול, המספרים, ומי מחובר דרך המפתח.
GET/api/v1/academy

סיכום האקדמיה

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

הרשאה: קריאהכלי MCP: academy_overview

בלי פרמטרים. שולחים את הבקשה כמו שהיא.

curl https://www.clubzzy.co.il/api/v1/academy \
  -H "Authorization: Bearer $CLUBZZY_API_KEY"
const res = await fetch("https://www.clubzzy.co.il/api/v1/academy", {
  headers: { Authorization: `Bearer ${process.env.CLUBZZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.message);
console.log(data);
import os
import requests

res = requests.get(
    "https://www.clubzzy.co.il/api/v1/academy",
    headers={"Authorization": f"Bearer {os.environ['CLUBZZY_API_KEY']}"},
    timeout=30,
)
data = res.json()
if not res.ok:
    raise RuntimeError(data["error"]["message"])
print(data)
תשובה לדוגמה200
{
  "academy": {
    "name": "בית הספר לאפייה של מיכל",
    "plan": "plan",
    "plan_name": "מתקדמים"
  },
  "you": {
    "name": "מיכל אברהם",
    "role": "owner",
    "role_name": "בעלים"
  },
  "students_scope": "all",
  "counts": {
    "students": 412,
    "clubs": 3,
    "courses": 14,
    "leads": 87,
    "joined_last_7_days": 9,
    "at_risk": 23
  }
}
נקודות קצה

מועדונים

המועדונים שיש לכם גישה אליהם, עם הקורסים שבכל אחד.
GET/api/v1/clubs

רשימת המועדונים

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

הרשאה: קריאהכלי MCP: list_clubs

פרמטרים בשאילתה (query)

  • cursorstringרשות

    ה-next_cursor מהעמוד הקודם. בלי cursor מקבלים את העמוד הראשון.

    עד 500 תווים

curl https://www.clubzzy.co.il/api/v1/clubs \
  -H "Authorization: Bearer $CLUBZZY_API_KEY"
const res = await fetch("https://www.clubzzy.co.il/api/v1/clubs", {
  headers: { Authorization: `Bearer ${process.env.CLUBZZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.message);
console.log(data);
import os
import requests

res = requests.get(
    "https://www.clubzzy.co.il/api/v1/clubs",
    headers={"Authorization": f"Bearer {os.environ['CLUBZZY_API_KEY']}"},
    timeout=30,
)
data = res.json()
if not res.ok:
    raise RuntimeError(data["error"]["message"])
print(data)
תשובה לדוגמה200
{
  "clubs": [
    {
      "id": "3f6c2a1e-8b4d-4e2f-9a7c-1d5e6f7a8b90",
      "name": "מועדון הלחם",
      "description": "מחמצת, פוקאצ׳ה ולחמי בוקר, צעד אחר צעד",
      "is_published": true,
      "courses": 6,
      "students": 318,
      "managers": [
        "מיכל אברהם"
      ]
    },
    {
      "id": "a7d41c92-5e3b-4f68-b0a1-2c9d8e7f6a54",
      "name": "בצקים עלים",
      "description": "קרואסונים ומאפים מבצק שמרים מעולה",
      "is_published": true,
      "courses": 5,
      "students": 141,
      "managers": [
        "מיכל אברהם",
        "דניאל שגיא"
      ]
    }
  ],
  "total": 2,
  "next_cursor": null
}
GET/api/v1/clubs/{id}

מועדון אחד

מועדון אחד עם המבנה שלו: הקורסים שבו (מפורסם או טיוטה, מספר שיעורים), חלון הגישה והמנהלים.

הרשאה: קריאהכלי MCP: get_club

בכתובת

  • {id}club_iduuidחובה

    מזהה המועדון (UUID)

curl https://www.clubzzy.co.il/api/v1/clubs/3f6c2a1e-8b4d-4e2f-9a7c-1d5e6f7a8b90 \
  -H "Authorization: Bearer $CLUBZZY_API_KEY"
const res = await fetch("https://www.clubzzy.co.il/api/v1/clubs/3f6c2a1e-8b4d-4e2f-9a7c-1d5e6f7a8b90", {
  headers: { Authorization: `Bearer ${process.env.CLUBZZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.message);
console.log(data);
import os
import requests

res = requests.get(
    "https://www.clubzzy.co.il/api/v1/clubs/3f6c2a1e-8b4d-4e2f-9a7c-1d5e6f7a8b90",
    headers={"Authorization": f"Bearer {os.environ['CLUBZZY_API_KEY']}"},
    timeout=30,
)
data = res.json()
if not res.ok:
    raise RuntimeError(data["error"]["message"])
print(data)
תשובה לדוגמה200
{
  "club": {
    "id": "3f6c2a1e-8b4d-4e2f-9a7c-1d5e6f7a8b90",
    "name": "מועדון הלחם",
    "description": "מחמצת, פוקאצ׳ה ולחמי בוקר, צעד אחר צעד",
    "is_published": true,
    "access_duration_days": 365,
    "access_until": null,
    "managers": [
      "מיכל אברהם"
    ],
    "courses": [
      {
        "id": "5b8e2d14-7c9a-4f31-a6e0-3d2c1b9f8e77",
        "title": "מחמצת מאפס",
        "is_published": true,
        "lessons": 18
      },
      {
        "id": "71c3d5e9-4a2b-4e8f-b6d1-9c0e2f3a4b15",
        "title": "פוקאצ׳ה בשלושה ימים",
        "is_published": true,
        "lessons": 7
      }
    ]
  },
  "you_can_edit": true
}
נקודות קצה

קורסים

הקורסים עם הפרקים והשיעורים לפי הסדר, ויצירת קורס חדש כטיוטה.
GET/api/v1/courses

רשימת הקורסים

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

הרשאה: קריאהכלי MCP: list_courses

פרמטרים בשאילתה (query)

  • club_iduuidרשות

    רק הקורסים של המועדון הזה

  • cursorstringרשות

    ה-next_cursor מהעמוד הקודם. בלי cursor מקבלים את העמוד הראשון.

    עד 500 תווים

curl "https://www.clubzzy.co.il/api/v1/courses?club_id=3f6c2a1e-8b4d-4e2f-9a7c-1d5e6f7a8b90" \
  -H "Authorization: Bearer $CLUBZZY_API_KEY"
const url = new URL("https://www.clubzzy.co.il/api/v1/courses");
url.searchParams.set("club_id", "3f6c2a1e-8b4d-4e2f-9a7c-1d5e6f7a8b90");

const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.CLUBZZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.message);
console.log(data);
import os
import requests

res = requests.get(
    "https://www.clubzzy.co.il/api/v1/courses",
    params={"club_id": "3f6c2a1e-8b4d-4e2f-9a7c-1d5e6f7a8b90"},
    headers={"Authorization": f"Bearer {os.environ['CLUBZZY_API_KEY']}"},
    timeout=30,
)
data = res.json()
if not res.ok:
    raise RuntimeError(data["error"]["message"])
print(data)
תשובה לדוגמה200
{
  "courses": [
    {
      "id": "5b8e2d14-7c9a-4f31-a6e0-3d2c1b9f8e77",
      "title": "מחמצת מאפס",
      "club_id": "3f6c2a1e-8b4d-4e2f-9a7c-1d5e6f7a8b90",
      "club_name": "מועדון הלחם",
      "is_published": true,
      "is_public": false,
      "lessons": 18,
      "updated_at": "2026-11-09T16:40:12.000Z"
    },
    {
      "id": "71c3d5e9-4a2b-4e8f-b6d1-9c0e2f3a4b15",
      "title": "פוקאצ׳ה בשלושה ימים",
      "club_id": "3f6c2a1e-8b4d-4e2f-9a7c-1d5e6f7a8b90",
      "club_name": "מועדון הלחם",
      "is_published": true,
      "is_public": true,
      "lessons": 7,
      "updated_at": "2026-10-28T09:05:44.000Z"
    }
  ],
  "total": 2,
  "next_cursor": null
}
GET/api/v1/courses/{id}

קורס אחד

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

הרשאה: קריאהכלי MCP: get_course

בכתובת

  • {id}course_iduuidחובה

    מזהה הקורס (UUID)

curl https://www.clubzzy.co.il/api/v1/courses/5b8e2d14-7c9a-4f31-a6e0-3d2c1b9f8e77 \
  -H "Authorization: Bearer $CLUBZZY_API_KEY"
const res = await fetch("https://www.clubzzy.co.il/api/v1/courses/5b8e2d14-7c9a-4f31-a6e0-3d2c1b9f8e77", {
  headers: { Authorization: `Bearer ${process.env.CLUBZZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.message);
console.log(data);
import os
import requests

res = requests.get(
    "https://www.clubzzy.co.il/api/v1/courses/5b8e2d14-7c9a-4f31-a6e0-3d2c1b9f8e77",
    headers={"Authorization": f"Bearer {os.environ['CLUBZZY_API_KEY']}"},
    timeout=30,
)
data = res.json()
if not res.ok:
    raise RuntimeError(data["error"]["message"])
print(data)
תשובה לדוגמה200
{
  "course": {
    "id": "5b8e2d14-7c9a-4f31-a6e0-3d2c1b9f8e77",
    "title": "מחמצת מאפס",
    "description": "מגדלים מחמצת ואופים כיכר ראשונה תוך שבוע.",
    "club": {
      "id": "3f6c2a1e-8b4d-4e2f-9a7c-1d5e6f7a8b90",
      "name": "מועדון הלחם"
    },
    "is_published": true,
    "is_public": false,
    "access_duration_days": null,
    "access_until": null,
    "sections": [
      {
        "id": "b2c4e6f8-1a3d-4f5b-9c7e-0d2f4a6b8c1e",
        "title": "שבוע ראשון: המחמצת",
        "lessons": [
          {
            "id": "f1a2b3c4-d5e6-4789-8abc-def012345678",
            "title": "קמח, מים וסבלנות",
            "is_published": true,
            "video_url": "https://vimeo.com/912345678",
            "text_preview": "ביום הראשון מערבבים 50 גרם קמח מלא עם 50 גרם מים…"
          }
        ]
      }
    ],
    "lessons_without_section": []
  }
}
POST/api/v1/courses

יצירת קורס כטיוטה

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

הרשאה: טיוטותכלי MCP: create_course_draft

גוף הבקשה (JSON)

  • club_iduuidחובה

    מזהה המועדון שהקורס ייכנס אליו (UUID)

  • titlestringחובה

    שם הקורס

    1 עד 200 תווים

  • descriptionstringרשות

    תיאור הקורס

    עד 2,000 תווים

  • lessonsarray<object>רשות

    שיעורים מחוץ לפרקים, לפני הפרקים

    עד 200 פריטים

  • lessons[].titlestringחובה

    שם השיעור

    1 עד 300 תווים

  • lessons[].textstringרשות

    תוכן השיעור כטקסט. כל שורה הופכת לפסקה.

    עד 20,000 תווים

  • lessons[].video_urlurlרשות

    קישור לסרטון (YouTube, Vimeo, Bunny וכו')

    עד 500 תווים

  • sectionsarray<object>רשות

    פרקים לפי הסדר, כל אחד עם השיעורים שלו

    עד 30 פריטים

  • sections[].titlestringחובה

    שם הפרק

    1 עד 200 תווים

  • sections[].lessonsarray<object>רשות

    עד 200 פריטים · ברירת מחדל: []

  • sections[].lessons[].titlestringחובה

    שם השיעור

    1 עד 300 תווים

  • sections[].lessons[].textstringרשות

    תוכן השיעור כטקסט. כל שורה הופכת לפסקה.

    עד 20,000 תווים

  • sections[].lessons[].video_urlurlרשות

    קישור לסרטון (YouTube, Vimeo, Bunny וכו')

    עד 500 תווים

curl -X POST https://www.clubzzy.co.il/api/v1/courses \
  -H "Authorization: Bearer $CLUBZZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "club_id": "a7d41c92-5e3b-4f68-b0a1-2c9d8e7f6a54",
  "title": "קרואסון ביתי",
  "description": "מבצק עלים ועד קרואסון מבריק, בתנור של הבית.",
  "sections": [
    {
      "title": "הבצק",
      "lessons": [
        {
          "title": "קיפולים ראשונים",
          "text": "מקררים את החמאה לפחות שעה לפני שמתחילים."
        },
        {
          "title": "מנוחה במקרר",
          "video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
        }
      ]
    },
    {
      "title": "אפייה",
      "lessons": [
        {
          "title": "התפחה וזיגוג"
        }
      ]
    }
  ]
}'
const res = await fetch("https://www.clubzzy.co.il/api/v1/courses", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CLUBZZY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "club_id": "a7d41c92-5e3b-4f68-b0a1-2c9d8e7f6a54",
    "title": "קרואסון ביתי",
    "description": "מבצק עלים ועד קרואסון מבריק, בתנור של הבית.",
    "sections": [
      {
        "title": "הבצק",
        "lessons": [
          {
            "title": "קיפולים ראשונים",
            "text": "מקררים את החמאה לפחות שעה לפני שמתחילים."
          },
          {
            "title": "מנוחה במקרר",
            "video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
          }
        ]
      },
      {
        "title": "אפייה",
        "lessons": [
          {
            "title": "התפחה וזיגוג"
          }
        ]
      }
    ]
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.message);
console.log(data);
import os
import requests

res = requests.post(
    "https://www.clubzzy.co.il/api/v1/courses",
    json={
        "club_id": "a7d41c92-5e3b-4f68-b0a1-2c9d8e7f6a54",
        "title": "קרואסון ביתי",
        "description": "מבצק עלים ועד קרואסון מבריק, בתנור של הבית.",
        "sections": [
            {
                "title": "הבצק",
                "lessons": [
                    {
                        "title": "קיפולים ראשונים",
                        "text": "מקררים את החמאה לפחות שעה לפני שמתחילים.",
                    },
                    {
                        "title": "מנוחה במקרר",
                        "video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
                    },
                ],
            },
            {
                "title": "אפייה",
                "lessons": [
                    {
                        "title": "התפחה וזיגוג",
                    },
                ],
            },
        ],
    },
    headers={"Authorization": f"Bearer {os.environ['CLUBZZY_API_KEY']}"},
    timeout=30,
)
data = res.json()
if not res.ok:
    raise RuntimeError(data["error"]["message"])
print(data)
תשובה לדוגמה201
{
  "course": {
    "id": "0d4a7e21-9f3c-4b65-8a17-6e5d4c3b2a90",
    "title": "קרואסון ביתי",
    "club_id": "a7d41c92-5e3b-4f68-b0a1-2c9d8e7f6a54",
    "is_published": false,
    "sections": 2,
    "lessons": 3
  },
  "editor_url": "https://www.clubzzy.co.il/go?biz=1e7b9c3a-5d2f-4a8e-b6c0-9f1d3e5a7b2c&to=%2Fadmin%2Fcourses%2F0d4a7e21-9f3c-4b65-8a17-6e5d4c3b2a90"
}
נקודות קצה

תלמידים

חיפוש, כרטיס תלמיד עם ההתקדמות, ומי בסיכון לפי ההגדרות של האקדמיה. בלי פרטי קשר, אלא אם המפתח מורשה.
GET/api/v1/students

חיפוש תלמידים

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

הרשאה: קריאהכלי MCP: search_students

פרמטרים בשאילתה (query)

  • querystringרשות

    חלק מהשם

    עד 100 תווים

  • club_iduuidרשות

    מזהה המועדון (UUID)

  • course_iduuidרשות

    מזהה הקורס (UUID)

  • sortstringרשות

    recent פעילות אחרונה, stale הכי לא פעילים, progress התקדמות, name שם, joined הצטרפות

    recentstaleprogressnamejoined
  • cursorstringרשות

    ה-next_cursor מהעמוד הקודם. בלי cursor מקבלים את העמוד הראשון.

    עד 500 תווים

curl -G https://www.clubzzy.co.il/api/v1/students \
  -H "Authorization: Bearer $CLUBZZY_API_KEY" \
  --data-urlencode "query=נועה" \
  --data-urlencode "sort=recent"
const url = new URL("https://www.clubzzy.co.il/api/v1/students");
url.searchParams.set("query", "נועה");
url.searchParams.set("sort", "recent");

const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.CLUBZZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.message);
console.log(data);
import os
import requests

res = requests.get(
    "https://www.clubzzy.co.il/api/v1/students",
    params={"query": "נועה", "sort": "recent"},
    headers={"Authorization": f"Bearer {os.environ['CLUBZZY_API_KEY']}"},
    timeout=30,
)
data = res.json()
if not res.ok:
    raise RuntimeError(data["error"]["message"])
print(data)
תשובה לדוגמה200
{
  "students": [
    {
      "id": "6e2f8a4c-1b3d-4e5f-a7c9-8d0e2f4a6b1c",
      "name": "נועה כהן",
      "joined_at": "2026-09-02T07:31:00.000Z",
      "last_login_at": "2026-11-14T19:12:47.000Z",
      "last_active_at": "2026-11-14T19:20:03.000Z",
      "avg_progress_pct": 64,
      "lessons_viewed": 15,
      "clubs": [
        "מועדון הלחם"
      ],
      "segment": "active",
      "segment_name": "פעילים",
      "risk": null,
      "access_ended": false,
      "archived": false,
      "is_staff": false
    }
  ],
  "matched": 1,
  "next_cursor": null
}
GET/api/v1/students/at-risk

תלמידים בסיכון

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

הרשאה: קריאהכלי MCP: at_risk_students

פרמטרים בשאילתה (query)

  • segmentstringרשות

    מפתח של סגמנט מתוך segments בתשובה

    עד 60 תווים

  • cursorstringרשות

    ה-next_cursor מהעמוד הקודם. בלי cursor מקבלים את העמוד הראשון.

    עד 500 תווים

curl https://www.clubzzy.co.il/api/v1/students/at-risk \
  -H "Authorization: Bearer $CLUBZZY_API_KEY"
const res = await fetch("https://www.clubzzy.co.il/api/v1/students/at-risk", {
  headers: { Authorization: `Bearer ${process.env.CLUBZZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.message);
console.log(data);
import os
import requests

res = requests.get(
    "https://www.clubzzy.co.il/api/v1/students/at-risk",
    headers={"Authorization": f"Bearer {os.environ['CLUBZZY_API_KEY']}"},
    timeout=30,
)
data = res.json()
if not res.ok:
    raise RuntimeError(data["error"]["message"])
print(data)
תשובה לדוגמה200
{
  "segments": [
    {
      "key": "churned",
      "name": "נוטשים",
      "students": 14
    },
    {
      "key": "no_login",
      "name": "לא מתחברים",
      "students": 9
    }
  ],
  "students": [
    {
      "id": "9a1b3c5d-7e9f-4a2b-8c4d-6e8f0a2b4c6d",
      "name": "יואב לוי",
      "segments": [
        "נוטשים"
      ],
      "reason": "נוטשים: 34 ימים ללא פעילות למידה",
      "days_without_learning": 34
    },
    {
      "id": "2c4e6a8b-0d1f-4e3a-9b5c-7d9e1f3a5b7c",
      "name": "שירה מזרחי",
      "segments": [
        "לא מתחברים"
      ],
      "reason": "לא מתחברים: 12 ימים בלי להתחבר",
      "days_without_learning": 12
    }
  ],
  "total": 23,
  "next_cursor": "eyJ0IjoiYXRfcmlza19zdHVkZW50cyIsIm8iOjUwfQ"
}
GET/api/v1/students/{id}

תלמיד אחד

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

הרשאה: קריאהכלי MCP: get_student

בכתובת

  • {id}student_iduuidחובה

    מזהה התלמיד (UUID)

curl https://www.clubzzy.co.il/api/v1/students/9a1b3c5d-7e9f-4a2b-8c4d-6e8f0a2b4c6d \
  -H "Authorization: Bearer $CLUBZZY_API_KEY"
const res = await fetch("https://www.clubzzy.co.il/api/v1/students/9a1b3c5d-7e9f-4a2b-8c4d-6e8f0a2b4c6d", {
  headers: { Authorization: `Bearer ${process.env.CLUBZZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.message);
console.log(data);
import os
import requests

res = requests.get(
    "https://www.clubzzy.co.il/api/v1/students/9a1b3c5d-7e9f-4a2b-8c4d-6e8f0a2b4c6d",
    headers={"Authorization": f"Bearer {os.environ['CLUBZZY_API_KEY']}"},
    timeout=30,
)
data = res.json()
if not res.ok:
    raise RuntimeError(data["error"]["message"])
print(data)
תשובה לדוגמה200
{
  "student": {
    "id": "9a1b3c5d-7e9f-4a2b-8c4d-6e8f0a2b4c6d",
    "name": "יואב לוי",
    "joined_at": "2026-07-18T10:02:00.000Z",
    "staff_role": null,
    "access": [
      {
        "club_id": "3f6c2a1e-8b4d-4e2f-9a7c-1d5e6f7a8b90",
        "club_name": "מועדון הלחם",
        "scope": "whole_club",
        "expires_at": "2027-07-18T10:02:00.000Z"
      }
    ],
    "whole_academy_access": false,
    "courses": [
      {
        "course_id": "5b8e2d14-7c9a-4f31-a6e0-3d2c1b9f8e77",
        "title": "מחמצת מאפס",
        "progress_pct": 22,
        "lessons_viewed": 4,
        "lessons_total": 18,
        "last_viewed_at": "2026-10-12T20:45:31.000Z"
      }
    ],
    "tags": [
      "רכש בהשקה"
    ],
    "mentors": [
      "דניאל שגיא"
    ],
    "risk": {
      "segments": [
        "נוטשים"
      ],
      "reason": "נוטשים: 34 ימים ללא פעילות למידה"
    }
  }
}
נקודות קצה

לידים

הלידים מהחדש לישן, עם הסטטוס ולמי הם משויכים.
GET/api/v1/leads/recent

לידים אחרונים

הלידים של האקדמיה, מהחדש לישן: שם, סטטוס, מתי נכנס ולמי הוא משויך. אפשר לסנן לפי סטטוס (מפתח או שם). פרטי קשר (אימייל וטלפון) נמסרים רק דרך מפתח API שמי שיצר אותו הרשה זאת.

הרשאה: קריאהכלי MCP: list_leads

פרמטרים בשאילתה (query)

  • statusstringרשות

    מפתח או שם של סטטוס מתוך statuses בתשובה

    עד 60 תווים

  • cursorstringרשות

    ה-next_cursor מהעמוד הקודם. בלי cursor מקבלים את העמוד הראשון.

    עד 500 תווים

curl "https://www.clubzzy.co.il/api/v1/leads/recent?status=new" \
  -H "Authorization: Bearer $CLUBZZY_API_KEY"
const url = new URL("https://www.clubzzy.co.il/api/v1/leads/recent");
url.searchParams.set("status", "new");

const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.CLUBZZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.message);
console.log(data);
import os
import requests

res = requests.get(
    "https://www.clubzzy.co.il/api/v1/leads/recent",
    params={"status": "new"},
    headers={"Authorization": f"Bearer {os.environ['CLUBZZY_API_KEY']}"},
    timeout=30,
)
data = res.json()
if not res.ok:
    raise RuntimeError(data["error"]["message"])
print(data)
תשובה לדוגמה200
{
  "statuses": [
    {
      "key": "new",
      "name": "חדש",
      "archived": false
    },
    {
      "key": "call_scheduled",
      "name": "תואמה שיחה",
      "archived": false
    },
    {
      "key": "purchased",
      "name": "רכש",
      "archived": false
    }
  ],
  "leads": [
    {
      "id": "4f6a8c0e-2b4d-4f6a-8c0e-2b4d6f8a0c2e",
      "name": "אורי בן דוד",
      "status": "new",
      "status_name": "חדש",
      "created_at": "2026-11-15T08:14:22.000Z",
      "entered_at": "2026-11-15T08:14:22.000Z",
      "assigned_to": "דניאל שגיא"
    }
  ],
  "next_cursor": null
}
Make, Zapier ובוטים

הרשמה ולידים

ארבע הנקודות הוותיקות, למי שמחבר דף נחיתה, מערכת סליקה או בוט לידים. הן עובדות עם מפתח שיש לו הרשאת enroll או leads, גם מפתח ותיק שמתחיל ב-clz_, ועונות בצורת השגיאה הוותיקה.
POST/api/v1/enroll

הרשמת תלמיד

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

הרשאה: enroll300 בקשות בדקה

כותרות

  • Idempotency-Keystringרשות

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

גוף הבקשה (JSON)

  • emailstringחובה

    המייל של התלמיד. מי שכבר רשום מקבל את הגישה לחשבון הקיים.

  • namestringרשות

    שם מלא

  • phonestringרשות

    טלפון

  • grantobjectרשות

    מה לפתוח לתלמיד. בלי grant נפתח חשבון בלבד.

  • grant.typestringחובה

    היקף הגישה

    businessclubcourse
  • grant.iduuidרשות

    מזהה המועדון או הקורס. ל-business לא צריך.

  • tagsarray<string>רשות

    תגיות לתלמיד, למשל מקור הרכישה. תגית חדשה נוצרת לבד.

    עד 20 פריטים

  • חשבון חדש מקבל 201 וסיסמה זמנית ב-tempPassword, להעביר לתלמיד. חשבון קיים מקבל 200 בלי סיסמה.
  • תשובה שחוזרת בזכות Idempotency-Key מסומנת ב-"idempotent": true.
curl -X POST https://www.clubzzy.co.il/api/v1/enroll \
  -H "Authorization: Bearer $CLUBZZY_API_KEY" \
  -H "Idempotency-Key: order-48213" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "noa.cohen@example.com",
  "name": "נועה כהן",
  "phone": "0501234567",
  "grant": {
    "type": "course",
    "id": "5b8e2d14-7c9a-4f31-a6e0-3d2c1b9f8e77"
  },
  "tags": [
    "רכש בהשקה"
  ]
}'
const res = await fetch("https://www.clubzzy.co.il/api/v1/enroll", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CLUBZZY_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "order-48213",
  },
  body: JSON.stringify({
    "email": "noa.cohen@example.com",
    "name": "נועה כהן",
    "phone": "0501234567",
    "grant": {
      "type": "course",
      "id": "5b8e2d14-7c9a-4f31-a6e0-3d2c1b9f8e77"
    },
    "tags": [
      "רכש בהשקה"
    ]
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(data.message);
console.log(data);
import os
import requests

res = requests.post(
    "https://www.clubzzy.co.il/api/v1/enroll",
    json={
        "email": "noa.cohen@example.com",
        "name": "נועה כהן",
        "phone": "0501234567",
        "grant": {
            "type": "course",
            "id": "5b8e2d14-7c9a-4f31-a6e0-3d2c1b9f8e77",
        },
        "tags": [
            "רכש בהשקה",
        ],
    },
    headers={
        "Authorization": f"Bearer {os.environ['CLUBZZY_API_KEY']}",
        "Idempotency-Key": "order-48213",
    },
    timeout=30,
)
data = res.json()
if not res.ok:
    raise RuntimeError(data["message"])
print(data)
תשובה לדוגמה201
{
  "ok": true,
  "studentId": "6e2f8a4c-1b3d-4e5f-a7c9-8d0e2f4a6b1c",
  "email": "noa.cohen@example.com",
  "isNew": true,
  "granted": {
    "type": "course",
    "id": "5b8e2d14-7c9a-4f31-a6e0-3d2c1b9f8e77"
  },
  "tempPassword": "Kx7pq2mRa9"
}
PATCH/api/v1/leads/{id}/status

שינוי סטטוס של ליד

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

הרשאה: leads120 בקשות בדקה

בכתובת

  • {id}uuidחובה

    מזהה הליד, מהחיפוש

גוף הבקשה (JSON)

  • statusstringחובה

    ה-id או השם של הסטטוס החדש

  • notestringרשות

    למה, שורה אחת בהיסטוריה

    עד 300 תווים

  • ליד שכבר נמצא בסטטוס הזה לא משתנה, והתשובה אומרת "changed": false.
curl -X PATCH https://www.clubzzy.co.il/api/v1/leads/8b0d2f4a-6c8e-4a0b-9d2f-4a6c8e0b2d4f/status \
  -H "Authorization: Bearer $CLUBZZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "תואמה שיחה",
  "note": "קבענו שיחה ליום שלישי"
}'
const res = await fetch("https://www.clubzzy.co.il/api/v1/leads/8b0d2f4a-6c8e-4a0b-9d2f-4a6c8e0b2d4f/status", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.CLUBZZY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "status": "תואמה שיחה",
    "note": "קבענו שיחה ליום שלישי"
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(data.message);
console.log(data);
import os
import requests

res = requests.patch(
    "https://www.clubzzy.co.il/api/v1/leads/8b0d2f4a-6c8e-4a0b-9d2f-4a6c8e0b2d4f/status",
    json={
        "status": "תואמה שיחה",
        "note": "קבענו שיחה ליום שלישי",
    },
    headers={"Authorization": f"Bearer {os.environ['CLUBZZY_API_KEY']}"},
    timeout=30,
)
data = res.json()
if not res.ok:
    raise RuntimeError(data["message"])
print(data)
תשובה לדוגמה200
{
  "ok": true,
  "id": "8b0d2f4a-6c8e-4a0b-9d2f-4a6c8e0b2d4f",
  "status": "call_scheduled",
  "status_name": "תואמה שיחה",
  "previous_status": "no_answer",
  "changed": true
}
GET/api/v1/leads/statuses

הסטטוסים של הלידים

כל הסטטוסים של האקדמיה, לפי הסדר שלה. את ה-id או השם שולחים לשינוי סטטוס.

הרשאה: leads120 בקשות בדקה

בלי פרמטרים. שולחים את הבקשה כמו שהיא.

curl https://www.clubzzy.co.il/api/v1/leads/statuses \
  -H "Authorization: Bearer $CLUBZZY_API_KEY"
const res = await fetch("https://www.clubzzy.co.il/api/v1/leads/statuses", {
  headers: { Authorization: `Bearer ${process.env.CLUBZZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data.message);
console.log(data);
import os
import requests

res = requests.get(
    "https://www.clubzzy.co.il/api/v1/leads/statuses",
    headers={"Authorization": f"Bearer {os.environ['CLUBZZY_API_KEY']}"},
    timeout=30,
)
data = res.json()
if not res.ok:
    raise RuntimeError(data["message"])
print(data)
תשובה לדוגמה200
{
  "statuses": [
    {
      "id": "new",
      "name": "חדש",
      "order": 1,
      "hidden": false,
      "archived": false,
      "closed": false,
      "meeting": false
    },
    {
      "id": "no_answer",
      "name": "לא ענה",
      "order": 2,
      "hidden": false,
      "archived": false,
      "closed": false,
      "meeting": false
    },
    {
      "id": "call_scheduled",
      "name": "תואמה שיחה",
      "order": 3,
      "hidden": false,
      "archived": false,
      "closed": false,
      "meeting": true
    },
    {
      "id": "purchased",
      "name": "רכש",
      "order": 4,
      "hidden": false,
      "archived": false,
      "closed": true,
      "meeting": false
    }
  ]
}
כשמשהו לא עובד

שגיאות

תשובה תקינה היא 200 (או 201 ליצירת טיוטה) עם הנתונים עצמם. שגיאה חוזרת תמיד באותה צורה: קוד קבוע שהקוד שלכם בודק, והסבר בעברית שאפשר להציג כמו שהוא.
  • invalid_input400

    הקלט לא תקין: פרמטר חסר, מזהה שאינו UUID, או שדה שהנקודה לא מכירה. ה-message אומר בדיוק מה.

  • unauthorized401

    אין מפתח, המפתח שגוי, בוטל או שפג תוקפו.

  • key_session_ended401

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

  • forbidden403

    אין הרשאה לזה: למפתח אין הרשאת טיוטות, או שהתפקיד של מי שיצר אותו לא רואה את האזור.

  • plan_forbidden403

    המסלול של האקדמיה לא כולל API. מפתחות עובדים במסלולי מתקדמים ופרימיום.

  • not_found404

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

  • rate_limited429

    יותר מ-60 בקשות בדקה מאותו מפתח. מחכים את מספר השניות שבכותרת Retry-After ושולחים שוב.

  • server_error500

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

צורת השגיאה404
{
  "error": {
    "code": "not_found",
    "message": "הקורס לא נמצא באקדמיה הזו."
  }
}

ארבע הנקודות של Make ו-Zapier (למטה) עונות בצורה הוותיקה, שטוחה:{ "error": "<code>", "message": "…" }

קצב ועמודים

מגבלות קצב

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

    בקשות בדקה לכל מפתח

    מעבר לזה התשובה היא 429, עם Retry-After בשניות.

  • 30

    טיוטות בשעה

    יצירת קורס כטיוטה נספרת בנפרד, לכל מפתח.

  • 50

    שורות בעמוד

    רשימה ארוכה יותר ממשיכה עם next_cursor.

עמוד אחרי עמוד

כל רשימה מחזירה עד 50 שורות ו-next_cursor. שולחים אותו בבקשה הבאה כ-cursor, עד שהוא חוזר null.

Node.js: כל התלמידים
let cursor = null;
do {
  const url = new URL("https://www.clubzzy.co.il/api/v1/students");
  if (cursor) url.searchParams.set("cursor", cursor);
  const res = await fetch(url, {
    headers: { Authorization: `Bearer ${process.env.CLUBZZY_API_KEY}` },
  });
  const page = await res.json();
  for (const student of page.students) console.log(student.name);
  cursor = page.next_cursor;
} while (cursor);

כשמגיעים לתקרה

הכותרת Retry-After אומרת כמה שניות לחכות. הנקודות של Make ו-Zapier מקבלות יותר: 300 הרשמות בדקה, 120 בקשות לידים בדקה.

Retry-After: 18429
{
  "error": {
    "code": "rate_limited",
    "message": "יותר מדי בקשות. נסו שוב בעוד רגע."
  }
}
מתחילים
סקירה
התחלה מהירה
אימות ומפתחות
חיבור לסוכנים
חיבור לסוכנים
Claude
ChatGPT
Claude Code
Cursor
Codex
Gemini CLI
Grok
OpenClaw
Make
n8n
נקודות קצה
האקדמיה
האקדמיה
GETסיכום האקדמיה
נקודות קצה
מועדונים
מועדונים
GETרשימת המועדונים
GETמועדון אחד
נקודות קצה
קורסים
קורסים
GETרשימת הקורסים
GETקורס אחד
POSTיצירת קורס כטיוטה
נקודות קצה
תלמידים
תלמידים
GETחיפוש תלמידים
GETתלמידים בסיכון
GETתלמיד אחד
נקודות קצה
לידים
לידים
GETלידים אחרונים
Make ו-Zapier
POSTהרשמת תלמיד
PATCHשינוי סטטוס של ליד
GETהסטטוסים של הלידים
עוד
שגיאות
מגבלות קצב
OpenAPI ו-llms.txt