跳转到主要内容
当前请通过手动配置 MCP 服务器 URL 与 API Key 接入。应用市场、一键安装类 Connector 暂不支持。

​
手动接入（推荐）

1

获取 API Key

在 API 配置 创建密钥（未登录请先 登录）。需付费套餐与积分，见 定价。
2

添加 MCP 服务器

在 MCP 客户端中添加自定义 / 远程 MCP 服务器（非应用市场条目）：
  • URL： {mcpUrl}
  • 鉴权： Authorization: Bearer YOUR_API_KEY（使用 API 配置 中的密钥）
3

重载客户端

重启或重载编辑器，使新 MCP 配置生效。
4

验证

让 Agent 列出素材（例如：「列出我的 VMEG 素材」），应调用 vmeg_list_materials。

​
Cursor 示例

在项目或用户级 MCP 配置（.cursor/mcp.json）中添加：
重载 Cursor（Cmd+Shift+P → Developer: Reload Window）。在对话中确认 VMEG MCP 已连接后再调用工具。
勿将 API Key 提交到 git。请使用仅本机生效的配置，或按环境区分 mcp.json。

​
其他 MCP 客户端

凡支持 Streamable HTTP 远程 MCP 的客户端，使用相同参数即可： API Key 绑定一个 VMEG 项目，范围与 Open API 一致。工具参数中不要传 projId。

​
素材上传（HTTP）

建任务工具接受 materialId、sourceUrl 或 youtubeUrl。创建任务前可先上传文件：
响应中 data.id 即 materialId，用于 vmeg_create_video_translation_task 或 vmeg_create_subtitle_translation_task。

​
OAuth（Connector，进阶）

服务端亦提供 OAuth 2.1（PKCE），供无法内嵌 API Key 的客户端（例如未来的 ChatGPT Apps / Connector）使用。手动接入无需 OAuth。 Token 的 issuer：{mcpOAuthUrl}。

​
应用市场与商店 Connector

暂不支持。 在 VMEG 正式上架 Cursor 应用市场或 ChatGPT Connector 之前，请勿依赖一键安装；请改用上文 手动接入 与 API Key。 上架后会在此补充分产品步骤；当前仅文档化自定义 / 远程 MCP 配置。

​
故障排查

工具层错误可参考 错误码。