Přejít na obsah
BěžíStreamable HTTP · OAuth 2.1

Dokumentace MCP

Prostě řekni, co chceš. Tvůj asistent vybere správný nástroj, řekne ti cenu a přinese výsledek.

Adresa serveruhttps://api.fcaai.ai/mcp
Ověření
Přihlášení přes fcaai (OAuth) nebo API klíč OAuth 2.1 (PKCE) · Bearer fcaai_live_…
Požadovaný rozsah
generations:write
Protokol
2025-11-25 · 2025-06-18 · 2025-03-26 · 2024-11-05
Cena
Ceny API · USD · neúspěšná spuštění se vracejí

ChatGPT a Claude se připojují přihlášením tvým účtem fcaai, bez kopírování klíče. Nástroje pro kód se mohou také přihlásit, nebo použít API klíč. Testovací klíče (fcaai_test_) se účtují stejně jako ostré. Vytvořit klíč

Co je MCP?

Otevřený standard, který AI asistentům umožňuje používat vnější nástroje. Když tvůj asistent úkol sám nezvládne, zavolá správný nástroj na připojeném serveru a přinese ti výsledek. fcaai dodává nástroje; ty jen mluvíš.

1 · Ty
Napiš svůj požadavek
„Zvětši tento render na 4K a nejdřív mi řekni, kolik to stojí.“
2 · Tvůj asistent
Claude · ChatGPT · Codex · Cursor
Pochopí požadavek a rozhodne, které nástroje fcaai potřebuje: estimate_price → generate
3 · MCP server fcaai
Spustí model, vrátí výsledek
Stejný zůstatek jako ve Studiu. Cenový odhad je zdarma a neúspěšná úloha se vrací.
Obrázek · zvětšeníVideoHlas · hudba3D

K čemu je to dobré?

Tvoř přímo z konverzace bez přepínání karet. Největší rozdíl udělá u opakující se, vícekrokové práce.

  • Před drahými úlohami se zeptá. Server asistentovi říká, aby před video a 4K úlohami uvedl cenu.
  • Každý model, každé nastavení. Volby jako poměr stran, délka, rozlišení a zvuk pocházejí z vlastního seznamu každého modelu.
  • Tvůj Canvas se stane nástrojem. Tabule, které publikuješ, běží jako Flow jediným voláním.
Claudefcaai připojenoUkázková konverzace
Zvětši tento render na 4K, ale nejdřív mi řekni, kolik to stojí: 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
Zvětšení 2× dá 3840×2160 zhruba za $0.008. Začínám.
generatemodel: fca/upscale · image: /u/… · tier: 2xqueued
get_generationwait_seconds: 50succeeded
villa-blue-hour_4k.png
3840×2160 · fca/upscale · $0.008

Nastavení pro tvého asistenta

Vyber svou aplikaci. Každý návod byl ověřen podle oficiální dokumentace dané aplikace. ChatGPT a Claude se přihlašují tvým účtem fcaai; nástroje pro kód se mohou přihlásit také, nebo použít API klíč.

Claude · claude.ai, počítač, mobilFunguje · přihlášení přes fcaai

Claude se připojuje tvým účtem fcaai, bez kopírování API klíče. Vlastní konektory fungují v tarifech Free, Pro, Max, Team a Enterprise; ve Free můžeš přidat jeden.

  1. Otevři své konektory

    Na claude.ai nebo v desktopové aplikaci Claude přejdi do Customize › Connectors › Add custom connector
  2. Zadej adresu

    Jméno fcaai · URL https://api.fcaai.ai/mcpPokud se dialog zeptá, jak se Claude identifikuje (OAuth klient), zvol Register automatically
  3. Přihlášení přes fcaai

    Otevře se obrazovka fcaai. Vyber účet (osobní nebo týmový), nastav měsíční limit a zvol Povolit. Pokud máš zapnuté dvoufázové ověření, zadej kód.
  4. Zapni ho v chatu

    V poli pro zprávu otevři + › Connectors a zapni fcaai. Claude se může před spuštěním nástroje zeptat: zvol Allow once nebo Always allow.

V tarifu Team nebo Enterprise přidá Owner fcaai pro všechny v Organization settings › Connectors › Add › Custom › Web. Každý člen pak zvolí Connect v Customize › Connectors a přihlásí se vlastním účtem fcaai.

Po připojení funguje fcaai i v mobilní aplikaci Claude a v Claude Code, když se přihlásíš stejným účtem Claude.

Adresa serveru
https://api.fcaai.ai/mcp
Když to funguje

fcaai je uvedeno v Your connectors jako Connected.

Vyzkoušej
Použij fcaai: vypiš obrázkové modely a jejich ceny.

Výpis modelů je zdarma, takže tento test nic nestojí.

První kroky

Mluv se svým asistentem tak, jako bys zadával práci člověku. Napoprvé zmiň fcaai, aby sáhl po správných nástrojích.

Ukázkové prompty

