דילוג לתוכן
רץStreamable HTTP · OAuth 2.1

תיעוד MCP

פשוט אומרים מה רוצים. העוזר שלך בוחר את הכלי המתאים, מציג את המחיר ומחזיר את התוצאה.

כתובת השרתhttps://api.fcaai.ai/mcp
אימות
התחברות עם fcaai (OAuth) או מפתח API OAuth 2.1 (PKCE) · Bearer fcaai_live_…
הרשאה נדרשת
generations:write
פרוטוקול
2025-11-25 · 2025-06-18 · 2025-03-26 · 2024-11-05
מחיר
מחירי API · USD · הרצות שנכשלו מוחזרות

ChatGPT ו-Claude מתחברים דרך התחברות עם חשבון fcaai שלך, בלי מפתח להעתיק. גם כלי קוד יכולים להתחבר כך, או להשתמש במפתח API. מפתחות בדיקה (fcaai_test_) מחויבים כמו מפתחות רגילים. יצירת מפתח

מה זה MCP?

תקן פתוח שמאפשר לעוזרי AI להשתמש בכלים חיצוניים. כשהעוזר לא יכול לבצע משימה בעצמו, הוא קורא לכלי המתאים בשרת מחובר ומחזיר את התוצאה. fcaai מספק את הכלים; רק צריך לדבר.

1 · אתם
כתיבת הבקשה
„להגדיל את הרינדור הזה ל-4K, וקודם לומר לי כמה זה עולה.”
2 · העוזר שלך
Claude · ChatGPT · Codex · Cursor
מבין את הבקשה ומחליט באילו כלי fcaai הוא צריך: estimate_price → generate
3 · שרת MCP של fcaai
מריץ את המודל ומחזיר את התוצאה
אותה יתרה כמו ב-Studio. הצעת מחיר היא בחינם, ומשימה שנכשלה מוחזרת.
תמונה · הגדלהוידאוקול · מוזיקה3D

למה זה טוב?

יצירה מתוך השיחה בלי לעבור בין לשוניות. ההבדל הגדול ביותר מורגש בעבודה חוזרת ורב-שלבית.

  • שואל לפני משימות יקרות. השרת מורה לעוזר לציין את המחיר לפני משימות וידאו ו-4K.
  • כל מודל, כל הגדרה. אפשרויות כמו יחס תמונה, משך, רזולוציה ואודיו מגיעות מהרשימה של כל מודל.
  • ה-Canvas שלך הופך לכלי. לוחות שמפרסמים רצים כזרימה בקריאה אחת.
Claudefcaai מחוברשיחה לדוגמה
להגדיל את הרינדור הזה ל-4K, אבל קודם לומר לי כמה זה עולה: studio.example.com/villa-blue-hour.jpg
upload_from_urlurl: …/villa-blue-hour.jpg/u/…
estimate_pricemodel: fca/upscale · tier: 2x · source 1920×1080$0.008
הגדלה פי 2 נותנת 3840×2160 בכ-$0.008. מתחילים עכשיו.
generatemodel: fca/upscale · image: /u/… · tier: 2xqueued
get_generationwait_seconds: 50succeeded
villa-blue-hour_4k.png
3840×2160 · fca/upscale · $0.008

הגדרה לעוזר שלך

בוחרים אפליקציה. כל מדריך נבדק מול התיעוד הרשמי של אותה אפליקציה. ChatGPT ו-Claude מתחברים עם חשבון fcaai שלך; גם כלי קוד יכולים להתחבר כך, או להשתמש במפתח API.

Claude · claude.ai, מחשב, מוביילעובד · התחברות עם fcaai

