指南 / MCP

透過 MCP 從 Claude Code 或 Cursor 生成

NOLGIA 執行一個託管的 MCP 伺服器,提供與我們自家代理相同的工具。給 Claude Code 或 Cursor 一個權杖,它就能為你生成內容、讀取你的媒體庫並檢查工作狀態。

  • 閱讀時間 5 分鐘
  • 更新於

本文由英文自動翻譯。閱讀原文

你只需使用一個個人存取權杖,就能將 Claude Code 或 Cursor 連接到 NOLGIA,然後用自然語言要求生成圖片、影片和音訊。NOLGIA 透過位於 mcp.nolgia.ai 的單一託管伺服器支援模型上下文協議(Model Context Protocol,簡稱 MCP),該伺服器執行與 NOLGIA Agent 相同的工具。

目前這適用於 Claude Code 和 Cursor。在 MCP 頁面 上,ChatGPT、Claude 桌面版和網頁版標示為「即將推出」:它們會透過登入驗證而非使用權杖,且其設定步驟尚未發布。

開始之前

  • 一個 NOLGIA 帳號,以及你電腦上的 Claude Code 或 Cursor。
  • 你加值餘額中的點數。權杖僅使用你的加值點數,絕不使用你的每月方案點數。
  • 影片生成需為 Pro 或更高方案。權杖會繼承你帳戶的方案,因此無法解鎖你方案未包含的模型。

建立你的 API 權杖

在你的帳戶設定中開啟 API 權杖。在 建立權杖 下方,為其命名,例如你將在其中使用的應用程式名稱,然後按下 建立權杖。NOLGIA 只會顯示權杖一次,因此在離開頁面之前,請將其複製到安全的地方。

API 權杖設定頁面上的「建立權杖」卡片,帶有兩個編號標記:「名稱」欄位和「建立權杖」按鈕,旁邊是設為 365 的「有效天數」欄位
在 API 權杖頁面上 建立權杖。(1) 以你將在其中使用的應用程式名稱命名。(2) 建立權杖,然後在顯示時將其複製。

注意:不小心分享出去了?. 在 使用中的權杖 下方,點擊其旁邊的 撤銷,然後建立一個新的。任何使用已撤銷權杖的內容都會立即停止運作。

將 NOLGIA 新增至 Claude Code

開啟終端機並執行此命令,將你的權杖取代 nol_your_token_here。你只需新增一次,終端機中的每個 Claude Code 工作階段就能生成內容、瀏覽你的媒體庫並讀取工作狀態。

貼到終端機
claude mcp add --transport http nolgia https://mcp.nolgia.ai/mcp --header "Authorization: Bearer nol_your_token_here"
MCP 頁面步驟 2,選取 Claude Code 分頁:上方有 Claude Code、標記為即將推出的 Cursor、標記為即將推出的 ChatGPT 以及標記為即將推出的 Claude 桌面版與網頁版分頁,下方是 claude mcp add 命令與複製按鈕
MCP 頁面,步驟 2。 Claude Code 分頁包含相同的命令與複製按鈕。ChatGPT 以及 Claude 桌面版與網頁版標記為即將推出。

或新增到 Cursor

在 Cursor 中,伺服器位於你的 MCP 設定檔案 ~/.cursor/mcp.json。開啟 MCP 頁面,選擇 Cursor 分頁並複製設定。將設定貼到檔案中,將你的權杖取代 nol_your_token_here,然後儲存。

MCP 頁面步驟 2,選取並標記 Cursor 分頁,顯示包含 nolgia 伺服器的 ~/.cursor/mcp.json 設定及其標記的複製按鈕
MCP 頁面,Cursor 分頁。 (1) Cursor。(2) 複製設定,然後將你的權杖取代 nol_your_token_here。

檔案應如下所示,這裡以單行顯示:{ "mcpServers": { "nolgia": { "url": "https://mcp.nolgia.ai/mcp", "headers": { "Authorization": "Bearer nol_your_token_here" } } } }

提示:已在使用其他伺服器?. 在你現有的 mcpServers 物件中,於其他項目旁新增 nolgia 條目。

用白話文提問

連線後,用你自己的話語描述需求。伺服器為你的應用程式提供超過 50 種工具,分為七個群組:

