AI教程

使用 Muse4AI 将 AI 智能体连接到 Muse

了解如何在 Windows 上安装 Muse4AI，通过 MCP、OAuth 或 REST 连接 AI 智能体，并从本地计算机提交 Muse 图像和视频任务。本指南还涵盖任务管理、安全控制、开发命令和实用技巧。

AI我搜编辑部2026年11月4日阅读约 9 分钟

什么是 Muse4AI？

Muse4AI 是一款本地 Windows 应用，可让 AI 代理操作您已登录的 Muse 会话。它通过 REST、MCP 或 OAuth，将 ChatGPT、Claude、Cursor、Codex、n8n 和自定义脚本等工具连接到 Muse。

该应用运行在您自己的电脑上，并在 http://127.0.0.1:47821 提供本地 API。请求不会通过 Muse4AI 云服务中转。您的结果、API 密钥、OAuth 令牌、历史记录和本地库均保存在 %APPDATA%\MuseStudio 中。

主要功能

生成图像和视频：提交文本提示词，可选择添加参考照片、选择账户，并在队列中监控任务。
继续对话：聊天任务会返回对话 ID，代理可以保留上下文、迭代想法并附加文件。
延长已完成的视频：可将生成的片段继续延长最多六步，每条链路约 60 秒。
使用自然语言编辑视频：附加 MP4 文件并描述所需修改，无需配置传统的编辑时间线。
使用 REST 或 MCP：通过 MCP 工具连接代理软件，或直接调用本地 REST API。
安全授权：使用受限 API 密钥，或通过六位数批准代码完成 OAuth 流程。
在本地管理任务：在桌面应用中查看排队任务、预览、生成的资源、连接设置和可搜索的历史记录。

要求和重要限制

打包后的应用适用于 Windows 10 或 Windows 11。如果从源代码运行项目，还需要 Node.js 22 或更高版本。

Muse4AI 是一个非官方独立项目，与 Meta Platforms, Inc. 没有关联，也未获得其认可或赞助。它会自动操作您自己的 Muse 会话，因此在依赖它之前，请查看适用的服务条款。Muse 的变更也可能影响自动化功能。

目前未测试或提供打包的 macOS 和 Linux 版本。Muse4AI 没有云账户、遥测服务器或订阅服务。

在 Windows 上安装 Muse4AI

选项 1：使用安装程序

打开 Muse4AI 下载页面。
下载并运行 Windows 安装程序。
如果 Windows 警告应用未签名，请选择 更多信息，然后选择 仍要运行。
打开 Muse4AI 并转到账户。
添加您的 Muse 账户，并确保其会话已登录。

选项 2：从源代码运行

克隆或下载代码仓库，在其根目录中打开终端，然后运行：

cd desktop
npm install
npm run build
npm start

启动后，桌面界面会打开，本地 API 将在 http://127.0.0.1:47821 可用。

使用 MCP 和 OAuth 连接 AI 代理

对于兼容的代理客户端，MCP 是最直接的选项。在 Muse4AI 中，打开 设置 → API 和代理。应用会提供现成的连接配置片段。基本的 MCP 配置会将客户端指向本地端点：

{
  "mcpServers": {
    "muse4ai": {
      "url": "http://127.0.0.1:47821/mcp"
    }
  }
}

将此配置添加到代理所使用的 MCP 客户端中。在 OAuth 授权期间，Muse4AI 会显示一个六位数代码。在授权页面输入该代码，以批准连接并签发令牌。

OAuth 服务器会发布其授权元数据，支持动态客户端注册，并签发自己的令牌。仅知道本地 MCP URL 不足以批准访问，因为用户还必须提供桌面应用显示的代码。

如需之后移除访问权限，请打开 设置 → API 和代理 → 已连接的应用，撤销相关应用的权限。

通过 REST API 连接

对于直接使用 HTTP 的脚本和服务，请从 设置 → API 和代理 创建 API 密钥。Muse4AI 密钥以 msk_ 开头。请在 Authorization 标头中将密钥作为 bearer 令牌发送。

提交视频生成任务

以下请求会使用文本提示词创建视频任务：

curl -X POST http://127.0.0.1:47821/v1/jobs \
  -H "Authorization: Bearer msk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"video","prompt":"a coffee cup on an oak desk, warm morning light"}'

将 msk_YOUR_KEY 替换为桌面应用创建的密钥。提交的任务会显示在应用内队列中，您可以在那里跟踪其状态并查看结果。

