将 Claude 或 Cursor 连接到 Cinevva（MCP 服务器）

Cinevva 提供托管式 MCP 服务器，让 Claude、Claude Code、Cursor 或任何 MCP 客户端都能构建你的游戏。你已经在使用的 AI 将成为游戏开发的大脑：它可以直接读取和编辑我们服务器上的游戏文件，无需打开浏览器标签页。同时在 Cinevva 创作器中打开游戏，即可让会话进入实时状态：AI 随后便能从我们的 CC0 素材库导入素材、为 3D 模型绑定骨骼并制作动画、截取屏幕截图、模拟输入以测试运行中的游戏，以及刷新预览，而每项更改都会实时显示在你的屏幕上。

你需要准备什么

一个 Cinevva 账号（免费账号即可；3D 骨骼绑定会消耗余额中的点数），以及支持通过 OAuth 连接远程服务器的 MCP 客户端。服务器 URL 为：

https://api.cinevva.com/create/mcp

该服务器使用 Streamable HTTP，并通过 OAuth 2.0 进行身份验证。连接时，客户端会在浏览器中打开 Cinevva 登录页面。只需批准一次，客户端便会保持连接。

随处都能编辑。进入实时状态即可观看和测试。

文件编辑只需建立连接。文件工具会直接读写我们服务器上游戏的权威副本，因此即使没有打开任何 Cinevva 标签页，你的助手也能修复错误或添加功能。指定你想编辑的游戏（或让 AI 从你的游戏中选择），然后直接输入提示词即可。

进入实时状态是功能升级，而非必要条件。在 cinevva.com/create 打开游戏，等待预览加载，然后点击创作器工具栏中的 外部智能体（插头图标；在小屏幕上也可从“更多”菜单中找到）。连接后，面板会切换为“智能体实时连接”。实时会话让 AI 能够观察和操作运行中的游戏：截取屏幕截图、读取控制台日志、模拟输入、导入素材，以及进行 3D 骨骼绑定。无论编辑来自当前标签页还是无界面环境，每项更改都会在生效的瞬间同步到你的屏幕。实时连接会在后续访问时继续保持，直到你点击“停止实时会话”。

list_live_sessions 工具会显示当前已连接的会话；当仅打开一个游戏时，它会被自动选为目标。

在 Claude（claude.ai 和桌面版）中设置

打开“设置”，然后进入“连接器”，选择“添加自定义连接器”。
将其命名为 Cinevva，并粘贴 https://api.cinevva.com/create/mcp 作为 URL。注意不要带入多余字符，URL 必须以 /create/mcp 结尾。
点击“添加”，然后点击“连接”。授权页面打开后，使用你的 Cinevva 账号登录（必须与游戏标签页当前登录的账号相同）。
向 Claude 提出类似“列出我的 Cinevva 游戏文件”的请求，以确认连接正常。如需实时测试，请在另一个标签页中通过 cinevva.com/create 打开游戏，然后点击工具栏中的“外部智能体”。

在 Claude Code 中设置

bash

claude mcp add --transport http cinevva https://api.cinevva.com/create/mcp

首次使用时，Claude Code 会引导你完成 OAuth 登录。之后，你可以让它读取游戏文件或进行更改。无需打开浏览器标签页，直接在终端中即可使用。

在 Cursor 中设置

将以下内容添加到 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）：

json

{
  "mcpServers": {
    "cinevva": {
      "url": "https://api.cinevva.com/create/mcp"
    }
  }
}

Cursor 会检测服务器，在浏览器中启动 OAuth 流程，并在其 MCP 设置中列出可用工具。

工具的功能

分组	工具	是否需要实时会话？
读取游戏	`list_game_files`、`read_files`、`search_game_file`	否，可读取你任意游戏在服务器上的副本
编辑游戏	`edit_files`、`write_files`、`delete_files`、`rename_files`	否，编辑会在服务器端生效，并同步到已打开的标签页
预览	`game_ready`	有实时标签页时刷新其预览，否则在无界面模式下保存
查看游戏	`read_console_logs`、`take_screenshot`	是
测试	`execute_js`、`simulate_input`、`get_task_status`	是
素材	`search_assets`、`list_asset_packs`、`import_asset`、`search_fonts`	是。约 7,000 个 CC0 道具、音频和 HDRI
3D 骨骼绑定	`rig_model`、`apply_animation`	是，会消耗点数
文档	`list_library_docs`、`search_library_docs`、`read_library_docs`、`list_animations`	是

骨骼绑定消耗的点数与应用内游戏创作器相同。其他所有功能均免费。应用内创作器还可以使用 AI 生成图像、音乐、音效和天空盒；这些工具位于 Cinevva 应用本身，不属于 MCP 连接器。

故障排除

设置过程中出现“在提供的 URL 中找不到 MCP 服务器”，通常表示 URL 有拼写错误或末尾多了字符。它必须完全为 https://api.cinevva.com/create/mcp。

“没有实时会话”只会由运行时工具触发（屏幕截图、控制台、输入、素材、骨骼绑定）。这表示没有任何浏览器标签页打开该游戏并启用实时连接。打开游戏，点击工具栏中的“外部智能体”，然后重试。文件工具从不需要实时会话：没有会话时，它们可以通过 gameId 操作你的任意游戏；如果未传入 gameId，则会列出你的游戏。

如果工具在刚建立连接后停滞，请刷新游戏标签页以重新连接，然后调用 list_live_sessions。

如有疑问或遇到问题，请联系：[email protected]。

将 Claude 或 Cursor 连接到 Cinevva（MCP 服务器） ​

你需要准备什么 ​

随处都能编辑。进入实时状态即可观看和测试。 ​

在 Claude（claude.ai 和桌面版）中设置 ​

在 Claude Code 中设置 ​

在 Cursor 中设置 ​

工具的功能 ​

故障排除 ​