如何通过 MCP 将 Vimeo 连接到 Gemini

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Vimeo、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Vimeo + Gemini

让你的 AI 使用你的 Vimeo 账号：列出和搜索你的视频，读取详情、文件夹、展示集、评论、字幕和文字稿，并在你确认后通过链接上传视频，修改标题、描述和隐私设置。使用你自己的 Vimeo 开发者应用中的个人访问令牌。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

VIMEO_ACCESS_TOKEN

步骤 1 — 获取凭证

1. 用 AI 要操作的 Vimeo 账号登录 developer.vimeo.com/apps，点击 Create an app。名称和描述随意；选择只有你自己访问该应用，并接受条款。
2. 在应用页面打开 Generate an access token，选择 Authenticated (you)，勾选 scope Public、Private、Edit、Upload 和 Stats。只有打算启用 vimeo_delete_video 时才勾选 Delete。点击 Generate。
3. 把只显示一次的令牌复制到 VIMEO_ACCESS_TOKEN，然后安装连接器。
4. 用 vimeo_get_me 检查设置：它会显示账号、套餐和上传额度。

令牌不会过期。在应用页面删除令牌或删除应用后，它就会失效。无法给已有令牌添加 scope：请生成一个新令牌来替换旧令牌。

可以读取的内容：你的视频，按最新排序，或按标题、描述、章节和标签搜索，并附带隐私设置、状态、播放次数和标签；单个视频的全部详情；文件夹和展示集及其中的视频；评论；以及字幕，包括自动生成的字幕，AI 可以把它们当作带时间轴的文字稿来读。字幕和文字稿适用于你账号拥有的视频。

每次更改前都会询问：vimeo_upload_video_from_url 会向你的账号添加视频，vimeo_update_video 会修改标题、描述、语言、密码或隐私设置。AI 会告诉你将改变什么，涉及隐私时还会说明之后谁能观看，然后等你同意。隐私变更会立即对所有拥有链接的人生效。

通过链接上传：Vimeo 会自己去获取文件（拉取上传）。链接必须直接指向视频文件，而不是网页，并且要在 24 小时内保持可访问。之后 Vimeo 会转码视频，AI 可以用 vimeo_get_video 跟踪进度。上传会占用你套餐的存储空间和每周额度。

隐私选项：所有人、不公开列出（有链接的人）、仅自己、密码、联系人、Vimeo 用户、你的团队，或在 vimeo.com 上隐藏、只能在嵌入的位置播放。免费套餐不能使用所有选项；此时 Vimeo 会返回 400 或 403。

安装时默认关闭：vimeo_delete_video 会永久删除视频。如需使用，请生成带 Delete scope 的令牌并启用该工具；AI 会针对具体的那个视频请你明确确认。

ID：视频的 ID 就是它的 vimeo.com 链接中的数字。在 API 中，文件夹叫 projects，展示集叫 albums；AI 会替你处理这个差异。

常见错误：401（错误码 8000 或 8003）：令牌错误或已被删除；请生成新令牌。403：令牌缺少 Upload 或 Edit 等 scope，或者你的套餐不允许该操作。404：视频、文件夹或展示集不存在，或属于其他账号。429：请求过多；限额取决于套餐，请稍后再试。

连接器不会下载视频文件，也不处理直播活动、分析报告、Webhook、章节、缩略图、播放器或团队成员。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Gemini 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list），anythingmcp 应显示为已连接。
4. 开始输入提示，Gemini CLI 现在可以调用 Vimeo 的工具。

可用工具

示例提示

• “列出我最近的十个视频，包含标题、时长和隐私设置。”
• “读一下我们 Product Launch 2026 视频的文字稿，用一段话总结，包含三个要点。”
• “客户网络研讨会文件夹里哪些视频还是公开的？把它们改成不公开列出，但先给我看清单。”
• “把 https://example.com/files/onboarding-2.mp4 的视频上传为入职培训第 2 部分，仅自己可见。”
• “总结我最新视频下的评论，告诉我大家问得最多的是哪些问题。”

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT