MCP
שרת MCP
https://www.wtflow-studio.com/mcpאפשר לחבר את הכתובת ישירות ל־Claude Code או ל־Cursor. חלון התחברות ל־WTFLOW ייפתח כדי לאשר גישה לחשבון.
claude mcp add --transport http --scope user wtflow https://www.wtflow-studio.com/mcp{
"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.
{
"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 ולקוחות אחרים#
{
"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 בקשות בדקה למפתח. פרטים