Subscribr MCP

将你的付费 Subscribr 账户连接到 Claude、ChatGPT、OpenClaw、Cursor、VS Code 及其他 AI 助手，使用 MCP 即可。直接在对话中访问你的 Projects 看板、Tasks、通知、频道、脚本、创意、模板、Voice Profiles 和 Intel 研究。

功能简介

Subscribr 支持 Model Context Protocol (MCP)，它允许 AI 客户端安全地连接到外部工具和数据。

连接后，你的 AI 客户端可以：

• 读取 Subscribr 工作区中的数据
• 通过 Intel 查找 YouTube 频道和视频
• 打开丰富的 MCP Apps，查看 Intel 结果、脚本预览和交互式 Projects 看板
• 在你的角色权限允许时，创建、更新、移动、提升、评论、归档和恢复 Projects
• 管理自定义模板，并在明确提交之前验证严格的 Voice Profile

示例提示词：

• "Show me my latest scripts"
• "Search Intel for outlier videos about home workouts"
• "Look up @mkbhd and summarize the channel"
• "Show my Projects board and what needs my attention"

MCP 访问权限适用于所有付费 Subscribr 团队。

从哪里开始

从主应用导航中打开 AI Integrations。该页面提供：

• 你的 MCP 服务器 URL
• 针对特定客户端的设置指南
• OAuth 优先的连接说明
• 针对手动基于令牌的客户端的高级说明

兼容客户端

客户端类型	设置方式
Claude Desktop	引导式 OAuth 设置
Claude.ai	引导式 OAuth 设置
ChatGPT	开发者模式连接器，带引导式 OAuth
Cursor / VS Code	高级远程 HTTP MCP 设置
OpenClaw	高级 MCP 桥接或远程服务器设置
其他 MCP 客户端	使用相同的服务器 URL；具体步骤因客户端而异

标准设置

第 1 步：在 Subscribr 中打开 AI Integrations

1. 登录 Subscribr
2. 打开你的账户菜单，选择 AI Integrations
3. 复制你的 MCP 服务器 URL

生产环境服务器 URL 为：

https://subscribr.ai/mcp/subscribr

第 2 步：将 Subscribr 添加到你的 AI 客户端

在你的 AI 客户端中，添加一个新的 MCP 服务器或集成，并使用：

• 服务器 URL： https://subscribr.ai/mcp/subscribr
• 传输方式： HTTP 或 Streamable HTTP（如果客户端要求）
• 认证： OAuth（如果客户端支持）

第 3 步：完成 OAuth

大多数终端用户客户端会自动将你重定向到 Subscribr。

1. 在浏览器窗口中登录 Subscribr
2. 批准 MCP 连接
3. 返回你的 AI 客户端
4. 开始新的对话并使用 Subscribr 工具

客户端说明

Claude Desktop

• 添加新的集成/服务器
• 粘贴 Subscribr MCP URL
• 完成浏览器授权流程

Claude.ai

• 打开 Integrations
• 添加 Subscribr MCP URL
• 在浏览器中完成 OAuth

ChatGPT

• 打开 Settings → Apps & Connectors → Advanced settings
• 启用 Developer mode，创建一个连接器，并使用相同的 MCP URL
• 在浏览器中完成 OAuth

我们正在为 ChatGPT 应用目录和 Claude Connectors Directory 准备 Subscribr。在这些列表获批之前，请使用上面的服务器 URL 直接连接。

Cursor / VS Code

这些是更面向开发者的 MCP 客户端。

• 添加新的远程 HTTP MCP 服务器
• 使用上面的 Subscribr MCP URL
• 如果被询问，选择 HTTP 或 Streamable HTTP
• 如果客户端支持 OAuth，请使用它
• 如果客户端仅支持手动 bearer 头，请改用个人访问令牌

OpenClaw

OpenClaw 的设置方式比 Claude 或 ChatGPT 更多样。

• 通过你的 OpenClaw MCP 桥接、插件或远程服务器设置添加 Subscribr
• 使用相同的 MCP URL
• 如果你的 OpenClaw 设置支持 OAuth，优先使用它
• 如果它仅支持手动 bearer 认证，请改用个人访问令牌

个人访问令牌（高级）

大多数客户不需要为 Claude、Claude.ai 或 ChatGPT 使用令牌。

令牌仅适用于不支持 OAuth 的高级客户端或本地工作流。

重要限制：

• 令牌在 Developer 页面上管理
• 只有团队管理员可以管理令牌
• Developer 页面需要 API 启用计划

如果你的客户端需要手动 bearer 认证，请使用：

Authorization: Bearer YOUR_TOKEN_HERE

可用工具

Subscribr 在 /mcp/subscribr 上公开了一个聚焦的 23 工具语义目录。生成 App 的读取工具按结果形状分离，以便 Claude 和 ChatGPT 在工具发现期间选择正确的交互式 UI。

Projects 与工作

工具	功能
list_projects	列出/筛选 Projects 并启动交互式看板
get_project	获取一个规范的创意或脚本支持的 Project
get_script_project	获取脚本支持的 Project 并启动其交互式预览
create_project	创建创意或脚本 Project，支持幂等性
update_project	编辑、移动、预览/归档或恢复 Project
promote_idea	预览或将创意提升为关联脚本，无需生成
add_project_comment	添加 Project 评论和受限提及
list_my_work	列出分配的工作和 Project 通知
mark_project_notifications_read	将一条、多条或全部 Project 通知标记为已读