可用的 REST 操作和 MCP 工具

POST /v1/jobs 用于创建图像或视频任务。对应的 MCP 工具是 muse_generate。
使用 kind: "chat" 调用 POST /v1/jobs 可创建聊天任务。对应的 MCP 工具是 muse_chat。
GET /v1/jobs 通过 REST 列出任务。MCP 客户端可以使用 muse_list_jobs。
GET /v1/jobs/{id} 获取特定任务。对应的 MCP 工具是 muse_get_job。
POST /v1/jobs/{id}/cancel 取消任务。对应的 MCP 工具是 muse_cancel_job。
POST /v1/assets/{id}/extend 和 POST /v1/conversations/{id}/extend 支持视频延长。相关 MCP 工具包括 muse_extend_video 和 muse_get_extend。
GET /v1/status 和 GET /v1/health 报告服务信息。MCP 客户端可以使用 muse_status。

完整的机器可读 API 契约可通过运行中的应用访问：GET /v1/openapi.json。如果智能体更适合使用 Markdown 文档，可以读取 llms.txt。

智能体基本工作流

生成图像或视频

确认 Muse4AI 正在运行，并且你的 Muse 账户已在账户中可用。
要求已连接的智能体生成图像或视频，并提供清晰的提示词。
如有需要，添加参考照片并指定应使用的已配置账户。
打开队列跟踪任务、查看其状态并预览结果。
在本地库中查找已完成的作品。

继续聊天

使用 muse_chat，或创建一个 kind: "chat" 的 REST 任务。保留返回的会话 ID，这样智能体就能继续同一会话，而不是创建新的对话。

延长已完成的视频片段

视频完成后，使用素材或会话延长端点，或要求 MCP 智能体调用 muse_extend_video。延长内容会保留在原始片段创建时所在的会话中。一条链最多可包含六个延长步骤，时长约可达到 60 秒。

编辑现有视频

附加一个 MP4 文件，并用自然语言描述所需的修改。Muse4AI 会通过你的 Muse 会话处理请求，无需设置时间线或渲染参数。

高级提示

使用正确的授权方式

当 MCP 客户端支持交互式授权且你不想复制密钥时，选择 OAuth。对于命令行工具、本地自动化以及发送 bearer token 的系统，选择 API 密钥。API 密钥具有作用域和速率限制，并且可以单独撤销。

保护本地凭据

不要将 msk_ 密钥发布到源代码管理系统、截图、共享提示词或 shell 历史记录中。在可行的情况下，为不同客户端创建不同的密钥；如果不再需要访问权限，只撤销受影响的密钥。

保留会话 ID

构建集成时，保存聊天和生成工作流返回的会话 ID。重复使用该 ID 可以让智能体继续会话、在上下文中附加文件，并在原始会话中延长视频。

检查 API 契约

不要猜测请求和响应字段，而应从运行中的应用读取 http://127.0.0.1:47821/v1/openapi.json。在生成类型化客户端或配置自动化平台时，这尤其有用。

提交任务前监控状态

使用 GET /v1/status、GET /v1/health 或 muse_status MCP 工具，在开始较长工作流前检查本地服务。使用列表和获取操作监控任务，并取消不再需要的任务。

开发和测试项目

该仓库将桌面应用、共享内容和智能体指令分开存放：

desktop/ 包含主进程、渲染器、REST、MCP 和 OAuth API、测试以及安装程序代码。
content/ 包含应用和网站共用的指南、智能体及用例文本。
agent-kit/ 包含 Muse4AI Skill，智能体可以阅读它来了解如何使用该工具。

在 desktop 目录中运行项目检查和 Windows 打包命令：

cd desktop
npm test
npm run typecheck
npm run package:win

测试命令会运行仓库的测试套件，npm run typecheck 会检查严格模式的 TypeScript，而 npm run package:win 会准备 Windows ZIP 文件和安装程序输入文件。

结语

Muse4AI 为理解 REST、MCP 或 OAuth 的 AI 智能体提供了连接 Muse 的本地桥梁。Windows 应用运行且 Muse 账户连接后，你可以生成媒体、维护会话、延长视频、通过自然语言请求编辑 MP4 文件，并管理结果，无需经过 Muse4AI 云端中介。

如需更多截图和指导，请访问官方指南。Muse4AI 采用 MIT 许可证。