教程 / MCP

使用 MCP 从 Claude Code 或 Cursor 生成

NOLGIA 运行一个托管的 MCP 服务器,提供与我们自家智能体相同的工具。给 Claude Code 或 Cursor 一个令牌,它就能为你生成内容、读取你的素材库并检查任务。

  • 5 分钟阅读
  • 更新于

本文由英文自动翻译。阅读原文

你只需一个个人访问令牌,就能将 Claude Code 或 Cursor 连接到 NOLGIA,然后用自然语言请求图像、视频和音频。NOLGIA 通过位于 mcp.nolgia.ai 的一个托管服务器支持模型上下文协议(简称 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、标记为 Soon 的 ChatGPT 以及标记为 Soon 的 Claude 桌面版和网页版选项卡,下方是带有复制按钮的 claude mcp add 命令
MCP 页面,第 2 步。 Claude Code 选项卡包含相同的命令,并带有复制按钮。ChatGPT 以及 Claude 桌面版和网页版标记为 Soon。

或者将其添加到 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。
粘贴到你的智能体
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 分钟阅读