研究、操作与工作区

工具	功能
search_youtube_channels	通过 Intel 搜索 YouTube 频道
search_youtube_videos	通过 Intel 搜索 YouTube 视频
get_youtube_channel	查找一个 YouTube 频道并显示其详情应用
get_youtube_video	查找一个 YouTube 视频并显示其详情应用
generate_ideas	预览并派发异步创意生成
get_operation	轮询 Subscribr 返回的持久操作
get_channel_workspace	读取受限的 Channel、竞争对手、模板和语音上下文
list_research_videos	在交互式视频应用中浏览已跟踪频道的视频
get_research_video	获取一个已跟踪视频并显示其详情应用
list_research_bookmarks	浏览已保存的 Channel 和视频书签
save_bookmark	保存 Intel 频道或视频书签，支持幂等性
save_template	创建、更新、预览/归档或恢复自定义模板
validate_voice_profile	验证/规范化完整的 Voice Profile 并签发回执
commit_voice_profile	明确提交与回执绑定的精确 Voice Profile

破坏性或高成本操作使用预览-然后-确认回执。重试写入使用幂等键，带修订的写入使用最新的预期修订。

示例工作流

研究与创意

1. 询问："Search Intel for outlier videos about meal prep"
2. 询问："Look up the top channel from those results"
3. 询问："Generate 5 ideas for my channel inspired by that pattern"
4. 询问："Bookmark that channel for later"

脚本审阅

1. 询问："Show me my recent scripts"
2. 询问："Open the first script"
3. 与你的 AI 助手一起审阅脚本，并请求反馈或重写

竞争研究

1. 询问："Look up the YouTube channel @competitorhandle"
2. 询问："Search Intel for videos similar to this niche"
3. 询问："Summarize what makes the top outliers stand out"

故障排除

"我看不到 Projects 工具"

确认连接使用的是 https://subscribr.ai/mcp/subscribr。

如果 Subscribr 在最新工具发布之前已经连接，请刷新其工具列表或重新连接，然后开始新的对话。

"我无法添加书签或生成创意"

写入操作需要你的团队具有编辑者或更高级别的访问权限。

"客户端提示需要认证"

这对于支持 OAuth 的客户端来说是正常的。完成浏览器登录和授权流程即可。

"我的客户端仅支持手动 bearer 头"

使用个人访问令牌，但前提是：

• 你的团队拥有 API 启用计划
• 团队管理员可以为你创建令牌

"连接失败"

检查：

1. 服务器 URL 是否完全为 https://subscribr.ai/mcp/subscribr
2. 你的团队是否在付费计划上
3. 你的客户端是否使用远程 HTTP MCP，而不是本地 stdio 模式

安全与隐私

• 所有 MCP 数据都限定在你的已认证 Subscribr 账户范围内
• 你只能访问自己团队的数据
• MCP 请求不允许使用会话 Cookie 认证
• 优先使用 OAuth，因为你的 AI 客户端永远不会收到你的密码
• 令牌可以随时在 Developer 页面上撤销

AI Agent Skill 与 CLI（Claude Code / Codex / Cursor / OpenClaw）

如果你使用 Claude Code、Codex、Cursor 或 OpenClaw 等 AI 编码代理，你可以安装一个技能文件，教代理如何使用 Subscribr REST API。该技能涵盖认证、端点、常见工作流，并链接到完整的 API 参考。

从项目根目录使用一条命令安装：

npx @giltotherescue/subscribr-cli

这会将技能安装到 .agents/skills/（Codex、Cursor、OpenClaw）和 .claude/skills/（Claude Code）中。npm 包还捆绑了一个可移植的 Agent Plugins 清单，适用于支持插件的客户端。要同时安装零依赖的 Python CLI：

npx @giltotherescue/subscribr-cli --with-cli

该 CLI 封装了 Subscribr 的每个 API 端点，适用于自动化、脚本编写和 AI 代理工具使用。对于确定性的 API 工作，使用 CLI；对于对话式的 Projects、工作区和 Intel 工作流，使用 MCP。在 GitHub 上查看该仓库。

该技能专注于 REST API（Automation 计划及以上），涵盖完整平台，包括内容创建、脚本生成、导出和 Webhooks。它还记录了用于研究和创意的 MCP 工具。

你可以在应用的 Developer 页面的 Overview 选项卡下找到它。

AI Agent Skill 适用于代表你调用 API 的编码代理。对于 Claude Desktop 或 ChatGPT 等对话式 AI 客户端，请改用上面描述的 MCP 设置。

MCP 与 REST API 对比

MCP 服务器专为 AI 聊天客户端中的研究、创意和 Project/工作流管理而设计。规范端点提供受支持的 Project、Task/通知、自定义模板和严格 Voice Profile 工作流，带有纯文本回退和嵌入式 Projects 看板。

对于内容创建——创建脚本、生成大纲、导出内容、管理竞争对手或设置 Webhooks——请使用 REST API。REST API 需要 Automation 计划或更高版本，并在 Developer 页面上管理。

后续步骤

• 在 Subscribr 中打开 /ai-integrations 以连接你的 AI 客户端
• 为 Claude Code 或 Codex 安装 AI Agent Skill
• 了解 Intel 研究
• 探索 Video Ideas
• 查看 API 文档以获取完整的编程访问权限