Claude מתחבר עם חשבון fcaai שלך, בלי מפתח API להעתיק. מחברים מותאמים אישית עובדים במסלולי Free, Pro, Max, Team ו-Enterprise; ב-Free אפשר להוסיף אחד.

  1. פתיחת המחברים

    ב-claude.ai או באפליקציית Claude למחשב, יש לעבור אל Customize › Connectors › Add custom connector
  2. הזנת הכתובת

    שם fcaai · URL https://api.fcaai.ai/mcpאם החלון שואל איך Claude מזהה את עצמו (OAuth client), יש לבחור Register automatically
  3. התחברות עם fcaai

    מסך fcaai נפתח. בוחרים חשבון (אישי או צוות), מגדירים מגבלה חודשית ובוחרים Allow. אם אימות דו-שלבי מופעל, יש להזין את הקוד.
  4. הפעלה בצ׳אט

    בתיבת ההודעה, פותחים את + › Connectors ומפעילים את fcaai. Claude יכול לשאול לפני שכלי רץ: בוחרים Allow once או Always allow.

ב-Team או ב-Enterprise, משתמש Owner מוסיף את fcaai לכולם ב- Organization settings › Connectors › Add › Custom › Web. לאחר מכן כל חבר צוות בוחר Connect ב-Customize › Connectors ומתחבר עם חשבון fcaai משלו.

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

כתובת השרת
https://api.fcaai.ai/mcp
כשזה עובד

fcaai מופיע תחת Your connectors כ-Connected.

בדיקה
להשתמש ב-fcaai: להציג את מודלי התמונה ואת המחירים שלהם.

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

צעדים ראשונים

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

דוגמאות לפרומפטים

יצירת תמונותהשתמש ב-fcaai כדי ליצור שתי תמונות 16:9 של וילת זכוכית על רכס אורנים בשעה הכחולה. תגיד לי קודם את המחיר.
estimate_pricegenerate_image
עריכה עם תמונת ייחוסעצב מחדש את הסלון שלי בסגנון Japandi עם fcaai ושמור על החלונות ועל הפריסה: https://example.com/room.jpg
upload_from_urlgenerate_image
תמונה לווידאוצור וידאו של 5 שניות שמתחיל ב-https://example.com/day.jpg ומסתיים ב-https://example.com/night.jpg. תן לי הצעת מחיר לפני שאתה מתחיל.
get_modelestimate_pricegenerate
הגדלההגדל את הרינדור האחרון שלי ב-fcaai ל-4K.
list_generationsgenerate
קריינותהצג לי את הקולות של fcaai, ואז הקרא את הפסקה הזו בקול רגוע וחם.
list_voicesgenerate_speech
מוזיקהצור רצועת lo-fi אינסטרומנטלית של 30 שניות לסרטון מוצר.
generate_music
תבניותאילו תבניות של fcaai הופכות תוכנית קומה לרינדור? הרץ את הטובה ביותר על https://example.com/plan.png.
list_templatesrun_template
קודם המחירכמה יעלה ב-fcaai וידאו של 10 שניות ב-1080p עם סאונד? אל תריץ אותו.
get_modelestimate_price
הוצאותכמה הוצאתי על fcaai החודש, ועל אילו מודלים? מה היתרה שלי?
account_usageaccount_balance

איך מעבירים לעוזר תמונה

הכלים של fcaai מקבלים קישורים, לא קבצים מצורפים. כל אחת מהדרכים האלה עובדת:

הדבקת קישור

קישור https ציבורי לקובץ תמונה, וידאו או אודיו (עד 50 MB). העוזר משתמש בו ישירות, או מעתיק אותו קודם ל-fcaai באמצעות upload_from_url

שימוש במשהו שנוצר ב-fcaai

לתוצאות יש קישורים כמו https://fcaai.ai/o/…. אפשר גם פשוט לכתוב “השתמש ברינדור האחרון שלי”, והעוזר ימצא אותו באמצעות list_generations

מהטרמינל

Claude Code, Codex ו-Gemini CLI יכולים להעלות קובץ מקומי עם ה-CLI של fcaai ולהשתמש בקישור שהוא מדפיס:

טרמינל
npm install -g @fcaai/cli
fcaai login
fcaai upload ./photo.jpg   # prints a link to pass to the assistant
תמונות שמצורפות בצ'אט של ChatGPT או Claude לא מועברות ל-fcaai. העוזר יכול לראות אותן, אבל לא יכול להעביר את הקובץ לכלי. במקום זאת יש לשתף קישור.

הקישורים חייבים להיות ציבוריים. כתובות ברשתות פרטיות או דפים שדורשים התחברות נדחים.

משימות ארוכות: וידאו ו-3D

היצירות רצות ברקע. העוזר ממתין עם get_generation (עד 50 שניות בכל בדיקה) ובודק שוב עד שהתוצאה מוכנה. אם הצ'אט מסתיים קודם, המשימה עדיין מסתיימת ונשמרת בספרייה שלך. אפשר לשאול אחר כך: “הצג את היצירות האחרונות שלי ב-fcaai”.

לאן התוצאות הולכות

כל תוצאה נשמרת בספריית fcaai שלך עם קישור הורדה. עוזרים בטרמינל יכולים גם לשמור את הקובץ ישירות בתיקיית הפרויקט שלך.

חיבורים והוצאות

ההחלטה איזה חשבון אפליקציה משתמשת בו וכמה היא רשאית להוציא היא שלך, ואפשר לשנות אותה בכל עת.

מגבלה חודשית לכל אפליקציה

במסך ההתחברות של fcaai קובעים מגבלה חודשית לאותה אפליקציה ($10, $25 או $100) או ללא מגבלה. כשהיא מושגת, משימות חדשות נעצרות עד החודש הבא (UTC). כדי לשנות אותה, יש להסיר את הגישה ולהתחבר מחדש. key_spend_cap_reached

אישי או צוות

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

אימות דו-שלבי

אם האפשרות מופעלת, מסך ההתחברות מבקש את קוד המאמת (או קוד גיבוי) לפני מתן הגישה.

הסרת גישה

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

הישארות מחובר

אפליקציות מחדשות את הגישה שלהן בעצמן. אם אפליקציה לא בשימוש במשך 90 יום, או שהוסרה, היא תבקש להתחבר שוב.

מפתחות API לכלי קוד

מומלץ לתת לכל כלי מפתח משלו, רק עם המשימות שהוא צריך ועם תקרת הוצאה חודשית. כך אפשר לבטל מפתח אחד בלי לגעת באחרים.

ניהול מפתחות

כלים

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

5 כלים
list_modelsמודלים לפי סוג, עם המחיר להגדרות שלךחינם
get_modelמודל אחד עם כל האפשרויות שהוא מקבל (ערכים מותרים, טווחים, ברירות מחדל)חינם
estimate_priceמחיר מדויק לפני שמשהו רץחינם
account_balanceיתרה והוצאות המפתח הזה החודשחינם
account_usageהוצאות לפי יום ומודל לטווח תאריכיםחינם

הגדרות מפתח API

לכלים שמתחברים עם מפתח. מומלץ מפתח נפרד לכל כלי.

הרשאות

מפתח יכול לבצע רק את סוגי המשימות שנבחרו. אם לא נבחר דבר, כל סוגי היצירה מותרים: generations:image · video · audio · 3d · upscale · llm

תקרת הוצאה חודשית

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

קצב ומקביליות

כברירת מחדל 120 בקשות לדקה ו-2 משימות במקביל. אפשר להוסיף רשימת IP מורשים ותאריך תפוגה.

קלטים בטוחים

כתובות שהעוזר מעביר חייבות להיות קישורי https ציבוריים; רשתות פנימיות וכתובות פרטיות נדחות.

מפתח חדשדוגמה למסך החשבון
שם
Claude Code · מחשב נייד
מצב
משימות מותרות
יצירת מפתח

המפתח מוצג פעם אחת בלבד ונשמר רק כגיבוב SHA-256.

פתרון בעיות

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