Vytvořit obrázkyPomocí fcaai vytvoř dva obrázky 16:9 skleněné vily na hřebeni s borovicemi v modré hodině. Nejdřív mi řekni cenu.
estimate_pricegenerate_image
Úprava podle referencePřestyluj s fcaai můj obývák do stylu Japandi a zachovej okna i dispozici: https://example.com/room.jpg
upload_from_urlgenerate_image
Z obrázku videoVytvoř 5sekundové video, které začíná na https://example.com/day.jpg a končí na https://example.com/night.jpg. Než začneš, řekni mi cenu.
get_modelestimate_pricegenerate
ZvětšeníZvětši můj poslední render z fcaai na 4K.
list_generationsgenerate
VoiceoverUkaž mi hlasy fcaai a pak přečti tento odstavec klidným, vřelým hlasem.
list_voicesgenerate_speech
HudbaVytvoř 30sekundovou instrumentální lo-fi skladbu do produktového videa.
generate_music
ŠablonyKteré šablony fcaai udělají z půdorysu render? Spusť tu nejlepší na https://example.com/plan.png.
list_templatesrun_template
Nejdřív cenaKolik by na fcaai stálo 10sekundové video v 1080p se zvukem? Nespouštěj ho.
get_modelestimate_price
ÚtrataKolik jsem tento měsíc utratil na fcaai a za které modely? Jaký mám zůstatek?
account_usageaccount_balance

Dej asistentovi svůj obrázek

Nástroje fcaai přijímají odkazy, ne přílohy. Funguje cokoli z tohoto:

Vlož odkaz

Veřejný odkaz https na obrázek, video nebo zvukový soubor (max. 50 MB). Asistent ho použije přímo, nebo ho nejdřív zkopíruje do fcaai pomocí upload_from_url

Použij něco, co jsi vytvořil na fcaai

Výsledky mají odkazy jako https://fcaai.ai/o/…. Nebo prostě řekni „použij můj poslední render“ a asistent ho najde pomocí list_generations

Z terminálu

Claude Code, Codex a Gemini CLI umí nahrát lokální soubor pomocí fcaai CLI a použít odkaz, který vypíše:

Terminál
npm install -g @fcaai/cli
fcaai login
fcaai upload ./photo.jpg   # prints a link to pass to the assistant
Obrázky, které přiložíš v chatu ChatGPT nebo Claude, se do fcaai nepředávají. Asistent je vidí, ale nástroji soubor předat neumí. Sdílej místo toho odkaz.

Odkazy musí být veřejné. Adresy v soukromých sítích nebo stránky za přihlášením se odmítají.

Dlouhé úlohy: video a 3D

Generování běží na pozadí. Asistent čeká pomocí get_generation (až 50 sekund na jednu kontrolu) a kontroluje znovu, dokud není výsledek hotový. Když chat skončí dřív, úloha přesto doběhne a skončí ve tvé knihovně. Zeptej se později: „ukaž moje nejnovější generování na fcaai“.

Kam jdou výsledky

Každý výsledek se uloží do tvé knihovny fcaai s odkazem ke stažení. Termináloví asistenti umí soubor uložit i rovnou do složky projektu.

Připojení a útrata

Ty volíš, který účet aplikace používá a kolik smí utratit, a můžeš to kdykoli změnit.

Měsíční limit pro každou aplikaci

Na přihlašovací obrazovce fcaai nastavíš pro danou aplikaci měsíční limit ($10, $25 nebo $100), nebo žádný limit. Po jeho dosažení se nové úlohy zastaví do dalšího měsíce (UTC). Pro změnu odeber přístup a připoj se znovu. key_spend_cap_reached

Osobní, nebo týmový

Pokud tým vlastníš nebo spravuješ, můžeš aplikaci připojit k týmu. Její spuštění se pak platí z týmového zůstatku.

Dvoufázové ověření

Pokud je zapnuté, přihlašovací obrazovka si před povolením přístupu řekne o kód z ověřovací aplikace (nebo záložní kód).

Odebrat přístup

Účet › API klíče › Připojené aplikace vypisuje každou aplikaci, do které ses přihlásil, s jejím účtem a limitem. Odeber přístup a aplikace okamžitě přestane fungovat.

Trvalé přihlášení

Aplikace si přístup obnovují samy. Pokud se aplikace 90 dní nepoužívá, nebo ji odebereš, požádá tě o nové přihlášení.

API klíče pro nástroje pro kód

Dej každému nástroji vlastní klíč jen s úlohami, které potřebuje, a s měsíčním limitem útraty. Jeden zrušíš, aniž by ses dotkl ostatních.

Spravovat klíče

Nástroje

Po připojení tvůj asistent uvidí tyto nástroje (53). Nástroje pro výpis, ceny a sledování jsou zdarma; placené nástroje před startem ukážou cenu.

Nástroje: 5
list_modelsModely podle typu, s cenou pro tvoje nastaveníZdarma
get_modelJeden model se všemi volbami, které přijímá (povolené hodnoty, rozsahy, výchozí hodnoty)Zdarma
estimate_pricePřesná cena dřív, než se cokoli spustíZdarma
account_balanceZůstatek a útrata tohoto klíče v tomto měsíciZdarma
account_usageÚtrata po dnech a modelech za zvolené obdobíZdarma

Nastavení API klíče

