رفتن به محتوا
در حال اجرا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 · دلار آمریکا · بازگشت اعتبار اجراهای ناموفق

ChatGPT و Claude با ورود به حساب fcaai شما وصل می‌شوند و کلیدی برای کپی کردن لازم نیست. ابزارهای کدنویسی هم می‌توانند وارد شوند یا از کلید API استفاده کنند. هزینه کلیدهای آزمایشی (fcaai_test_) مانند کلیدهای اصلی محاسبه می‌شود. ساخت کلید

MCP چیست؟

استانداردی باز که به دستیارهای هوش مصنوعی امکان استفاده از ابزارهای بیرونی را می‌دهد. وقتی دستیار شما خودش نمی‌تواند کاری را انجام دهد، ابزار مناسب را روی یک سرور متصل صدا می‌زند و نتیجه را برایتان می‌آورد. fcaai ابزارها را فراهم می‌کند؛ شما فقط صحبت می‌کنید.

1 · شما
درخواست خود را بنویسید
«وضوح این رندر را به 4K برسان و اول بگو چقدر هزینه دارد.»
2 · دستیار شما
Claude · ChatGPT · Codex · Cursor
درخواست را می‌فهمد و تصمیم می‌گیرد به کدام ابزارهای fcaai نیاز دارد: estimate_price → generate
3 · سرور MCP fcaai
مدل را اجرا می‌کند و نتیجه را برمی‌گرداند
همان موجودی Studio. استعلام قیمت رایگان است و اعتبار کار ناموفق برمی‌گردد.
تصویر · افزایش وضوحویدیوگفتار · موسیقی3D

به چه کاری می‌آید؟

بدون عوض کردن تب، از داخل گفتگو بسازید. بیشترین تفاوت را در کارهای تکراری و چندمرحله‌ای ایجاد می‌کند.

  • پیش از کارهای پرهزینه می‌پرسد. سرور به دستیار می‌گوید پیش از کارهای ویدیویی و 4K قیمت را اعلام کند.
  • همه مدل‌ها، همه تنظیمات. گزینه‌هایی مثل نسبت تصویر، مدت، وضوح و صدا از فهرست خود هر مدل می‌آیند.
  • Canvas شما به یک ابزار تبدیل می‌شود. بوردهایی که منتشر می‌کنید با یک فراخوانی به‌عنوان Flow اجرا می‌شوند.
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 باز می‌شود. حساب (شخصی یا تیمی) را انتخاب کنید، سقف ماهانه را تعیین کنید و «اجازه» را بزنید. اگر تأیید دومرحله‌ای فعال است، کدتان را وارد کنید.
  4. در یک چت روشنش کنید

    در کادر پیام، این را باز کنید + › Connectors و fcaai را روشن کنید. Claude ممکن است پیش از اجرای یک ابزار بپرسد: Allow once یا Always allow را انتخاب کنید.

در Team یا Enterprise، یک Owner می‌تواند fcaai را برای همه اضافه کند در Organization settings › Connectors › Add › Custom › Web. سپس هر عضو در Customize › Connectors گزینه Connect را می‌زند و با حساب fcaai خودش وارد می‌شود.

پس از اتصال، fcaai در برنامه موبایل Claude هم کار می‌کند، و در Claude Code هم وقتی با همان حساب Claude وارد شوید.

نشانی سرور
https://api.fcaai.ai/mcp
وقتی کار می‌کند

fcaai زیر Your connectors با وضعیت Connected فهرست شده است.

امتحانش کنید
از fcaai استفاده کن: مدل‌های تصویر و قیمت‌هایشان را فهرست کن.

فهرست کردن مدل‌ها رایگان است، پس این آزمایش هزینه‌ای ندارد.

قدم‌های اول

با دستیارتان همان‌طور حرف بزنید که کاری را به یک نفر توضیح می‌دهید. بار اول نام fcaai را بیاورید تا سراغ ابزارهای درست برود.

نمونه پرامپت‌ها

ساخت تصویربا fcaai دو تصویر 16:9 از یک ویلای شیشه‌ای روی تپه‌ای پر از کاج در ساعت آبی بساز. اول قیمت را بگو.
estimate_pricegenerate_image
ویرایش با مرجعبا 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 سی‌ثانیه‌ای برای ویدیوی محصول بساز.
generate_music
قالب‌هاکدام قالب‌های fcaai پلان را به رندر تبدیل می‌کنند؟ بهترینش را روی https://example.com/plan.png اجرا کن.
list_templatesrun_template
اول قیمتیک ویدیوی 10 ثانیه‌ای 1080p با صدا در fcaai چقدر هزینه دارد؟ اجرایش نکن.
get_modelestimate_price
هزینه‌هااین ماه چقدر در fcaai خرج کرده‌ام و روی کدام مدل‌ها؟ موجودی‌ام چقدر است؟
account_usageaccount_balance

تصویرتان را به دستیار بدهید

ابزارهای fcaai پیوند می‌گیرند، نه فایل پیوست. هر کدام از این‌ها کار می‌کند:

پیوند را بچسبانید

یک پیوند https عمومی به فایل تصویر، ویدیو یا صدا (تا 50 مگابایت). دستیار مستقیم از آن استفاده می‌کند یا اول آن را به 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 نمی‌رسند. دستیار آن‌ها را می‌بیند، اما نمی‌تواند فایل را به ابزار بدهد. به‌جایش پیوند بفرستید.

پیوندها باید عمومی باشند. آدرس‌های شبکه‌های خصوصی یا صفحه‌هایی که ورود می‌خواهند پذیرفته نمی‌شوند.

کارهای طولانی: ویدیو و سه‌بعدی

تولیدها در پس‌زمینه اجرا می‌شوند. دستیار با 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 از موجودی همان حساب پرداخت می‌شود؛ طرحتان هر چه باشد.

اگر اجرا ناموفق شود چه می‌شود؟

مبلغ رزروشده خودکار برمی‌گردد. اگر مسیر معمول یک مدل ناموفق شود، با همان قیمت از مسیر پشتیبان دوباره تلاش می‌کنیم.