Перейти до вмісту
Працює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?

Відкритий стандарт, що дає ШІ-асистентам змогу користуватися зовнішніми інструментами. Коли асистент не може виконати завдання сам, він викликає потрібний інструмент на підключеному сервері й приносить тобі результат. 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), обери Register automatically
  3. Увійди через fcaai

    Відкриється екран fcaai. Обери обліковий запис (особистий або командний), встанови місячний ліміт і натисни «Дозволити». Якщо ввімкнено двоетапну перевірку, введи код.
  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
Редагування з референсомЧерез 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
МузикаСтвори 30-секундний інструментальний 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 можуть завантажити локальний файл через fcaai CLI й використати посилання, яке він виведе:

Термінал
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 у твоєму браузері. Попроси ІТ-відділ дозволити обидві адреси.

Запитання

Чи коштує MCP додатково?

Ні. Ти платиш лише за запущені генерації — за цінами API в доларах США. Перелік, розрахунок ціни й перевірка статусу безкоштовні.

Чи працює мій безлімітний план через MCP?

Ні. API, MCP-сервер і плагіни завжди використовують твій баланс. Безлімітне використання охоплює Studio, Canvas і шаблони на сайті та в застосунку.

Чи може асистент почати дороге завдання без запиту?

ChatGPT і Claude можуть питати тебе перед запуском інструмента, а сервер наказує асистентові називати ціну перед відео- та 4K-завданнями. Справжній запобіжник — місячний ліміт, який ти встановлюєш під час підключення (або ліміт витрат ключа): щойно його досягнуто, нові завдання не починаються.

Де зберігаються результати?

У твоїй бібліотеці fcaai, як і все, що ти створюєш у Studio. Асистент дає посилання, а Claude Code, Codex та інші термінальні інструменти можуть зберегти файл просто у твою теку.

Вхід чи ключ API: що обрати?

Входь, коли застосунок це пропонує: не треба копіювати ключ, ти обираєш обліковий запис і місячний ліміт, а прибрати застосунок можна одним кліком. Ключ API використовуй для скриптів, CI та середовищ, де ніхто не може ввійти через браузер.

Хто може користуватися MCP-сервером?

Будь-який обліковий запис fcaai — особистий чи командний. Запуски оплачуються з балансу цього облікового запису за цінами API, незалежно від плану.

Що буде, якщо запуск не вдасться?

Зарезервована сума повертається автоматично. Якщо звичний маршрут моделі не спрацьовує, ми повторюємо спробу запасним маршрутом за тією самою ціною.