Ugrás a tartalomra
fcaaiBejelentkezésKezdd ingyen
FutStreamable HTTP · OAuth 2.1

MCP-dokumentáció

Csak mondd, mit szeretnél. Az asszisztensed kiválasztja a megfelelő eszközt, megmondja az árat, és visszahozza az eredményt.

Szervercímhttps://api.fcaai.ai/mcp
Hitelesítés
Bejelentkezés az fcaai-jal (OAuth) vagy API-kulcs OAuth 2.1 (PKCE) · Bearer fcaai_live_…
Szükséges hatókör
generations:write
Protokoll
2025-11-25 · 2025-06-18 · 2025-03-26 · 2024-11-05
Ár
API-árak · USD · a sikertelen futtatások díját visszatérítjük

A ChatGPT és a Claude az fcaai-fiókoddal való bejelentkezéssel csatlakozik, kulcsmásolás nélkül. A kódeszközök is bejelentkezhetnek, vagy API-kulcsot használhatnak. A tesztkulcsokat (fcaai_test_) az éles kulcsokkal azonos módon számlázzuk. Kulcs létrehozása

Mi az MCP?

Nyílt szabvány, amellyel az AI-asszisztensek külső eszközöket használhatnak. Ha az asszisztensed egy feladatot nem tud maga elvégezni, meghívja a megfelelő eszközt egy csatlakoztatott szerveren, és visszahozza neked az eredményt. Az eszközöket az fcaai adja; neked csak beszélned kell.

1 · Te
Írd meg a kérésedet
„Skálázd fel ezt a renderelést 4K-ra, és előbb mondd meg, mennyibe kerül.”
2 · Az asszisztensed
Claude · ChatGPT · Codex · Cursor
Megérti a kérést, és eldönti, mely fcaai-eszközökre van szüksége: estimate_price → generate
3 · Az fcaai MCP-szervere
Futtatja a modellt, visszaadja az eredményt
Ugyanaz az egyenleg, mint a Studióban. Az árajánlat ingyenes, a sikertelen feladat díját pedig visszatérítjük.
Kép · felskálázásVideóBeszédhang · zene3D

Mire jó?

Alkoss a beszélgetésen belül, fülváltás nélkül. Az ismétlődő, többlépéses munkánál jelenti a legnagyobb különbséget.

  • Drága feladatok előtt rákérdez. A szerver arra utasítja az asszisztenst, hogy videós és 4K-s feladatok előtt közölje az árat.
  • Minden modell, minden beállítás. Az olyan beállítások, mint a képarány, az időtartam, a felbontás és a hang, az egyes modellek saját listájából származnak.
  • A Canvasod eszközzé válik. A közzétett tábláid egyetlen hívással folyamatként futnak.
Claudefcaai csatlakoztatvaPéldabeszélgetés
Skálázd fel ezt a renderelést 4K-ra, de előbb mondd meg, mennyibe kerül: 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
A 2×-es felskálázás 3840×2160-as képet ad, nagyjából $0.008 áron. Indítom.
generatemodel: fca/upscale · image: /u/… · tier: 2xqueued
get_generationwait_seconds: 50succeeded
villa-blue-hour_4k.png
3840×2160 · fca/upscale · $0.008

Beállítás az asszisztensedhez

Válaszd ki az alkalmazásodat. Minden útmutatót az adott alkalmazás hivatalos dokumentációja alapján ellenőriztünk. A ChatGPT és a Claude az fcaai-fiókoddal jelentkezik be; a kódeszközök is bejelentkezhetnek, vagy API-kulcsot használhatnak.

Claude · claude.ai, asztali, mobilMűködik · bejelentkezés az fcaai-jal

A Claude az fcaai-fiókoddal csatlakozik, API-kulcs másolása nélkül. Egyéni összekötők a Free, Pro, Max, Team és Enterprise csomagokban működnek; a Free csomagban egyet adhatsz hozzá.

  1. Nyisd meg az összekötőidet

    A claude.ai-on vagy a Claude asztali alkalmazásban nyisd meg ezt Customize › Connectors › Add custom connector
  2. Add meg a címet

    Név fcaai · URL https://api.fcaai.ai/mcpHa a párbeszédablak megkérdezi, hogyan azonosítja magát a Claude (OAuth-kliens), válaszd ezt Register automatically
  3. Bejelentkezés az fcaai-jal

    Megnyílik az fcaai képernyője. Válaszd ki a fiókot (személyes vagy csapat), állíts be havi korlátot, és válaszd az Engedélyezés lehetőséget. Ha be van kapcsolva a kétlépcsős azonosítás, add meg a kódodat.
  4. Bekapcsolás egy csevegésben

    Az üzenetmezőben nyisd meg ezt + › Connectors és kapcsold be az fcaai-t. A Claude rákérdezhet egy eszköz futtatása előtt: válaszd az Allow once vagy az Always allow lehetőséget.

