跳至主要內容
執行中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 · fcaai MCP 伺服器
執行模型,傳回結果
與 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 用戶端),請選擇 Register automatically
  3. 使用 fcaai 登入

    fcaai 畫面會開啟。選擇帳號(個人或團隊)、設定每月上限,然後選擇「允許」。如果開啟了兩步驟驗證,請輸入驗證碼。
  4. 在對話中開啟

    在訊息框中開啟 + › Connectors 並開啟 fcaai。Claude 可能會在工具執行前詢問你:請選擇「Allow once」或「Always allow」。

在 Team 或 Enterprise 方案中,擁有者可為所有人新增 fcaai,位置在 Organization settings › Connectors › Add › Custom › Web. 接著每位成員在 Customize › Connectors 中選擇「Connect」,並用自己的 fcaai 帳號登入。

連接完成後,fcaai 也能在 Claude 行動應用程式中使用;用同一個 Claude 帳號登入 Claude Code 時也能使用。

伺服器位址
https://api.fcaai.ai/mcp
成功時的樣子

fcaai 會列在「Your connectors」下,狀態為「Connected」。

測試一下
使用 fcaai:列出圖片模型及其價格。

列出模型是免費的,所以這項測試不會花任何費用。

第一步

像向同事交代工作一樣跟你的助理說話。第一次記得提到 fcaai,助理才會選用正確的工具。

提示詞範例

生成圖片用 fcaai 生成兩張 16:9 的圖片:藍調時刻,松林山脊上的一棟玻璃別墅。先告訴我價格。
estimate_pricegenerate_image
用參考圖編輯用 fcaai 把我的客廳改成日式北歐(Japandi)風格,保留窗戶和格局: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
先報價在 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 可以用 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 中,於連接器上選擇「重新連線」;在 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 中,到「Plugins」頁面點選「Refresh」;在 Claude 中,於「+ › 連接器」開啟 fcaai;在 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 金鑰:該用哪一個?

應用程式提供登入時就用登入:不需要複製金鑰,你可以選擇帳號與每月上限,也能一鍵移除應用程式。腳本、CI 以及沒有人能透過瀏覽器登入的環境,則使用 API 金鑰。

誰可以使用 MCP 伺服器?

任何 fcaai 帳號,個人或團隊皆可。執行費用以 API 價格從該帳號的餘額扣除,不論你使用哪種方案。

執行失敗會怎樣?

預留的金額會自動退回。若某個模型的一般路徑失敗,我們會以相同價格改走備援路徑重試。