Tolstoy MCP Integration
Connect OpenClaw to Tolstoy — the video commerce platform for e-commerce brands. This skill configures OpenClaw to use Tolstoy's MCP server, giving the AI access to create and manage video widgets, media, products, and publishing.
Prerequisites
Setup
Option A: Automatic (recommended)
From the skill directory, run:
CODEBLOCK0
This adds the Tolstoy MCP server to ~/.openclaw/openclaw.json (or $OPENCLAW_CONFIG_PATH if set). If the config file doesn't exist, it will be created.
Option B: Manual
Edit ~/.openclaw/openclaw.json (or your OpenClaw config path) and add to mcpServers:
CODEBLOCK1
If your OpenClaw version uses SSE transport instead, use "type": "sse".
Restart OpenClaw
Restart OpenClaw (or reload config if supported) so it picks up the new MCP server.
Authenticate
When you first use a Tolstoy tool, OpenClaw will redirect you to log in to your Tolstoy account. You will:
- 1. Sign in at platform.gotolstoy.com (or be redirected there)
- Select the workspace you want to connect
- Authorize the MCP client
After authorization, the connection persists for future sessions.
Available Tools
Once connected, OpenClaw has access to Tolstoy's full tool set:
| Category | Tools |
|---|
| Widgets | Create, update, publish, delete player and shopper widgets |
| Media |
List, search, get media from your library |
|
Products | Search products, list catalog, get product details |
|
Studio | Generate AI images, animate images, text-to-video, edit videos |
|
Templates | List templates, run AI templates, get template details |
|
Publishing | Publish assets to Instagram, TikTok Shop, Shopify, Meta Ads |
|
Analytics | Query store and performance data |
|
Brands | Search brands and stores |
Example Prompts
- - "Create a shopper widget for my product catalog"
- "Generate an AI video from this product image"
- "List my Tolstoy widgets and their publish status"
- "Search my media library for videos tagged with 'summer'"
- "Publish this asset to my Shopify store"
Troubleshooting
Connection fails: Ensure the URL is exactly https://apilb.gotolstoy.com/mcp/v1/mcp and that your OpenClaw supports OAuth for remote MCP servers.
Auth redirect fails: Some MCP clients require configuring allowed redirect URIs. Check Tolstoy MCP docs for the latest setup.
No tools available: You must complete the OAuth flow first. Try a simple prompt like "list my Tolstoy widgets" to trigger the login redirect.
Links
Tolstoy MCP 集成
将 OpenClaw 连接到 Tolstoy——面向电商品牌的视频商务平台。此技能配置 OpenClaw 使用 Tolstoy 的 MCP 服务器，使 AI 能够创建和管理视频组件、媒体、产品和发布。
前提条件
设置
选项 A：自动（推荐）
在技能目录中运行：
bash
node setup.js
这会将 Tolstoy MCP 服务器添加到 ~/.openclaw/openclaw.json（或 $OPENCLAWCONFIGPATH 如果已设置）。如果配置文件不存在，则会创建。
选项 B：手动
编辑 ~/.openclaw/openclaw.json（或你的 OpenClaw 配置路径）并添加到 mcpServers：
json
tolstoy: {
type: http,
url: https://apilb.gotolstoy.com/mcp/v1/mcp,
auth: oauth
}
如果你的 OpenClaw 版本使用 SSE 传输，请改用 type: sse。
重启 OpenClaw
重启 OpenClaw（或如果支持则重新加载配置），以便它加载新的 MCP 服务器。
身份验证
当你首次使用 Tolstoy 工具时，OpenClaw 会将你重定向到登录你的 Tolstoy 账户。你将：
- 1. 在 platform.gotolstoy.com 登录（或被重定向到那里）
- 选择要连接的工作区
- 授权 MCP 客户端
授权后，连接将持续到未来的会话。
可用工具
连接后，OpenClaw 可以访问 Tolstoy 的完整工具集：
| 类别 | 工具 |
|---|
| 组件 | 创建、更新、发布、删除播放器和购物者组件 |
| 媒体 |
从你的媒体库中列出、搜索、获取媒体 |
|
产品 | 搜索产品、列出目录、获取产品详情 |
|
工作室 | 生成 AI 图像、动画图像、文本转视频、编辑视频 |
|
模板 | 列出模板、运行 AI 模板、获取模板详情 |
|
发布 | 发布资产到 Instagram、TikTok Shop、Shopify、Meta Ads |
|
分析 | 查询商店和性能数据 |
|
品牌 | 搜索品牌和商店 |
示例提示
- - 为我的产品目录创建一个购物者组件
- 从这张产品图片生成一个 AI 视频
- 列出我的 Tolstoy 组件及其发布状态
- 搜索我的媒体库中标记为summer的视频
- 将此资产发布到我的 Shopify 商店
故障排除
连接失败： 确保 URL 完全是 https://apilb.gotolstoy.com/mcp/v1/mcp，并且你的 OpenClaw 支持远程 MCP 服务器的 OAuth。
身份验证重定向失败： 某些 MCP 客户端需要配置允许的重定向 URI。查看 Tolstoy MCP 文档 获取最新设置。
没有可用工具： 你必须先完成 OAuth 流程。尝试一个简单的提示，如列出我的 Tolstoy 组件以触发登录重定向。
链接
