Genviral

$ claude mcp add --transport http genviral https://mcp.genviral.io/mcp

将 Genviral 添加到当前项目。之后运行 /mcp 以完成 OAuth 登录。

Genviral 可发布到

TikTokInstagramYouTubePinterestLinkedInFacebookXBlueskyMastodonTelegram

实际使用中

人们实际输入的内容

每一条都会解析为对您账户的真实工具调用——读取已排定的内容、生成缺失的内容，并将结果加入队列。

• 我上周发布了什么，哪个表现最好？
• 生成三个关于晨间习惯的 TikTok 幻灯片，并安排在本周发布。
• 把周五排定的所有内容移到周一早上。
• 我连接的账户中，哪个在过去 10 天没有发布过？
• 用这张图片制作一个 9:16 的视频，并排队为 Instagram Reel。
• 根据这份更新日志起草一篇 LinkedIn 帖子，但不要发布。

两层架构

您的助手做决策。Genviral 负责执行。

助手擅长判断该制作什么、何时发布。Genviral 擅长作为唯一一个真正能制作并发布的连接。

您的助手负责

• 它已经理解您的意图 您描述想要的一周。助手选择格式、撰写标题，并决定内容去向——无需命令语法，无需仪表盘。
• 它在您已有的工作环境中运行 Claude、ChatGPT、Cursor、VS Code 以及所有其他 MCP 客户端读取同一个服务器。每个客户端连接一次，而不是每个功能连接一次。
• 它携带您的上下文 对话中的任何其他内容——发布文档、代码仓库、钩子清单表格——都会成为它起草帖子的素材。
• 它闭环反馈 分析数据通过同一连接返回，因此下一批内容是根据实际表现撰写的，而不是根据您的期望。

Genviral 负责

• 已连接的社交媒体账户 通过一次 OAuth 连接覆盖 10 个平台——无需等待 Meta 或 TikTok 合作伙伴审批，也无需在助手的配置中存放各平台的令牌。
• AI 媒体生成 幻灯片、图片和视频在 Genviral 的 Studio 中渲染。助手请求一个素材，就能拿回一个成品——大多数 MCP 服务器只能排定您已经制作好的内容。
• 防重复发布 通过 MCP 服务器的每次写入都需要幂等键，发布则需要明确的决策。重试中的代理无法重复发布同一内容。
• 工作区和团队 每个连接都绑定到您在授权时选择的个人空间或某个工作区，因此代理机构助手无法触达未被指向的客户。

连接

一个 URL，一分钟内完成

无需安装包，也无需运行服务器。选择您的客户端，粘贴端点，并批准您希望它拥有的权限。

$ claude mcp add --transport http genviral https://mcp.genviral.io/mcp

将 Genviral 添加到当前项目。之后运行 /mcp 以完成 OAuth 登录。

1. 02第 2 步，共 4 步

   将服务器添加到您的客户端

   一个远程 URL，无需安装任何内容，也无需保持运行进程。Claude Code 将其作为命令接受；Cursor 和 VS Code 将其作为四行 JSON 接受；Claude 和 ChatGPT 在其连接器设置中接受。 Claude Code $ claude mcp add --transport http genviral https://mcp.genviral.io/mcp
2. 03第 3 步，共 4 步

   批准您真正想要的权限

   登录会打开 Genviral 的授权屏幕。选择连接绑定的工作区，并仅授予您希望它拥有的范围——读取和起草与发布是分开的，生成又是独立的。之后可以随时撤销任何连接，而不影响其他连接。 创建免费账户
3. 04第 4 步，共 4 步

   请求发布一篇帖子，然后观察它落地

   先从草稿开始，而不是直接发布，在仪表盘中查看标题和媒体，然后让助手排定其余内容。它生成的媒体会在支持渲染 MCP 资源的客户端中以画廊形式返回。 在您的助手中 $ Draft one TikTok slideshow about this week's launch, $ put it in my content library, and stop before publishing.

工具

32 个工具，4 种权限

此列表是根据服务器授权所依据的同一契约生成的，因此不会宣传服务器未注册的工具。这里的一切都会执行真实操作——没有只给您一个链接并让您自己完成工作的占位工具。

读取您的账户

context:read

账户、帖子、分析数据和媒体库内容。此列表中的任何内容都不会更改任何数据。

