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).

למידע על פרוטוקול MCP

התקנה

Claude Code (CLI)

claude mcp add --transport http sendy https://sendy.co.il/api/mcp \
  --header "Authorization: Bearer sk_live_YOUR_KEY"

Cursor

הוספה ל‑Cursor

לאחר הלחיצה, החליפו ב‑mcp.json את YOUR_SENDY_API_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) וחושפות את הנתיבים הבאים כפעולות. התיעוד המלא זמין בעמוד המפתחים.

POST/messagesשליחת הודעת SMS
GET/messages/{id}בדיקת סטטוס המסירה של הודעה
POST/contactsיצירה או עדכון של איש קשר (לפי מספר טלפון)
GET/contactsרשימת אנשי קשר או חיפוש לפי מספר
GET/segmentsרשימת הקבוצות וגודל כל אחת
GET/sendersרשימת שמות השולח המאושרים
GET/creditsיתרת הקרדיטים של הארגון
GET/custom-fieldsהשדות המותאמים אישית של הארגון

צריכים מפתח API? צרו אותו בעמוד המפתחים לאחר התחברות.