דילוג לתוכן

MCP

שרת MCP

שרת ה-MCP נותן ל־Claude Code ול־Cursor גישה לכלי WTFLOW. אפשר להתחבר דרך החשבון באתר או עם מפתח API.
https://www.wtflow-studio.com/mcp

אפשר לחבר את הכתובת ישירות ל־Claude Code או ל־Cursor. חלון התחברות ל־WTFLOW ייפתח כדי לאשר גישה לחשבון.

claude mcp add --transport http --scope user wtflow https://www.wtflow-studio.com/mcp
~/.cursor/mcp.json
{
  "mcpServers": {
    "wtflow": {
      "url": "https://www.wtflow-studio.com/mcp"
    }
  }
}

לחיבור עם מפתח קבוע, יוצרים מפתח בעמוד מפתחות API. מיד אחרי היצירה תקבלו פקודה ל-Claude Code והגדרה ל-Cursor עם המפתח שלכם.

Claude Code#

claude mcp add --transport http --scope user wtflow https://www.wtflow-studio.com/mcp \
  --header "Authorization: Bearer wtf_live_…"

בודקים עם /mcp בתוך Claude Code שהשרת מחובר, ואז מבקשים במילים רגילות, למשל:

Create a WTFLOW project for https://brightdesk.example, a 30-second English product video. Run the research and show me the directions.

Claude Desktop#

Claude Desktop מפעיל שרתים מקומיים מקובץ ההגדרות שלו, ולכן מגיעים לשרת המרוחק דרך mcp-remote. פותחים Settings, אחר כך Developer ו-Edit Config, מדביקים ומפעילים מחדש את Claude Desktop.

claude_desktop_config.json
{
  "mcpServers": {
    "wtflow": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.wtflow-studio.com/mcp",
        "--header",
        "Authorization:${WTFLOW_AUTH}"
      ],
      "env": {
        "WTFLOW_AUTH": "Bearer wtf_live_…"
      }
    }
  }
}

Cursor, VS Code ולקוחות אחרים#

.cursor/mcp.json · .vscode/mcp.json
{
  "mcpServers": {
    "wtflow": {
      "url": "https://www.wtflow-studio.com/mcp",
      "headers": {
        "Authorization": "Bearer wtf_live_…"
      }
    }
  }
}

כל לקוח שתומך ב-Streamable HTTP ובכותרות מותאמות יכול להתחבר עם הכתובת והכותרת Authorization.

פנייה ישירה#

JSON-RPC 2.0 ב-POST, והתשובה היא application/json. אין סשנים ואין זרם אירועים: כל בקשה נושאת את המפתח. הודעה בלי id (למשל notifications/initialized) מקבלת 202 בלי גוף, ו-GET מקבל 405.

curl -X POST "https://www.wtflow-studio.com/mcp" \
  -H "Authorization: Bearer $WTFLOW_API_KEY" \
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'

curl -X POST "https://www.wtflow-studio.com/mcp" -H "Authorization: Bearer $WTFLOW_API_KEY" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

curl -X POST "https://www.wtflow-studio.com/mcp" -H "Authorization: Bearer $WTFLOW_API_KEY" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"list_projects","arguments":{"limit":5}}}'

גרסת הפרוטוקול: 2025-06-18 (לקוח שמבקש 2025-03-26 או 2024-11-05 מקבל את הגרסה שביקש).

