ViewStream
EN
מפתחים · סוכני AI

סוכן ה-AI שלכם, פלטפורמת הווידאו שלכם.

מספיק מפתח API אחד. Claude Code,‏ Cursor,‏ Claude Desktop או כל לקוח MCP יכולים לעבוד בשפה רגילה עם הערוצים, הצפייה החוזרת, הספרייה, הכתוביות, סיכומי ה-AI, הקליפים והסטטיסטיקות שלכם ב-ViewStream, דרך שרת ה-MCP של ViewStream או ה-REST API. כל מה שהסוכן עושה עובר דרך אותו API, אותן הרשאות ואותו יומן ביקורת כמו Studio.

איך זה עובד

שלושה צעדים, בערך שתי דקות.

1. יוצרים מפתח API אחד

ב-Studio: אינטגרציות ← מפתחות API ← יצירת מפתח (תפקיד מהנדס ומעלה). תנו למפתח רק את ההרשאות שהסוכן צריך: לסוכן לקריאה בלבד מספיקות channels:read,‏ assets:read ו-stats:read. המפתח מוצג פעם אחת, ומבטלים אותו באותו מסך.

2. מחברים את הסוכן

ל-ViewStream יש שרת MCP מרוחק בכתובת https://api.viewstream.co.il/mcp. אין מה להתקין: מוסיפים את הכתובת ואת המפתח ל-Claude Code,‏ Cursor,‏ Claude Desktop או לכל לקוח MCP.

3. מבקשים מה שצריך

„מה משודר עכשיו בכל הערוצים?” הסוכן בוחר את הכלים הנכונים, מפעיל אותם עם המפתח שלכם ועונה בשפה שלכם, כולל כותרות וכתוביות בעברית.

אין לכם עדיין חשבון ViewStream? פתחו חשבון חינמי בדקה: תוכנית חינמית ללא הגבלת זמן וללא כרטיס אשראי (ספריית וידאו, נגן, וורדפרס / Next.js, סיכומי AI). לצרכים גדולים יותר, ערוצים חיים או הסכם מותאם: כתבו ל-[email protected] או השתמשו בטופס יצירת הקשר.

חיבור הסוכן

מוכן בתוך שתי דקות.

החליפו את <key> במפתח ה-API שלכם (vs_…). השרת מדבר MCP Streamable HTTP ומזהה לפי Authorization: Bearer <key>.

Claude Code

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

בקובץ ~/.cursor/mcp.json (לכל הפרויקטים) או .cursor/mcp.json (לפרויקט אחד; אל תכניסו את המפתח ל-git):

{
  "mcpServers": {
    "viewstream": {
      "url": "https://api.viewstream.co.il/mcp",
      "headers": { "Authorization": "Bearer <key>" }
    }
  }
}

Claude Desktop

מחברים מותאמים אישית מתחברים עם 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>" }
    }
  }
}

לקוחות אחרים, או JSON-RPC ישיר

כל לקוח שתומך בשרתי 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.”

„אילו סרטונים נצפו הכי הרבה אתמול לעומת שלשום? יש התראות פעילות?”

מה הסוכן יכול לעשות

17 כלים, כל אחד מאחורי הרשאה.

הסוכן רואה רק את הכלים שהמפתח שלו מורשה להם: 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

כל כלי קורא ל-API הציבורי /v1 בשם המפתח שלכם: רק הנתונים של הארגון שלכם, רק מה שהרשאות המפתח מאפשרות, עם אותן בדיקות כמו קריאה ישירה.

נרשם ביומן

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

מוגבל קצב וניתן לביטול

20 בקשות בשנייה לכל מפתח (פרץ של עד 100), כמו ה-REST API. מבטלים את המפתח ב-Studio והסוכן נעצר מיד.

פעולות מפעיל (מנהלי אינטרהוסט) אינן זמינות דרך MCP, ועוגיית התחברות ל-Studio לא מתקבלת ב-/mcp.

למודלי שפה וזחלנים

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

משתמשים מחוברים ל-Studio מוצאים את אותם מדריכים גם במרכז העזרה (עזרה ← API למפתחים), בעברית ובאנגלית.

בונים עם סוכן?

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