1. יוצרים מפתח API אחד
ב-Studio: אינטגרציות ← מפתחות API ← יצירת מפתח (תפקיד מהנדס ומעלה). תנו למפתח רק את ההרשאות שהסוכן צריך: לסוכן לקריאה בלבד מספיקות channels:read, assets:read ו-stats:read. המפתח מוצג פעם אחת, ומבטלים אותו באותו מסך.
מספיק מפתח API אחד. Claude Code, Cursor, Claude Desktop או כל לקוח MCP יכולים לעבוד בשפה רגילה עם הערוצים, הצפייה החוזרת, הספרייה, הכתוביות, סיכומי ה-AI, הקליפים והסטטיסטיקות שלכם ב-ViewStream, דרך שרת ה-MCP של ViewStream או ה-REST API. כל מה שהסוכן עושה עובר דרך אותו API, אותן הרשאות ואותו יומן ביקורת כמו Studio.
ב-Studio: אינטגרציות ← מפתחות API ← יצירת מפתח (תפקיד מהנדס ומעלה). תנו למפתח רק את ההרשאות שהסוכן צריך: לסוכן לקריאה בלבד מספיקות channels:read, assets:read ו-stats:read. המפתח מוצג פעם אחת, ומבטלים אותו באותו מסך.
ל-ViewStream יש שרת MCP מרוחק בכתובת https://api.viewstream.co.il/mcp. אין מה להתקין: מוסיפים את הכתובת ואת המפתח ל-Claude Code, Cursor, Claude Desktop או לכל לקוח MCP.
„מה משודר עכשיו בכל הערוצים?” הסוכן בוחר את הכלים הנכונים, מפעיל אותם עם המפתח שלכם ועונה בשפה שלכם, כולל כותרות וכתוביות בעברית.
אין לכם עדיין חשבון ViewStream? פתחו חשבון חינמי בדקה: תוכנית חינמית ללא הגבלת זמן וללא כרטיס אשראי (ספריית וידאו, נגן, וורדפרס / Next.js, סיכומי AI). לצרכים גדולים יותר, ערוצים חיים או הסכם מותאם: כתבו ל-[email protected] או השתמשו בטופס יצירת הקשר.
החליפו את <key> במפתח ה-API שלכם (vs_…). השרת מדבר MCP Streamable HTTP ומזהה לפי Authorization: Bearer <key>.
claude mcp add --transport http viewstream \ https://api.viewstream.co.il/mcp \ --header "Authorization: Bearer <key>" # check it, then ask: claude mcp list # "Using viewstream, what is on air on all channels right now?"
בקובץ ~/.cursor/mcp.json (לכל הפרויקטים) או .cursor/mcp.json (לפרויקט אחד; אל תכניסו את המפתח ל-git):
{
"mcpServers": {
"viewstream": {
"url": "https://api.viewstream.co.il/mcp",
"headers": { "Authorization": "Bearer <key>" }
}
}
}
מחברים מותאמים אישית מתחברים עם OAuth, ש-ViewStream עדיין לא מציע. בינתיים משתמשים בגשר mcp-remote (דורש Node.js) בקובץ claude_desktop_config.json:
{
"mcpServers": {
"viewstream": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.viewstream.co.il/mcp",
"--header", "Authorization:${AUTH_HEADER}"],
"env": { "AUTH_HEADER": "Bearer <key>" }
}
}
}
כל לקוח שתומך בשרתי MCP מרוחקים ב-Streamable HTTP עם כותרת מותאמת עובד עם הכתובת והכותרת שלמעלה; לקוחות שמדברים רק HTTP+SSE הישן יכולים להשתמש ב-mcp-remote. או ישירות:
curl -s https://api.viewstream.co.il/mcp \
-H "Authorization: Bearer $VS_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-06-18" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
„מה משודר עכשיו בכל הערוצים, ויש בעיה באחד הפידים?”
„תמצא את התוכניות מהשבוע שעבר שבהן דיברו על הריבית, ותפתח כל אחת ברגע שבו זה נאמר.”
„תסכם את מהדורת 20:00 של אתמול ותגיד מי הגיש אותה.”
„תביא לי את הכתוביות בעברית של התוכנית הזאת כתמלול.”
„תחתוך קליפ מחמש הדקות הראשונות של מהדורת 20:00.”
„אילו סרטונים נצפו הכי הרבה אתמול לעומת שלשום? יש התראות פעילות?”
הסוכן רואה רק את הכלים שהמפתח שלו מורשה להם: tools/list מסונן לפי הרשאות.
list_channels, channel_status, get_epg — ערוצים, מה משודר, תקינות הפיד וההקלטה, לוח השידורים (channels:read)search_catchup, get_programme — חיפוש בתוכניות שהוקלטו לפי כותרת, טקסט הלוח, סיכום AI, מגישים, נושאים ומה שנאמר, עם הרגעים (channels:read)search_library, get_asset — סרטוני הספרייה (assets:read)get_subtitles, get_summary — תמלולים או WebVTT, סיכום ה-AI בעברית, מגישים ונושאים (assets:read)stats_overview, stats_top — קהל ואיכות צפייה (stats:read)list_alerts, service_status — ניטור ותקינות השירות (channels:read או stats:read)search_docs — מדריך Studio, מדריך המפתחים ותיעוד ה-API, בעברית ובאנגלית (כל מפתח)create_clip — חיתוך קליפ (עד 6 שעות) מהקלטת ערוץ (clips:write)create_support_request — פתיחת פנייה לתמיכה של אינטרהוסט (support:write)regenerate_summary — סיכום AI חדש מהכתוביות בעברית (assets:write)viewstream://docs/{en|he}/{topic}, viewstream://openapi, viewstream://openapi/{operationId}daily_report (דוח הצפייה של אתמול), find_programmeכל כלי קורא ל-API הציבורי /v1 בשם המפתח שלכם: רק הנתונים של הארגון שלכם, רק מה שהרשאות המפתח מאפשרות, עם אותן בדיקות כמו קריאה ישירה.
כל הפעלת כלי נרשמת ביומן הביקורת כ-mcp.tool_call, עם שם הכלי ותקציר הפרמטרים. טקסטים ארוכים נשמרים רק כאורכם.
20 בקשות בשנייה לכל מפתח (פרץ של עד 100), כמו ה-REST API. מבטלים את המפתח ב-Studio והסוכן נעצר מיד.
פעולות מפעיל (מנהלי אינטרהוסט) אינן זמינות דרך MCP, ועוגיית התחברות ל-Studio לא מתקבלת ב-/mcp.
המדריכים מתפרסמים כ-Markdown פשוט, כך שסוכן יכול לקרוא אותם ישירות.
כל פעולה, שדה והרשאה (Swagger UI, עם תצוגה בעברית).
openapi.yaml · openapi.json · בעברית openapi.he.yaml · Sites Delivery openapi/sites-delivery.yaml
מפתחות API, הרשאות, הקריאה הראשונה.
דוגמאות curl: העלאה, חיפוש בצפייה חוזרת, טוקנים, קליפים, סטטיסטיקה, webhooks.
שגיאות, דפדוף, הגבלות קצב, idempotency, עבודות אסינכרוניות, אירועים.
כלים, הרשאות, חיבור לקוחות, JSON-RPC ישיר, שגיאות.
קישורי שיתוף, iframe, תגית נגן, תצורות, אירועים.
ה-API הציבורי לקריאה עבור ממשק משלכם.
@viewstream/next, תגיות מטמון, נתיב ה-webhook, העלאות.
הורדה והתקנה: פוסטים אוטומטיים, בלוק הווידאו, התחברות, העלאות.
נקודות פתיחה מוכנות להעתקה לכל אינטגרציה.
/llms.txt — האינדקס למודלי שפה/llms-full.txt — מדריכי המפתחים כקובץ טקסט אחד (אנגלית)/.well-known/viewstream-agent.json — מניפסט הסוכן: נקודת ה-MCP, ה-API, התיעוד ויצירת קשרמשתמשים מחוברים ל-Studio מוצאים את אותם מדריכים גם במרכז העזרה (עזרה ← API למפתחים), בעברית ובאנגלית.
ספרו לנו מה אתם רוצים שהוא יעשה. אנחנו עוזרים ללקוחות ולסוכנויות שלהם להגדיר מפתחות, הרשאות ותהליכי עבודה ראשונים.