הכלים (27)#

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

  • get_balanceקריאה בלבד

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

    כמו getMe ב-API

  • list_projectsקריאה בלבד

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

    כמו listProjects ב-API

  • create_project

    יצירת פרויקט מבריף (כתובת אתר, תיאור או שניהם). חינם אלא אם runResearch הוא true. הצעד הבא: run_research.

    כמו createProject ב-API

  • get_projectקריאה בלבד

    הפרויקט כולו, כולל next שאומר מה הכלי הבא. משתמשים בו כדי לבדוק התקדמות בזמן ש-status.busy הוא true.

    כמו getProject ב-API

  • run_researchעולה קרדיטים

    קריאת האתר וכתיבת הבריף העסקי. עולה קרדיטים ורץ ברקע.

    כמו startResearch ב-API

  • update_research

    עריכת שדות בבריף לפני האישור.

    כמו updateResearch ב-API

  • approve_researchעולה קרדיטים

    אישור הבריף. המודל כותב כיוונים קריאייטיביים. עולה קרדיטים.

    כמו approveResearch ב-API

  • list_directionsקריאה בלבד

    הכיוונים לבחירה, והכיוון שנבחר.

    כמו listDirections ב-API

  • choose_directionעולה קרדיטים

    בחירת כיוון לפי מזהה. המודל כותב את התסריט. עולה קרדיטים.

    כמו chooseDirection ב-API

  • get_scriptקריאה בלבד

    התסריט סצנה אחר סצנה, והאם אושר.

    כמו getScript ב-API

  • update_script

    שמירת תסריט ערוך (שולחים את כל האובייקט).

    כמו updateScript ב-API

  • approve_scriptעולה קרדיטים

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

    כמו approveScript ב-API

  • get_compositionקריאה בלבד

    הסרטון הבנוי כ-JSON וקישור לעורך. ייצוא MP4 נעשה בעורך בדפדפן.

    כמו getComposition ב-API

  • send_messageעולה קרדיטים

    בקשת שינוי במילים, כמו בצ׳אט של הסטודיו. עולה קרדיטים.

    כמו sendMessage ב-API

  • list_messagesקריאה בלבד

    הצ׳אט של הפרויקט, כולל הצעות והמצב שלהן.

    כמו listMessages ב-API

  • apply_proposal

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

    כמו applyProposal ב-API

  • dismiss_proposal

    דחיית עריכה מוצעת.

    כמו dismissProposal ב-API

  • list_jobsקריאה בלבד

    עבודות ה-AI של הפרויקט, עם סטטוס, שגיאות וקרדיטים.

    כמו listJobs ב-API

  • list_assetsקריאה בלבד

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

    כמו listAssets ב-API

  • search_library

    חיפוש פריטים שקופים במאגר ג׳ני לייבוא לפרויקט.

    כמו searchLibrary ב-API

  • import_asset

    הורדת קובץ מכתובת ציבורית לספרייה.

    כמו importAsset ב-API

  • search_stockקריאה בלבד

    חיפוש מוזיקה או אפקטים בספריית הסטוק. חינם.

    כמו searchStock ב-API

  • list_skillsקריאה בלבד

    הסקילים בחשבון.

    כמו listSkills ב-API

  • create_skill

    הוספת סקיל: שם וכללים.

    כמו createSkill ב-API

  • import_skills_from_github

    גילוי סקילים במאגר GitHub ציבורי. חינם.

    כמו importSkillsFromGithub ב-API

  • learn_skillsעולה קרדיטים

    לימוד סקילים שנמצאו. עולה קרדיטים.

    כמו learnSkills ב-API

  • redeem_gift_code

    מימוש קוד מתנה.

    כמו redeemGiftCode ב-API

איך סוכן משתמש בזה#

  • כלי שעולה קרדיטים מתחיל עבודה ברקע. הסוכן קורא ל-get_project כל כמה שניות עד ש-status.busy הוא false, והשדה next אומר לו איזה כלי בא אחר כך.
  • עריכה: send_message, אחר כך list_messages עד שהתשובה כבר לא pending, ואז apply_proposal או dismiss_proposal.
  • כשכלי נכשל, התוצאה מסומנת isError: true והטקסט הוא אותו JSON של שגיאה שה-API מחזיר, כמו {"error":{"code":"insufficient_credits",…}}.
  • מגבלת הקצב זהה: 60 בקשות בדקה למפתח. פרטים