Team vagy Enterprise csomagban egy Owner (tulajdonos) mindenki számára hozzáadhatja az fcaai-t itt Organization settings › Connectors › Add › Custom › Web. Ezután minden tag a Customize › Connectors menüben a Connect lehetőséget választja, és a saját fcaai-fiókjával jelentkezik be.

Csatlakozás után az fcaai a Claude mobilalkalmazásban is működik, a Claude Code-ban pedig akkor, ha ugyanazzal a Claude-fiókkal jelentkezel be.

Szervercím
https://api.fcaai.ai/mcp
Ha működik

Az fcaai a Your connectors alatt Connected állapotban jelenik meg.

Kipróbálás
Használd az fcaai-t: listázd ki a képmodelleket és az áraikat.

A modellek listázása ingyenes, így ez a teszt semmibe sem kerül.

Első lépések

Úgy beszélj az asszisztenseddel, ahogy egy embernek adnál feladatot. Az első alkalommal említsd meg az fcaai-t, hogy a megfelelő eszközökhöz nyúljon.

Példapromptok

Képek létrehozásaKészíts az fcaai segítségével két 16:9-es képet egy üvegvilláról egy fenyves hegygerincen, a kék órában. Előbb mondd meg az árat.
estimate_pricegenerate_image
Szerkesztés referenciávalAlakítsd át a nappalimat japandi stílusúra az fcaai segítségével, és tartsd meg az ablakokat és az elrendezést: https://example.com/room.jpg
upload_from_urlgenerate_image
Képből videóKészíts egy 5 másodperces videót, amely a https://example.com/day.jpg képpel kezdődik, és a https://example.com/night.jpg képpel ér véget. Indítás előtt mondd meg az árát.
get_modelestimate_pricegenerate
FelskálázásSkálázd fel 4K-ra a legutóbbi fcaai-renderemet.
list_generationsgenerate
NarrációMutasd meg az fcaai hangjait, aztán olvasd fel ezt a bekezdést nyugodt, meleg hangon.
list_voicesgenerate_speech
ZeneKészíts egy 30 másodperces instrumentális lo-fi számot egy termékvideóhoz.
generate_music
SablonokMelyik fcaai-sablon készít alaprajzból renderelt képet? Futtasd a legjobbat ezen: https://example.com/plan.png.
list_templatesrun_template
Előbb az árMennyibe kerülne az fcaai-on egy 10 másodperces, 1080p-s, hangos videó? Ne futtasd.
get_modelestimate_price
KöltésekMennyit költöttem az fcaai-on ebben a hónapban, és mely modellekre? Mennyi az egyenlegem?
account_usageaccount_balance

Add át a képedet az asszisztensnek

Az fcaai-eszközök linkeket fogadnak, nem fájlmellékleteket. Ezek bármelyike működik:

Link beillesztése

Egy kép-, videó- vagy hangfájl nyilvános https-linkje (legfeljebb 50 MB). Az asszisztens közvetlenül használja, vagy előbb bemásolja az fcaai-ba ezzel: upload_from_url

Valami, amit az fcaai-on készítettél

Az eredmények linkje ilyen: https://fcaai.ai/o/…. Vagy csak mondd: „használd a legutóbbi renderemet”, és az asszisztens megtalálja ezzel: list_generations

A terminálból

A Claude Code, a Codex és a Gemini CLI fel tud tölteni egy helyi fájlt az fcaai CLI-vel, majd a kiírt linket használja:

Terminál
npm install -g @fcaai/cli
fcaai login
fcaai upload ./photo.jpg   # prints a link to pass to the assistant
A ChatGPT- vagy Claude-csevegésben csatolt képek nem jutnak el az fcaai-hoz. Az asszisztens látja őket, de a fájlt nem tudja átadni egy eszköznek. Ehelyett ossz meg egy linket.

A linkeknek nyilvánosnak kell lenniük. A privát hálózatokon lévő címeket és a bejelentkezéshez kötött oldalakat elutasítjuk.

Hosszú feladatok: videó és 3D

