MCP
חברו את Sendy לעוזרי AI כמו Claude - שליחה, אימות טלפון וניהול אנשי קשר בשיחה.
MCP (Model Context Protocol) הוא תקן פתוח שמחבר עוזרי AI לכלים חיצוניים. שרת ה‑MCP של Sendy מאפשר לעוזר AI כמו Claude לשלוח SMS, לאמת מספרי טלפון בקוד חד-פעמי, לנהל אנשי קשר וקבוצות ולבדוק יתרת קרדיטים - ישירות מתוך שיחה, בלי לכתוב קוד.
העוזר מקבל אחת-עשרה פעולות (tools): שליחת SMS, בדיקת סטטוס הודעה, שליחת קוד אימות ובדיקתו, יצירה ועדכון של אנשי קשר, רשימות אנשי קשר, קבוצות, שמות שולח, שדות מותאמים ויתרת קרדיטים - מעל אותו API שמשמש את שאר החיבורים.
האימות מבוסס על מפתח ה‑API של הארגון (אותו מפתח sk_live_ כמו ב‑REST API): כל בקשה מאומתת, מחויבת מול יתרת הקרדיטים של אותו ארגון, ובמצב שיווקי שליחה למספר שהסיר את עצמו נדחית ולא מחויבת.
בכל הדוגמאות שלמטה החליפו את sk_live_YOUR_KEY במפתח ה‑API של הארגון (נוצר בעמוד המפתחים). ChatGPT דורש OAuth ולכן אינו נתמך - נתמכים לקוחות שמתחברים עם מפתח (Bearer).
התקנה
Claude Code (CLI)
claude mcp add --transport http sendy https://sendy.co.il/api/mcp \
--header "Authorization: Bearer sk_live_YOUR_KEY"VS Code (Copilot)
code --add-mcp '{"name":"sendy","type":"http","url":"https://sendy.co.il/api/mcp","headers":{"Authorization":"Bearer sk_live_YOUR_KEY"}}'Codex CLI
export SENDY_API_KEY=sk_live_YOUR_KEY
codex mcp add sendy --url https://sendy.co.il/api/mcp \
--bearer-token-env-var SENDY_API_KEYדורש גרסה עדכנית של Codex CLI (תמיכה ב‑streamable HTTP).
Gemini CLI
gemini mcp add --transport http sendy https://sendy.co.il/api/mcp \
--header "Authorization: Bearer sk_live_YOUR_KEY"Windsurf
- פתחו Settings → Cascade → MCP servers → View raw config, והוסיפו:
{
"mcpServers": {
"sendy": {
"serverUrl": "https://sendy.co.il/api/mcp",
"headers": { "Authorization": "Bearer sk_live_YOUR_KEY" }
}
}
}Cline
- בתוסף Cline: MCP Servers → Configure MCP Servers, והוסיפו:
{
"mcpServers": {
"sendy": {
"type": "streamableHttp",
"url": "https://sendy.co.il/api/mcp",
"headers": { "Authorization": "Bearer sk_live_YOUR_KEY" }
}
}
}שדה ה‑type חייב להיות בדיוק streamableHttp (camelCase) - אחרת Cline נופל ל‑SSE ומחזיר 405.
פעולות ו‑Endpoints
כל האינטגרציות עוטפות את אותו REST API של Sendy (/api/v1) וחושפות את נקודות הקצה הבאות כפעולות. התיעוד המלא זמין בעמוד המפתחים. אירועים בזמן אמת (סטטוס מסירה, הודעות נכנסות, הסרות) מגיעים דרך Webhooks - אפשר להפנות אותם גם לכתובת webhook של הכלי. להגדרה שלב אחר שלב: המדריך המלא ל-Webhooks.
- POST
/messagesשליחת הודעת SMS - GET
/messages/{id}בדיקת סטטוס המסירה של הודעה - POST
/contactsיצירה או עדכון של איש קשר (לפי מספר טלפון), כולל סימון כמוסר - GET
/contactsרשימת אנשי קשר או חיפוש לפי מספר - GET
/segmentsרשימת הקבוצות וגודל כל אחת - GET
/sendersרשימת שמות השולח המאושרים - GET
/creditsיתרת הקרדיטים של הארגון - GET
/custom-fieldsהשדות המותאמים אישית של הארגון - GET
/inboundההודעות שהתקבלו במספר הווירטואלי - GET
/numberפרטי המספר הווירטואלי של הארגון - POST
/verifyשליחת קוד אימות ב-SMS (start_verification) - POST
/verify/{id}/checkבדיקת הקוד שהמשתמש הקליד (check_verification)
צריכים מפתח API? צרו אותו בעמוד המפתחים לאחר התחברות.