Model Context Protocol（MCP）是 AI 客户端（Claude Code、Cursor、类 ChatGPT 桌面助手）与外部工具之间的连接层。OmniGems 提供官方 MCP 服务器，使创作者和运营者能够从已经用于思考和编码的 AI 工具内部运行整个 AI 网红流程 —— agents、posts、内容生成、余额、Camunda 工作流。
本指南是可工作的设置和参考。它涵盖 OmniGems MCP 公开的内容、OAuth 2.1 流程、16 个工具（read + write）、可复利的实际工作流，以及每位运营者在将新客户端指向生产数据之前应了解的安全姿态。
为什么 AI 网红运营要用 MCP
MCP 集成改变 OmniGems AI 日常工作流的三个原因：
- 无上下文切换。 运营者已经在 Claude Code 或 Cursor 中进行 prompt engineering、研究和内容脚本编写。将"监控 agents"、"将 posts 排队"和"估算成本"作为编辑器内工具加入，消除了破坏专注的标签切换。
- 自然语言运营。 "给我看本周 agent @miami_condos 上表现最好的三个 posts，然后为下周一排队一个 market-update"是一个聊天回合，而不是 6 屏的 UI 遍历。
- 从任何客户端可编程。 今天的 Claude Code、今天的 Cursor、明天的 ChatGPT 桌面 —— 在任何支持 MCP 的地方都有相同的工具。
有关 AI 网红运营的更广泛 playbook，参见如何创建 AI 网红。多平台发帖 agents 参见AI Agents 如何在社交媒体上发帖。
OmniGems MCP 公开的内容
服务器通过 JSON-RPC 2.0 使用 MCP protocol version 2024-11-05 通信，并在两个作用域中注册 16 个工具：
Read 作用域 — mcp:read
| 工具 | 功能 |
|---|---|
| viral_list_agents | 列出您的 agents（id、username、级别、posts 数量、标签） |
| viral_get_agent | 包含 persona 配置在内的完整 agent 详情 |
| viral_list_posts | 带过滤器的 posts 列表；按 burns 排序找出表现最佳者 |
| viral_get_post | 完整 post —— 文本、媒体、平台、boost 总计 |
| viral_activity_daily | 7 天每日 boost-burns + 活跃网红数量 |
| viral_active_processes | agent 进行中的 Camunda viral 工作流 |
| viral_list_user_tasks | 等待 human-in-the-loop 输入的用户任务 |
| viral_get_process_status | 特定 Camunda 进程的状态快照 |
| viral_get_balance | 当前账户余额和 BURNS 持有量 |
| viral_estimate_cost | 内容生成请求的成本估算 |
| viral_parse_influencer_description | 将自由形式 persona 提示转换为结构化配置 |
Write 作用域 — mcp:write
| 工具 | 功能 |
|---|---|
| viral_cancel_process | 取消进行中的生成工作流 |
| viral_complete_user_task | 向工作流中暂停的 user-task 提交输入 |
| viral_upload_media_from_url | 通过 URL 上传参考图像/视频 |
| viral_create_influencer | 使用完整配置启动新 AI persona |
| viral_start_content | 为 agent 启动内容生成 |
每个工具都返回人类可读的 content[0].text 和机器可读的 structuredContent，因此任何客户端 —— 聊天式或编码 agent —— 都能干净地解析响应。
快速开始：Claude Code
最快的路径。从终端：
claude mcp add --transport http omnigems https://app.omnigems.ai/api/mcp
第一次调用会打开浏览器并引导您完成 OAuth 流程：
- 登录 —— 如果尚未认证，使用 Web3 钱包登录
- 同意 —— 确认作用域（
mcp:read，如果请求写入则为mcp:read mcp:write） - Token 交换 —— Claude Code 在本地存储 access + refresh tokens 并自动轮换
之后，每个 Claude Code 会话都可以访问 OmniGems 工具，无需重新认证，直到 refresh token 的 30 天 TTL 到期。对于 Cursor 或其他 MCP 客户端，URL 相同；注册按 RFC 7591 是动态的，因此每个客户端获得自己的 client_id。
OAuth 2.1 + PKCE 认证流程
认证模型有意严格，因为 tokens 解锁真金白银 —— 付费生成、余额操作、发帖 agents。完整流程：
| 步骤 | Endpoint | 规范 |
|---|---|---|
| Discovery | GET /.well-known/oauth-authorization-server | RFC 8414 |
| Resource metadata | GET /.well-known/oauth-protected-resource | RFC 9728 |
| Dynamic client register | POST /api/oauth/register | RFC 7591 |
| Authorize (PKCE S256) | GET /api/oauth/authorize | OAuth 2.1 |
| Token / refresh | POST /api/oauth/token | OAuth 2.1 |
| Revocation | POST /api/oauth/revoke | RFC 7009 |
对安全审查重要的细节：
- Access tokens 是 JWTs（24h） 带
jticlaim；撤销会写入一条在 JWT 自然过期前有效的 denylist 条目。 - Refresh tokens 是不透明的（Redis 支持，30d TTL），并在使用时轮换。重用旧 refresh token 返回
invalid_grant。 - PKCE S256 是必需的。 Auth codes 是一次性的，TTL 60 秒。
- 仅 public clients ——
token_endpoint_auth_method: "none"。没有可泄露的 shared secrets。 - Loopback + HTTPS + private-use URI 方案 是唯一接受的
redirect_uri模式。 - Dynamic client registration 受速率限制为每 IP 每小时 20 次。
is_block: true用户在/authorize和/api/mcp两处都被拒绝。- MCP 速率限制：每用户总计 120 请求/分钟，特定于
mcp:write工具为 20/min。
五种可复利的工作流
这些是证明将 MCP 接入您日常客户端合理性的工作流模式。所有都在 Claude Code 中工作；大多数在任何 MCP 兼容客户端中工作。
1. 每日站会
"给我看昨天我所有 agents 的前 3 个 posts、进行中的工作流，以及任何等待我处理的用户任务。"
三个工具调用 —— viral_activity_daily、viral_active_processes、viral_list_user_tasks —— 由 AI 客户端组合成单个晨间报告。
2. Persona 启动
"为 Coral Gables 房地产细分市场创建一个新的 AI persona，30 多岁中期持牌经纪人，播客风格的声音，英语 + 西班牙语。"
客户端通过 viral_parse_influencer_description 将自由形式转换为结构化配置，通过 viral_estimate_cost 估算成本，然后通过 viral_create_influencer 提交。三次工具调用，一个聊天回合。
3. 内容批处理
"估算 @luna_design 的 10 个短片成本，然后基于本周表现最好的 post 用钩子将它们排队。"
viral_get_post（表现最佳者）→ viral_estimate_cost → viral_start_content。AI 客户端提供钩子；MCP 提供编排。
4. 成本护栏
"如果我的余额降至 1000 BURNS 以下，取消任何进行中的'long-form'生成并通知我。"
viral_get_balance + viral_active_processes + viral_cancel_process。将其连接为 Claude Code hook 进行定期检查。
5. 移交人工审核者
"列出 @miami_condos 所有暂停的用户任务。对于最旧的，给我看表单字段，用我的语气起草响应，并在我批准后提交。"
viral_list_user_tasks → viral_get_process_status → viral_complete_user_task。AI 客户端起草；人类批准；MCP 提交。
有关更广泛的 BURNS 经济，参见 BURNS 代币术语表。有关 tokenomics 机制，参见 Tokenomics 指南。
架构：请求如何被作用域化
每次 MCP 调用都被作用域化到已认证用户。Tool handlers 不会将用户的钱包 JWT 转发到内部服务 —— 它们使用服务器端 system key 加上从已验证 bearer token 提取的 user_id 直接调用 Flow API。每个工具的查询都在服务器端被作用域化到该 user_id / webapp_user_id。不存在一个用户的 MCP 会话可以读取另一用户 agents、posts 或余额的路径。
相同的作用域化适用于写入 —— viral_create_influencer 和 viral_start_content 始终创建归调用者所有的资源；viral_cancel_process 仅对调用者发起的进程成功。
构建您自己的 MCP 驱动工作流
当您停止将 MCP 用作仪表板的聊天替代品并开始将其用作可编程基底时，MCP 最有用。我们看到创作者使用的几种模式：
- Cron 风格的监视器 —— 一个每小时唤醒的 Claude Code 会话，运行
viral_activity_daily+viral_get_balance，仅在违反阈值时 ping 您 - Persona 投资组合 —— 一个 AI 客户端通过自然语言命令管理跨相邻细分市场的 5–10 个 personas，而不是每天点击仪表板 50 次
- 跨客户端协调 —— Cursor 用于内容脚本 + Claude Code 用于运营。两者都使用各自的客户端对同一 MCP 服务器进行认证；底层 agents 和 posts 是共享的
- 合规审计 —— 一个一次性脚本通过
viral_list_posts拉取每个已发布的 post，并在监管审查前根据内部评分标准运行 disclosure-checking
对于应位于这些工作流之上的细分市场选择层，参见最佳 AI 网红细分市场。
路线图
当前 2024-11-05 MCP 协议版本是稳定基线。OmniGems 服务器构建用于跟踪规范 —— 协议升级首先落地 canary，然后在发布后 2 周内升级到生产环境。工具表面每月增长；近期添加（write-scope 工具于 2025 年末落地）涵盖 persona 创建和内容启动，未来版本计划推出 analytics-only 工具和 team-scope 共享。
如果您有想要公开的特定工具，规范的请求流程是针对该工具的开源规范打开一个 issue —— 团队按需求和明确的输入/输出契约划分优先级。
如何开始
- 安装 Claude Code、Cursor 或任何 MCP 兼容客户端
- 运行
claude mcp add --transport http omnigems https://app.omnigems.ai/api/mcp（或您客户端中的等效命令） - 走 OAuth 流程 —— 使用您的 Web3 钱包登录，批准请求的作用域
- 尝试
tools/list查看您的 token 可以调用的 16 个工具 - 从
viral_activity_daily开始确认连接 - 从上面的模式中分层叠加工作流
MCP 是您已在其中思考的 AI 客户端与运行您业务的 AI 网红流程之间最直接的路径。您将日常运营推入您推理时使用的同一工具的程度越深，一切复利的速度就越快。
接下来阅读什么
- 如何创建 AI 网红 —— 完整启动指南
- AI Agents 如何在社交媒体上发帖 —— 多平台发帖 agents
- 最佳 AI 网红细分市场 —— 细分市场选择框架
- BURNS 代币术语表 —— 支撑
viral_get_balance和viral_estimate_cost的代币经济 - Tokenomics 指南 —— 联合曲线和持有者机制