A generálások a háttérben futnak. Az asszisztens a get_generation segítségével vár (ellenőrzésenként legfeljebb 50 másodpercig), és addig ellenőriz újra, amíg az eredmény el nem készül. Ha a csevegés előbb véget ér, a feladat akkor is befejeződik, és a könyvtáradba kerül. Később rákérdezhetsz: „mutasd a legutóbbi fcaai-generálásaimat”.

Hová kerülnek az eredmények

Minden eredmény letöltési linkkel együtt az fcaai-könyvtáradba kerül. A terminálos asszisztensek a fájlt közvetlenül a projektmappádba is menthetik.

Kapcsolatok és költések

Te döntöd el, melyik fiókot használja egy alkalmazás, és mennyit költhet, és ezt bármikor megváltoztathatod.

Alkalmazásonkénti havi korlát

Az fcaai bejelentkezési képernyőjén havi korlátot állíthatsz be az adott alkalmazásnak ($10, $25 vagy $100), vagy korlát nélkül engedélyezheted. Ha eléri a korlátot, a következő hónapig (UTC) nem indul új feladat. A módosításhoz vond vissza a hozzáférést, és csatlakozz újra. key_spend_cap_reached

Személyes vagy csapat

Ha egy csapat tulajdonosa vagy kezelője vagy, az alkalmazást a csapathoz is csatlakoztathatod. A futtatásai ekkor a csapat egyenlegéből fizetődnek.

Kétlépcsős azonosítás

Ha be van kapcsolva, a bejelentkezési képernyő a hitelesítő alkalmazásod kódját (vagy egy tartalékkódot) kéri, mielőtt engedélyezhetnéd a hozzáférést.

Hozzáférés megszüntetése

A Fiók › API-kulcsok › Csatlakoztatott alkalmazások menüpont minden alkalmazást felsorol, amelybe bejelentkeztél, a hozzá tartozó fiókkal és korláttal együtt. Ha visszavonod a hozzáférést, az alkalmazás azonnal leáll.

Bejelentkezve maradás

Az alkalmazások maguktól megújítják a hozzáférésüket. Ha egy alkalmazást 90 napig nem használsz, vagy eltávolítod, újra bejelentkezést kér.

API-kulcsok kódeszközökhöz

Adj minden eszköznek saját kulcsot, csak a szükséges feladatokkal és havi költési korláttal. Így egyet visszavonhatsz anélkül, hogy a többihez hozzányúlnál.

Kulcsok kezelése

Eszközök

Csatlakozás után az asszisztensed 53 eszközt lát. A listázó, árazó és követő eszközök ingyenesek; a fizetős eszközök indulás előtt megmutatják az árat.

5 eszköz
list_modelsModellek típus szerint, a beállításaidhoz tartozó árralIngyenes
get_modelEgy modell az összes elfogadott opciójával (megengedett értékek, tartományok, alapértékek)Ingyenes
estimate_pricePontos ár, mielőtt bármi elindulnaIngyenes
account_balanceEgyenleg és a kulcs e havi költéseIngyenes
account_usageNapi és modellenkénti költés egy dátumtartományraIngyenes

API-kulcs beállításai

Kulccsal csatlakozó eszközökhöz. Minden eszközhöz külön kulcsot javaslunk.

Hatókör

A kulcs csak a kiválasztott feladatokat végezheti. Ha egyet sem választasz, minden generálástípus engedélyezett: generations:image · video · audio · 3d · upscale · llm

Havi költési korlát

A korlát elérésekor az asszisztens leáll, és ezt a hibát kapja. A korlát minden naptári hónap elején (UTC) visszaáll: key_spend_cap_reached

Gyakoriság és párhuzamosság

Alapértelmezés szerint percenként 120 kérés és egyszerre 2 feladat. Megadhatsz IP-engedélyezőlistát és lejárati dátumot is.

Biztonságos bemenetek

Az asszisztens által átadott címeknek nyilvános https-linkeknek kell lenniük; a belső hálózatokat és a privát címeket elutasítjuk.

Új kulcsPélda a fiókképernyőre
Név
Claude Code · laptop
Mód
Engedélyezett feladatok
Kulcs létrehozása

A kulcs csak egyszer jelenik meg, és kizárólag SHA-256 hash-ként tároljuk.

Hibaelhárítás

A hibakódok az asszisztensed által látott eszközeredményben jelennek meg. Itt láthatod, mit jelentenek, és mit tegyél.

Újra bejelentkezést kér401 · invalid_token

Az alkalmazás hozzáférése lejárt, vagy visszavonták. Csatlakozz újra: a Claude-ban válaszd az összekötőnél a Reconnect lehetőséget, a Claude Code-ban futtasd a /mcp parancsot, máshol pedig távolítsd el az fcaai-t, és add hozzá újra.