• show_studio 只读 在 Studio 图片和视频就绪后显示它们。
• show_posts 只读 当您要求查看时，显示您的内容日历或其中的一篇帖子。
• show_video 只读 显示带有可播放预览的视频项目，并可从其中打开完整编辑器。
• show_library 只读 在请求时显示您的文件或幻灯片的视觉预览。
• show_viral_library 只读 当您想浏览灵感时，显示病毒式参考卡片。
• show_analytics 只读 当您要求查看时，显示您的帖子或某个被跟踪账户的分析仪表盘。
• browse_music 只读 浏览音乐库和您自己上传的曲目。
• get_context 只读 已连接的账户、工作区、套餐和积分余额，以及您可用的 Studio 模型。
• list_posts 只读 已排定、草稿和已发布的帖子，以及每个账户的投递状态。
• get_analytics 只读 帖子和账户表现，以及您为分析跟踪的每个账户。
• research_trends 只读 某个细分领域的趋势简报，以及在导入前预览任何公开的 TikTok 幻灯片。
• research_reddit 只读 在 Reddit 上搜索源帖子，然后从您选择的帖子中读取有界的评论样本。
• analyze_content 只读 根据真实的病毒式帖子为钩子打分，建议经过验证的钩子结构，并为某个想法找到病毒式参考。
• search_viral_library 只读 搜索 Genviral 精选的病毒式帖子库，并可完整打开其中任何一篇。
• browse_library 只读 内容库中的文件、文件夹、影响者（一致角色）、图片包、模板和幻灯片。
• search_images 只读
• get_job 只读 正在进行的渲染、生成或分析刷新的状态。

创建和编辑内容

content:write

草稿、上传、文件夹、包、模板和幻灯片。仍然不能发布。

• manage_music 写入可删除数据 添加、重命名、导入和删除您自己的音乐曲目。
• manage_studio 写入可删除数据 将 Studio 创作保存到您的库中、删除它们，或将模板设为收藏。
• upload_media 写入 将图片或视频上传到您的媒体库。
• manage_library 写入可删除数据 创建、移动和删除文件夹，并在文件夹之间移动项目。
• manage_assets 写入可删除数据 创建和编辑图片包以及可复用的幻灯片模板。
• manage_slideshow 写入可删除数据 复制、编辑、渲染或删除幻灯片，或重新生成单个幻灯片。
• manage_analytics_targets 写入可删除数据 添加、编辑、移除和刷新您为分析跟踪的账户。
• create_post 写入 准备一篇帖子：媒体、标题、各平台设置、目标账户和排定时间。
• update_post 写入可删除数据 重新排定、编辑、重试或删除您已创建的帖子。

排定和发布

posts:publish

唯一可以将内容展示给受众的范围。请单独授予。

• schedule_editor_versions 写入 准备并排定视频项目的渲染版本，发布到您的各个账户。
• publish_post 写入可删除数据 提交一篇已准备的帖子——立即发布或交给排定器。

生成媒体

media:generate

图片、视频和幻灯片生成。这是消耗积分的范围。

• edit_video 写入可删除数据 创建和编辑视频项目：剪辑、文本、字幕和音乐，然后渲染最终版本。
• remix_video 写入 查找要混剪的源视频、预览它们，并将剪辑导入项目。
• generate_slideshow 写入可删除数据 根据简报生成多张幻灯片的轮播图，或从 TikTok 导入，然后渲染。
• generate_studio_media 写入可删除数据 在 AI Studio 中根据提示或参考图片生成图片和视频。

安全性

它能做什么由您决定，而不是模型

将您的社交媒体账户交给助手，只有在限制在它无法触及的地方强制执行时才是合理的。以下四项都位于后端。

OAuth，而不是粘贴的 API 密钥

您登录 Genviral 进行连接。不会在配置文件、shell 配置文件或您的助手记录的 URL 中存放长期密钥。撤销连接后，它会立即停止工作。

每个连接您选择的权限

4 个独立范围，在 Genviral 授权屏幕上批准。助手可以被允许起草但永远不允许发布，或者只允许读取分析数据而不允许其他操作。

限定于一个工作区

您在批准时选择个人空间或特定工作区。连接无法看到、发布到或消耗其外部的任何积分。

发布始终是深思熟虑的

发布需要明确的发布或排定决策，并且每次写入都带有幂等键。重试失败调用的代理不会重复发布。

使用场景

六个值得连接的典型工作流

每一个都是您已打开的助手中的单个请求。循环每次都一样：它读取账户、生成缺失的内容，并将结果加入队列。