התבקשת להתחבר שוב401 · invalid_token

הגישה של האפליקציה פגה או הוסרה. יש להתחבר מחדש: ב-Claude לבחור Reconnect במחבר, ב-Claude Code להריץ /mcp, ובכל מקום אחר להסיר את fcaai ולהוסיף אותו שוב.

הגעת למגבלה החודשיתkey_spend_cap_reached

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

אין מספיק יתרה402 · insufficient_balance

יש לטעון את היתרה ולבקש מהעוזר לנסות שוב. לא בוצע חיוב.

טעינה
המודל לא זמיןmodel_unavailable

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

הגדרה נשמטהignored_fields

ההרצה בוצעה, ו-ignored_fields מפרט כל הגדרה שהמודל לא מקבל, עם הסיבה. אפשר לבקש מהעוזר לבדוק ב-get_model מה המודל מקבל.

ערך נדחהinvalid_<field> · invalid_arguments

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

כלי fcaai לא מופיעים

יש לוודא שהכתובת מסתיימת ב-/mcp. לאחר מכן לרענן: ב-ChatGPT, Refresh בדף Plugins; ב-Claude, להפעיל את fcaai תחת + › Connectors; ב-Cursor, להפעיל אותו ב-Customize; ב-VS Code, Restart Server. עדיין כלום? יש להסיר את fcaai ולהוסיף אותו שוב.

יותר מדי בקשותrate_limited

כברירת מחדל 120 בקשות לדקה לכל חיבור, ולחלק מהכלים יש מגבלה משלהם לדקה. יש להמתין דקה ולנסות שוב.

חסום ברשת של מקום עבודה

אפליקציות במחשב שלך (Claude Code, Codex, Cursor, VS Code…) צריכות גישת HTTPS ל-api.fcaai.ai, וההתחברות פותחת את fcaai.ai בדפדפן. יש לבקש ממחלקת ה-IT לאשר את שניהם.

שאלות

האם השימוש ב-MCP עולה תוספת?

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

האם המסלול הבלתי מוגבל שלי עובד דרך MCP?

לא. ה-API, שרת ה-MCP והתוספים תמיד משתמשים ביתרה שלך. השימוש הבלתי מוגבל חל על Studio, Canvas ותבניות באתר ובאפליקציה.

האם העוזר יכול להתחיל עבודה יקרה בלי לשאול?

ChatGPT ו-Claude יכולים לשאול אותך לפני שכלי רץ, והשרת מורה לעוזר לציין את המחיר לפני עבודות וידאו ו-4K. ההגנה האמיתית שלך היא המגבלה החודשית שנקבעת בזמן החיבור (או תקרת ההוצאה של המפתח): כשמגיעים אליה, שום עבודה חדשה לא מתחילה.

איפה נשמרים הפלטים?

בספריית fcaai שלך, כמו כל מה שיוצרים ב-Studio. העוזר נותן לך את הקישור, ו-Claude Code, Codex וכלי טרמינל אחרים יכולים לשמור את הקובץ ישירות בתיקייה שלך.

התחברות או מפתח API: במה להשתמש?

כשהאפליקציה מציעה התחברות, עדיף להתחבר: אין מפתח להעתיק, בוחרים את החשבון ומגבלה חודשית, ואפשר להסיר את האפליקציה בלחיצה אחת. מפתח API מתאים לסקריפטים, ל-CI ולסביבות שבהן אף אחד לא יכול להתחבר דרך דפדפן.

מי יכול להשתמש בשרת ה-MCP?

כל חשבון fcaai, אישי או צוותי. ההרצות משולמות מהיתרה של אותו חשבון לפי מחירי API, בלי קשר למסלול.

מה קורה אם הרצה נכשלת?

הסכום ששוריין חוזר אוטומטית. אם המסלול הרגיל של מודל נכשל, אנחנו מנסים שוב במסלול גיבוי באותו מחיר.