Elérted a havi korlátotkey_spend_cap_reached

Az alkalmazás vagy a kulcs elhasználta a havi keretét. Emeld meg a kulcs korlátját itt: Fiók › API-kulcsok, vagy távolítsd el az alkalmazást, és csatlakoztasd újra magasabb korláttal.

Nincs elég egyenleg402 · insufficient_balance

Töltsd fel az egyenlegedet, és kérd meg az asszisztenst, hogy próbálja újra. Nem vontunk le semmit.

Egyenlegfeltöltés
A modell nem érhető elmodel_unavailable

A modell foglalt vagy szünetel. Ha van tartalék útvonal, automatikusan átváltunk rá; ha nincs, próbáld újra kicsit később, vagy kérj másik modellt.

Egy beállítás figyelmen kívül maradtignored_fields

A futtatás lefutott, és az ignored_fields felsorolja az összes beállítást, amelyet az adott modell nem fogad, az okkal együtt. Kérd meg az asszisztenst, hogy a get_model segítségével nézze meg, mit fogad el a modell.

Egy értéket elutasítottunkinvalid_<field> · invalid_arguments

Az érték nem megengedett ennél a modellnél. A hiba felsorolja az engedélyezett értékeket, így az asszisztens újrapróbálhatja valamelyikkel. Nem vontunk le semmit.

Nem jelennek meg az fcaai-eszközök

Ellenőrizd, hogy a cím vége /mcp legyen. Aztán frissíts: a ChatGPT-ben a Plugins oldalon a Refresh gombbal; a Claude-ban kapcsold be az fcaai-t itt: + › Connectors; a Cursorban kapcsold be a Customize menüben; a VS Code-ban: Restart Server. Még mindig semmi? Távolítsd el az fcaai-t, és add hozzá újra.

Túl sok kérésrate_limited

Alapértelmezés szerint kapcsolatonként percenként 120 kérés, és egyes eszközöknek saját percenkénti korlátjuk is van. Várj egy percet, és próbáld újra.

Letiltva munkahelyi hálózaton

A számítógépeden futó alkalmazásoknak (Claude Code, Codex, Cursor, VS Code…) HTTPS-hozzáférés kell az api.fcaai.ai címhez, a bejelentkezés pedig megnyitja az fcaai.ai oldalt a böngésződben. Kérd meg az informatikusokat, hogy mindkettőt engedélyezzék.

Kérdések

Kerül valamibe az MCP használata?

Nem. Csak a futtatott generálásokért fizetsz, API-áron, amerikai dollárban. A listázás, az árajánlatok és az állapotlekérdezések ingyenesek.

Működik a korlátlan csomagom MCP-n keresztül?

Nem. Az API, az MCP-szerver és a bővítmények mindig az egyenlegedet használják. A korlátlan használat a Studióra, a Canvasra és a sablonokra vonatkozik a weboldalon és az alkalmazásban.

Elindíthat az asszisztens drága feladatot anélkül, hogy megkérdezne?

A ChatGPT és a Claude megkérdezhet téged, mielőtt egy eszköz lefut, a szerver pedig arra utasítja az asszisztenst, hogy videós és 4K-s feladatok előtt mondja meg az árat. Az igazi védelmet a csatlakozáskor beállított havi limit (vagy a kulcs költési korlátja) jelenti: ha eléri, új feladat nem indul.

Hol tárolódnak a kimenetek?

Az fcaai-könyvtáradban, mint minden, amit a Studióban készítesz. Az asszisztens megadja a linket, a Claude Code, a Codex és más terminálos eszközök pedig közvetlenül a mappádba menthetik a fájlt.

Bejelentkezés vagy API-kulcs: melyiket használjam?

Jelentkezz be, ha az alkalmazásod felkínálja: nincs mit másolni, kiválasztod a fiókot és egy havi limitet, és egy kattintással eltávolíthatod az alkalmazást. API-kulcsot szkriptekhez, CI-hoz és olyan környezetekhez használj, ahol senki sem tud böngészőben bejelentkezni.

Ki használhatja az MCP-szervert?

Bármelyik fcaai-fiók, egyéni vagy csapat. A futtatások az adott fiók egyenlegéből fizetődnek API-áron, csomagtól függetlenül.

Mi történik, ha egy futtatás sikertelen?

A lefoglalt összeg automatikusan visszajár. Ha egy modell szokásos útvonala sikertelen, ugyanazon az áron egy tartalék útvonalon próbálkozunk újra.