群組涵蓋內容
生成圖片、影片、音訊、3D、圖片集、預設集執行,以及剪輯和旁白組合成單一影片
你的媒體庫素材、上傳檔案、角色、風格、轉錄文字和短片段
專案專案、其素材和畫布
編輯工作階段與微調逐步圖片編輯,包含預估和復原
預設集列出預設集並讀取其中一個
時間軸檢查遮罩和動態,列出調色預設集並檢查渲染
模型、帳戶和工作模型、你的帳戶、生成次數和工作,包括取消工作
MCP 頁面列出的工具群組。
試試這樣問
Use NOLGIA to make a 16:9 image of a singer in a silver bomber jacket walking through a concrete tunnel lined with red and magenta neon tubes, low haze on the floor.

提示:從預設集開始. MCP 頁面上的每個預設集卡片都有一段提示詞,你可以複製到 Claude Code 或 Cursor 中,而且每個預設集在 預設集 上也有自己的頁面。

MCP 頁面上的三個預設集卡片:Encore Captions、Multicam 和 Commercial,每個都有提示詞行和複製按鈕;Encore Captions 的提示詞及其複製按鈕已標記
MCP 頁面上的預設集卡片。 (1) 該預設集的提示詞。(2) 將其複製到 Claude Code 或 Cursor。

關於所有工具,請參閱 執行 MCP。關於協助編碼代理使用 NOLGIA 的技能,請參閱 Nolgia for Claude Code, Cursor and Codex。

或者改為設定 CLI

MCP 頁面也有一段供你的編碼代理使用的單行指令。它不會新增 MCP 伺服器:它會安裝 NOLGIA 命令列工具(無需 sudo),等待你登入,安裝 NOLGIA 技能,並執行一次驗證生成,這會消耗少量的點數。

MCP 頁面上的「貼到代理」區塊:安裝 Nolgia CLI 的單行指令,其複製按鈕已標記
給你的編碼代理的一行指令,位於 MCP 頁面。(1) 複製它,貼到你的代理中,它會幫你安裝並檢查 CLI。
把這段貼給你的 AI 代理
Read https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/INSTALL_FOR_AGENTS.md and follow it end to end to install and set up the Nolgia CLI for me.

費用說明

讀取操作免費:列出你的資產、檢查任務或瀏覽預設集都不消耗任何費用。只有生成操作會消耗點數,費率依模型公布的價格而定。以下是 MCP 頁面列出的部分模型及其即時費率。

  • Wan 3.0Pro and up

    Per 5s clip

    480p 14 點 · 720p 28 點 · 1080p 56 點

  • Seedance 2.5Pro and up

    Per 5s clip

    480p 26 點 · 720p 56 點 · 1080p 137 點

    1080p renders at 16:9 and 9:16

  • GPT Image 2.5 SunburstEvery plan

    Per image

    Native 8 點 · 2K 21 點 · 4K 58 點

  • Nano Banana 2Every plan

    Per image

    Native 4 點 · 2K 17 點 · 4K 54 點

  • ElevenLabs v3Every plan

    Per 1,000 characters

    Standard 6 點

頁面載入時從目錄即時讀取。 所有價格都會在生成前顯示。 查看所有費率.

不想進行任何設定?NOLGIA Agent 會代你驅動相同的工具,按對話輪次計費,且包含在 Studio 方案中。

常見問題

哪些應用程式可以連線?
Claude Code 和 Cursor 現已支援,任何能傳送 Authorization 標頭的 MCP 用戶端皆可連線。ChatGPT 以及 Claude 桌面版和網頁版標示為即將推出。文件中的 Run MCP 頁面也顯示了 Codex 的設定方式。
費用是多少?
讀取操作免費;只有生成操作會消耗點數,費率依模型公布的價格而定。使用你的權杖發出的請求僅消耗你的加值點數,絕不會消耗你的每月方案點數。
權杖會在我的方案中解鎖影片功能嗎?
不會。權杖會繼承你帳戶的方案,因此需要 Pro 或更高方案的模型仍然需要該方案。
如果我的權杖外洩了怎麼辦?
在「設定」中的 API 權杖頁面撤銷該權杖,然後建立一個新的。任何使用已撤銷權杖的內容都會立即停止運作。
NOLGIA Agent 可以幫我執行這些工具嗎?
可以。它會代表你操作相同的工具,並根據其思考所使用的模型費率,按每次對話輪次計費。Studio 方案包含此功能。

連接 Claude Code 或 Cursor

查看 MCP 設定

點數

點數運作方式,以及渲染失敗時會發生什麼事

價格顯示在「產生」按鈕上,任務執行期間會暫時保留該金額,保留的金額最終會轉為扣款或退款。以下說明在失敗、拒絕或取消後,點數何時會歸還。

· 閱讀時間 6 分鐘