• TikTok 一句话生成一周的幻灯片 助手拉取趋势简报，据此生成五个轮播图，并每天排队一个——您批准整个批次，而不是逐条编写。
• Instagram 根据已批准的文件夹为 Reels 添加标题 将其指向媒体库文件夹。它为每个剪辑添加标题、添加标签，并将它们排队，而不会让任何内容离开您的批准流程。
• LinkedIn 根据您已完成的工作撰写帖子 因为助手可以在同一对话中看到您的代码仓库、文档或更新日志，帖子是根据真实细节起草的，而不是摘要的摘要。
• YouTube 在审核关卡上发布 Shorts 它上传、填写元数据，并先以非公开方式发布。您观看后再将其转为公开——助手默认永远不会获得这个决策权。
• Pinterest 按节奏生成信息图图钉 Studio 渲染图片，助手撰写图钉文案，整个内容进入正确的图板——一个提示，无需设计步骤。
• Facebook 无需第二个工作流即可跨平台发布 一个连接覆盖所有平台，因此一小时后将今天的 TikTok 镜像到 Facebook 页面只是一句话，而不是一个集成。

指南

接下来读什么

连接背后的开发者界面。每个 MCP 工具调用最终都会到达这些端点之一。

• Genviral Partner API 参考 每个 MCP 工具都是这些端点的轻量封装。当您想了解工具调用背后的确切请求和响应结构时，请阅读此文档。 阅读指南
• Genviral for AI agents 两种连接路径的简短、机器可读概述——面向助手的 MCP，面向代码的 REST——并附有相同的能力列表。 阅读指南
• Genviral CLI 面向编码代理的替代方案：一个二进制文件、一个限定范围的 API 密钥，无需 MCP 客户端。适用于 Codex、CI 作业和 cron。 阅读指南

常见问题

MCP 相关问题

团队在将助手指向其社交媒体账户之前会问的问题。

什么是 MCP？

模型上下文协议（Model Context Protocol）是由 Anthropic 推出的开放标准，用于将 AI 助手连接到外部工具和数据。MCP 服务器发布一组工具；任何 MCP 客户端——Claude、ChatGPT、Cursor、VS Code 等——都可以调用它们。这意味着 Genviral 只需公开一次能力，所有助手都可以使用。

Genviral MCP 服务器 URL 是什么？

https://mcp.genviral.io/mcp. 它是一个远程流式 HTTP 服务器，因此无需安装任何内容，也无需保持本地进程运行。支持发现的客户端还可以读取 https://www.genviral.io/.well-known/mcp/server-card.json 以自动找到端点、完整工具列表和可用范围。

如何认证？ 使用 OAuth。当你的客户端首次连接时，它会将你引导至 Genviral 的同意屏幕，你可以在其中登录、选择连接所绑定的工作区，并批准你希望其拥有的权限。无需生成、复制或粘贴 API 密钥到配置文件中，而且你之后可以随时撤销任意单个连接，而不影响其他连接。

哪些 AI 客户端可以使用它？

任何支持远程服务器与 OAuth 的 MCP 客户端。这包括 Claude（桌面版、网页版、移动版和 Claude Code）、ChatGPT 的自定义连接器、Cursor、带 Copilot 的 VS Code、Windsurf、Cline、Zed、JetBrains IDE，以及任何构建在支持 MCP 的代理框架之上的工具。

助手实际上能做什么？

32 个工具，覆盖完整流程：读取你的账户和分析数据、浏览和管理你的内容库、在 Studio 中生成图片、视频和幻灯片、准备帖子，并将其安排或发布到 10 个平台。生成功能是大多数社交 MCP 服务器所不具备的——它们可以安排内容，但无法创建内容。

它能不经我同意就发布吗？

只有当你授予它发布权限时才可以，而且只能发布到你连接的工作区中的账户。读取、起草和生成是独立的权限范围，因此一个连接可以被允许构建完整的内容队列，同时仍然无法将任何内容上线。发布还要求每次调用都做出明确的发布或安排决定，而不是默认立即发布。

重试的代理会重复发帖吗？

不会。通过 MCP 服务器的每次写入都需要一个幂等键，因此重试的调用会解析到同一篇帖子，而不会创建第二篇。这一保证来自仪表板和 Partner API 所使用的同一后端，而不是依赖助手需要记住的某些操作。

我需要付费套餐吗？

你可以创建一个免费的 Genviral 账户并连接它。生成媒体会消耗积分，而连接账户的限制取决于你的套餐，因此更重的自动化需要付费套餐，这与在仪表板中的情况相同。

我应该使用 MCP 还是 REST API？

当聊天助手在驱动时，请使用 MCP——这是从一句话到一篇已安排帖子之间的最快路径。当你在编写代码、运行定时任务或在 Genviral 之上构建产品时，请使用 Partner REST API 或 Genviral CLI。两者都访问相同的后端服务，因此没有任何功能是某一路径独有的。