Pro nástroje, které se připojují klíčem. Doporučujeme samostatný klíč pro každý nástroj.

Rozsah

Klíč smí dělat jen úlohy, které vybereš. Když nevybereš nic, je povolen každý druh generování: generations:image · video · audio · 3d · upscale · llm

Měsíční limit útraty

Po dosažení limitu se asistent zastaví a dostane tuto chybu. Limit se obnovuje na začátku každého kalendářního měsíce (UTC): key_spend_cap_reached

Rychlost a souběh

Ve výchozím stavu 120 požadavků za minutu a 2 úlohy současně. Můžeš přidat seznam povolených IP a datum vypršení.

Bezpečné vstupy

Adresy, které asistent předává, musí být veřejné odkazy https; interní sítě a soukromé adresy se odmítají.

Nový klíčUkázka obrazovky účtu
Jméno
Claude Code · notebook
Režim
Povolené úlohy
Vytvořit klíč

Klíč se zobrazí jednou a uchovává se jen jako hash SHA-256.

Řešení problémů

Chybové kódy se objevují ve výsledku nástroje, který vidí tvůj asistent. Tady je, co znamenají a co dělat.

Vyzváno k novému přihlášení401 · invalid_token

Přístup aplikace vypršel nebo byl odebrán. Připoj se znovu: v Claude zvol u konektoru Reconnect, v Claude Code spusť /mcp, jinde fcaai odeber a přidej znovu.

Dosažen měsíční limitkey_spend_cap_reached

Aplikace nebo klíč vyčerpaly měsíční limit. Zvyš limit klíče v Účet › API klíče, nebo aplikaci odeber a připoj znovu s vyšším limitem.

Nedostatečný zůstatek402 · insufficient_balance

Dobij si zůstatek a požádej asistenta, ať to zkusí znovu. Nic se neúčtovalo.

Dobít
Model nedostupnýmodel_unavailable

Model je vytížený nebo pozastavený. Pokud existuje záložní cesta, přepneme na ni automaticky; jinak to zkus za chvíli znovu nebo si řekni o jiný model.

Nastavení bylo ignorovánoignored_fields

Spuštění proběhlo a ignored_fields vypíše každé nastavení, které model nepřijímá, i s důvodem. Požádej asistenta, ať v get_model zkontroluje, co model přijímá.

Hodnota byla odmítnutainvalid_<field> · invalid_arguments

Hodnota není pro daný model povolená. Chyba vypíše povolené hodnoty, takže asistent to může zkusit znovu s některou z nich. Nic se neúčtovalo.

Nezobrazují se žádné nástroje fcaai

Zkontroluj, že adresa končí na /mcp. Pak obnov: v ChatGPT Refresh na stránce Plugins; v Claude zapni fcaai v + › Connectors; v Cursoru ho zapni v Customize; ve VS Code Restart Server. Pořád nic? Odeber fcaai a přidej ho znovu.

Příliš mnoho požadavkůrate_limited

Ve výchozím stavu 120 požadavků za minutu na připojení a některé nástroje mají vlastní minutový limit. Počkej minutu a zkus to znovu.

Zablokováno v pracovní síti

Aplikace na tvém počítači (Claude Code, Codex, Cursor, VS Code…) potřebují přístup HTTPS k api.fcaai.ai a přihlášení otevírá fcaai.ai v prohlížeči. Požádej IT, ať povolí obojí.

Otázky

Stojí používání MCP něco navíc?

Ne. Platíš jen za generování, která spustíš, za ceny API v amerických dolarech. Výpisy, cenové odhady a kontroly stavu jsou zdarma.

Funguje můj neomezený tarif přes MCP?

Ne. API, MCP server i pluginy vždy čerpají z tvého zůstatku. Neomezené použití platí pro Studio, Canvas a šablony na webu a v aplikaci.

Může asistent spustit drahou úlohu, aniž by se zeptal?

ChatGPT i Claude se tě mohou před spuštěním nástroje zeptat a server asistentovi říká, aby před video a 4K úlohami uvedl cenu. Skutečnou pojistkou je měsíční limit, který nastavíš při připojení (nebo limit útraty klíče): jakmile je dosažen, žádná nová úloha nezačne.

Kde jsou výstupy uložené?

V tvé knihovně fcaai, stejně jako vše, co vytvoříš ve Studiu. Asistent ti dá odkaz a Claude Code, Codex a další terminálové nástroje umí soubor uložit rovnou do tvé složky.

Přihlášení, nebo API klíč: co použít?

Přihlas se, když to aplikace nabízí: nemusíš kopírovat žádný klíč, vybereš účet a měsíční limit a aplikaci odebereš jedním kliknutím. API klíč použij pro skripty, CI a prostředí, kde se nikdo nemůže přihlásit přes prohlížeč.

Kdo může MCP server používat?

Jakýkoli účet fcaai, osobní i týmový. Spuštění se platí ze zůstatku daného účtu za ceny API, bez ohledu na tarif.

Co se stane, když spuštění selže?

Rezervovaná částka se automaticky vrátí. Když obvyklá cesta modelu selže, zkusíme to znovu přes záložní cestu za stejnou cenu.